@naturalcycles/js-lib 15.8.1 → 15.9.1

package/dist/datetime/localTime.js

@@ -146,8 +146,8 @@ export class LocalTime {
         // second
         return this.$date.getSeconds();
     }
-    set(unit, v, mutate = false) {
-        const t = mutate ? this : this.clone();
+    set(unit, v, opt = {}) {
+        const t = opt.mutate ? this : this.clone();
         if (unit === 'year') {
             t.$date.setFullYear(v);
         }
@@ -167,7 +167,7 @@ export class LocalTime {
             t.$date.setSeconds(v);
         }
         else if (unit === 'week') {
-            setWeek(t.$date, v, true);
+            setWeek(t.$date, v, { mutate: true });
         }
         return t;
     }
@@ -241,8 +241,8 @@ export class LocalTime {
             delta += 7;
         return this.plus(delta, 'day');
     }
-    setComponents(c, mutate = false) {
-        const d = mutate ? this.$date : new Date(this.$date);
+    setComponents(c, opt = {}) {
+        const d = opt.mutate ? this.$date : new Date(this.$date);
         // Year, month and day set all-at-once, to avoid 30/31 (and 28/29) mishap
         if (c.day || c.month !== undefined || c.year !== undefined) {
             d.setFullYear(c.year ?? d.getFullYear(), c.month ? c.month - 1 : d.getMonth(), c.day || d.getDate());
@@ -256,7 +256,7 @@ export class LocalTime {
         if (c.second !== undefined) {
             d.setSeconds(c.second);
         }
-        return mutate ? this : new LocalTime(d);
+        return opt.mutate ? this : new LocalTime(d);
     }
     plusSeconds(num) {
         return this.plus(num, 'second');
@@ -300,19 +300,19 @@ export class LocalTime {
     minusYears(num) {
         return this.plus(-num, 'year');
     }
-    plus(num, unit, mutate = false) {
+    plus(num, unit, opt = {}) {
         if (unit === 'week') {
             num *= 7;
             unit = 'day';
         }
         if (unit === 'year' || unit === 'month') {
-            const d = addMonths(this.$date, unit === 'month' ? num : num * 12, mutate);
-            return mutate ? this : localTime.fromInput(d);
+            const d = addMonths(this.$date, unit === 'month' ? num : num * 12, opt);
+            return opt.mutate ? this : localTime.fromInput(d);
         }
-        return this.set(unit, this.get(unit) + num, mutate);
+        return this.set(unit, this.get(unit) + num, opt);
     }
-    minus(num, unit, mutate = false) {
-        return this.plus(num * -1, unit, mutate);
+    minus(num, unit, opt = {}) {
+        return this.plus(num * -1, unit, opt);
     }
     absDiff(other, unit) {
         return Math.abs(this.diff(other, unit));
@@ -348,10 +348,10 @@ export class LocalTime {
         // `|| 0` is to avoid returning -0
         return Math.trunc(r) || 0;
     }
-    startOf(unit, mutate = false) {
+    startOf(unit, opt = {}) {
         if (unit === 'second')
             return this;
-        const d = mutate ? this.$date : new Date(this.$date);
+        const d = opt.mutate ? this.$date : new Date(this.$date);
         d.setSeconds(0, 0);
         if (unit !== 'minute') {
             d.setMinutes(0);
@@ -368,17 +368,17 @@ export class LocalTime {
                     }
                     else {
                         // week
-                        startOfWeek(d, true);
+                        startOfWeek(d, { mutate: true });
                     }
                 }
             }
         }
-        return mutate ? this : new LocalTime(d);
+        return opt.mutate ? this : new LocalTime(d);
     }
-    endOf(unit, mutate = false) {
+    endOf(unit, opt = {}) {
         if (unit === 'second')
             return this;
-        const d = mutate ? this.$date : new Date(this.$date);
+        const d = opt.mutate ? this.$date : new Date(this.$date);
         d.setSeconds(59, 0);
         if (unit !== 'minute') {
             d.setMinutes(59);
@@ -390,7 +390,7 @@ export class LocalTime {
                         d.setMonth(11);
                     }
                     if (unit === 'week') {
-                        endOfWeek(d, true);
+                        endOfWeek(d, { mutate: true });
                     }
                     else {
                         // year or month
@@ -400,7 +400,7 @@ export class LocalTime {
                 }
             }
         }
-        return mutate ? this : new LocalTime(d);
+        return opt.mutate ? this : new LocalTime(d);
     }
     /**
      * Returns how many days are in the current month.
@@ -426,10 +426,9 @@ export class LocalTime {
     isSameOrAfter(d) {
         return this.compare(d) >= 0;
     }
-    isBetween(min, max, incl = '[)') {
+    isBetween(min, max, incl) {
         let r = this.compare(min);
-        // eslint-disable-next-line @typescript-eslint/prefer-string-starts-ends-with
-        if (r < 0 || (r === 0 && incl[0] === '('))
+        if (r < 0)
             return false;
         r = this.compare(max);
         if (r > 0 || (r === 0 && incl[1] === ')'))
@@ -857,9 +856,9 @@ class LocalTimeFactory {
             return true; // we deliberately consider UTC a valid timezone, while it's mostly used in testing
         return Intl.supportedValuesOf('timeZone').includes(tz);
     }
-    sort(items, dir = 'asc', mutate = false) {
+    sort(items, dir = 'asc', opt = {}) {
         const mod = dir === 'desc' ? -1 : 1;
-        return (mutate ? items : [...items]).sort((a, b) => {
+        return (opt.mutate ? items : [...items]).sort((a, b) => {
             const v1 = a.$date.valueOf();
             const v2 = b.$date.valueOf();
             if (v1 === v2)
@@ -907,8 +906,8 @@ function getWeek(date) {
     const diff = startOfWeek(date).getTime() - startOfWeekYear(date).getTime();
     return Math.round(diff / MILLISECONDS_IN_WEEK) + 1;
 }
-function setWeek(date, week, mutate = false) {
-    const d = mutate ? date : new Date(date);
+function setWeek(date, week, opt = {}) {
+    const d = opt.mutate ? date : new Date(date);
     const diff = getWeek(d) - week;
     d.setDate(d.getDate() - diff * 7);
     return d;
@@ -919,7 +918,7 @@ function startOfWeekYear(date) {
     const fourthOfJanuary = new Date(0);
     fourthOfJanuary.setFullYear(year, 0, 4);
     fourthOfJanuary.setHours(0, 0, 0, 0);
-    return startOfWeek(fourthOfJanuary, true);
+    return startOfWeek(fourthOfJanuary, { mutate: true });
 }
 // based on: https://github.com/date-fns/date-fns/blob/fd6bb1a0bab143f2da068c05a9c562b9bee1357d/src/getISOWeekYear/index.ts
 function getWeekYear(date) {
@@ -927,11 +926,11 @@ function getWeekYear(date) {
     const fourthOfJanuaryOfNextYear = new Date(0);
     fourthOfJanuaryOfNextYear.setFullYear(year + 1, 0, 4);
     fourthOfJanuaryOfNextYear.setHours(0, 0, 0, 0);
-    const startOfNextYear = startOfWeek(fourthOfJanuaryOfNextYear, true);
+    const startOfNextYear = startOfWeek(fourthOfJanuaryOfNextYear, { mutate: true });
     const fourthOfJanuaryOfThisYear = new Date(0);
     fourthOfJanuaryOfThisYear.setFullYear(year, 0, 4);
     fourthOfJanuaryOfThisYear.setHours(0, 0, 0, 0);
-    const startOfThisYear = startOfWeek(fourthOfJanuaryOfThisYear, true);
+    const startOfThisYear = startOfWeek(fourthOfJanuaryOfThisYear, { mutate: true });
     if (date.getTime() >= startOfNextYear.getTime()) {
         return year + 1;
     }
@@ -941,8 +940,8 @@ function getWeekYear(date) {
     return year - 1;
 }
 // based on: https://github.com/date-fns/date-fns/blob/fd6bb1a0bab143f2da068c05a9c562b9bee1357d/src/startOfWeek/index.ts
-function startOfWeek(date, mutate = false) {
-    const d = mutate ? date : new Date(date);
+function startOfWeek(date, opt = {}) {
+    const d = opt.mutate ? date : new Date(date);
     const day = d.getDay();
     const diff = (day < weekStartsOn ? 7 : 0) + day - weekStartsOn;
     d.setDate(d.getDate() - diff);
@@ -950,15 +949,15 @@ function startOfWeek(date, mutate = false) {
     return d;
 }
 // based on: https://github.com/date-fns/date-fns/blob/master/src/endOfWeek/index.ts
-function endOfWeek(date, mutate = false) {
-    const d = mutate ? date : new Date(date);
+function endOfWeek(date, opt = {}) {
+    const d = opt.mutate ? date : new Date(date);
     const day = d.getDay();
     const diff = (day < weekStartsOn ? -7 : 0) + 6 - (day - weekStartsOn);
     d.setDate(d.getDate() + diff);
     return d;
 }
-function addMonths(d, num, mutate = false) {
-    if (!mutate)
+function addMonths(d, num, opt = {}) {
+    if (!opt.mutate)
         d = new Date(d);
     let day = d.getDate();
     let month = d.getMonth() + 1 + num;

package/dist/datetime/timeInterval.d.ts

@@ -1,4 +1,4 @@
-import type { Inclusiveness, UnixTimestamp } from '../types.js';
+import type { UnixTimestamp } from '../types.js';
 import type { LocalTime, LocalTimeInput } from './localTime.js';
 export type TimeIntervalConfig = TimeInterval | TimeIntervalString;
 export type TimeIntervalString = string;
@@ -26,7 +26,7 @@ export declare class TimeInterval {
     isSameOrBefore(d: TimeIntervalConfig): boolean;
     isAfter(d: TimeIntervalConfig, inclusive?: boolean): boolean;
     isSameOrAfter(d: TimeIntervalConfig): boolean;
-    includes(d: LocalTimeInput, incl?: Inclusiveness): boolean;
+    includes(d: LocalTimeInput): boolean;
     /**
      * TimeIntervals compare by start date.
      * If it's the same - then by end date.

package/dist/datetime/timeInterval.js

@@ -56,12 +56,11 @@ export class TimeInterval {
     isSameOrAfter(d) {
         return this.cmp(d) >= 0;
     }
-    includes(d, incl = '[)') {
+    includes(d) {
         d = localTime.fromInput(d).unix;
-        // eslint-disable-next-line @typescript-eslint/prefer-string-starts-ends-with
-        if (d < this.$start || (d === this.$start && incl[0] === '('))
+        if (d < this.$start)
             return false;
-        if (d > this.$end || (d === this.$end && incl[1] === ')'))
+        if (d > this.$end)
             return false;
         return true;
     }

package/dist/http/fetcher.js

@@ -668,7 +668,7 @@ export class Fetcher {
             }),
         };
         // Because all header values are stringified, so `a: undefined` becomes `undefined` as a string
-        _filterNullishValues(req.init.headers, true);
+        _filterNullishValues(req.init.headers, { mutate: true });
         // setup url
         const baseUrl = opt.baseUrl || this.cfg.baseUrl;
         if (baseUrl) {

package/dist/json-schema/jsonSchema.util.js

@@ -23,5 +23,5 @@ export function mergeJsonSchemaObjects(s1, s2) {
     s1.required.push(...s2.required);
     s1.required = _uniq(s1.required).sort();
     // `additionalProperties` remains the same
-    return _filterNullishValues(s1, true);
+    return _filterNullishValues(s1, { mutate: true });
 }

package/dist/log/commonLogger.d.ts

@@ -1,3 +1,4 @@
+import type { MutateOptions } from '../array/array.util.js';
 /**
  * These levels follow console.* naming,
  * so you can use console[level] safely.
@@ -38,7 +39,7 @@ export declare const commonLoggerNoop: CommonLogger;
 /**
  * Creates a "child" logger that is "limited" to the specified CommonLogLevel.
  */
-export declare function commonLoggerMinLevel(logger: CommonLogger, minLevel: CommonLogLevel, mutate?: boolean): CommonLogger;
+export declare function commonLoggerMinLevel(logger: CommonLogger, minLevel: CommonLogLevel, opt?: MutateOptions): CommonLogger;
 /**
  * Creates a "proxy" CommonLogger that pipes log messages to all provided sub-loggers.
  */

package/dist/log/commonLogger.js

@@ -1,4 +1,3 @@
-// copy-pasted to avoid weird circular dependency
 const _noop = (..._args) => undefined;
 export const commonLogLevelNumber = {
     log: 10,
@@ -18,9 +17,9 @@ export const commonLoggerNoop = {
 /**
  * Creates a "child" logger that is "limited" to the specified CommonLogLevel.
  */
-export function commonLoggerMinLevel(logger, minLevel, mutate = false) {
+export function commonLoggerMinLevel(logger, minLevel, opt = {}) {
     const level = commonLogLevelNumber[minLevel];
-    if (mutate) {
+    if (opt.mutate) {
         if (level > commonLogLevelNumber['log']) {
             logger.log = _noop;
             if (level > commonLogLevelNumber['warn']) {

package/dist/math/math.util.js

@@ -27,7 +27,6 @@ export function _averageOrNull(values) {
 export function _averageWeighted(values, weights) {
     let numerator = 0;
     let denominator = 0;
-    // eslint-disable-next-line unicorn/no-for-loop
     for (let i = 0; i < values.length; i++) {
         numerator += values[i] * weights[i];
         denominator += weights[i];

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

@@ -1,4 +1,5 @@
-import type { Inclusiveness, SortDirection } from '../types.js';
+import type { SortOptions } from '../array/array.util.js';
+import type { Inclusiveness } from '../types.js';
 export declare function _randomInt(minIncl: number, maxIncl: number): number;
 /**
  * Returns random item from an array.
@@ -26,7 +27,7 @@ export declare function _runLessOften(percent: number): boolean;
  * Also works with strings:
  * _isBetween('2020-01-03', '2020-01-01', '2020-01-05') // true
  */
-export declare function _isBetween<T extends number | string>(x: T, min: T, max: T, incl?: Inclusiveness): boolean;
+export declare function _isBetween<T extends number | string>(x: T, min: T, max: T, 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,
@@ -37,7 +38,7 @@ export declare function _clamp(x: number, minIncl: number, maxIncl: number): num
  * _sortNumbers([1, 3, 2])
  * // [1, 2, 3]
  */
-export declare function _sortNumbers(numbers: number[], mutate?: boolean, dir?: SortDirection): number[];
+export declare function _sortNumbers(numbers: number[], opt?: SortOptions): number[];
 /**
  * Same as .toFixed(), but conveniently casts the output to Number.
  *

package/dist/number/number.util.js

@@ -32,17 +32,12 @@ export function _runLessOften(percent) {
  * Also works with strings:
  * _isBetween('2020-01-03', '2020-01-01', '2020-01-05') // true
  */
-export function _isBetween(x, min, max, incl = '[)') {
-    if (incl === '[)') {
-        return x >= min && x < max;
-    }
-    if (incl === '[]') {
-        return x >= min && x <= max;
-    }
-    if (incl === '(]') {
-        return x > min && x <= max;
-    }
-    return x > min && x < max;
+export function _isBetween(x, min, max, incl) {
+    if (x < min || x > max)
+        return false;
+    if (x === max && incl === '[)')
+        return false;
+    return true;
 }
 export function _clamp(x, minIncl, maxIncl) {
     // eslint-disable-next-line unicorn/prefer-math-min-max
@@ -57,9 +52,9 @@ export function _clamp(x, minIncl, maxIncl) {
  * _sortNumbers([1, 3, 2])
  * // [1, 2, 3]
  */
-export function _sortNumbers(numbers, mutate = false, dir = 'asc') {
-    const mod = dir === 'desc' ? -1 : 1;
-    return (mutate ? numbers : [...numbers]).sort((a, b) => (a - b) * mod);
+export function _sortNumbers(numbers, opt = {}) {
+    const mod = opt.dir === 'desc' ? -1 : 1;
+    return (opt.mutate ? numbers : [...numbers]).sort((a, b) => (a - b) * mod);
 }
 /**
  * Same as .toFixed(), but conveniently casts the output to Number.

package/dist/object/object.util.d.ts

@@ -1,25 +1,26 @@
+import type { MutateOptions } from '../array/array.util.js';
 import type { AnyObject, KeyValueTuple, ObjectMapper, ObjectPredicate, Reviver, ValueOf } from '../types.js';
 import { SKIP } from '../types.js';
 /**
  * Returns clone of `obj` with only `props` preserved.
  * Opposite of Omit.
  */
-export declare function _pick<T extends AnyObject, K extends keyof T>(obj: T, props: readonly K[], mutate?: boolean): T;
+export declare function _pick<T extends AnyObject, K extends keyof T>(obj: T, props: readonly K[], opt?: MutateOptions): T;
 /**
  * Sets all properties of an object except passed ones to `undefined`.
  * This is a more performant alternative to `_pick` that does picking/deleting.
  */
-export declare function _pickWithUndefined<T extends AnyObject, K extends keyof T>(obj: T, props: readonly K[], mutate?: boolean): T;
+export declare function _pickWithUndefined<T extends AnyObject, K extends keyof T>(obj: T, props: readonly K[], opt?: MutateOptions): T;
 /**
  * Returns clone of `obj` with `props` omitted.
  * Opposite of Pick.
  */
-export declare function _omit<T extends AnyObject, K extends keyof T>(obj: T, props: readonly K[], mutate?: boolean): T;
+export declare function _omit<T extends AnyObject, K extends keyof T>(obj: T, props: readonly K[], opt?: MutateOptions): T;
 /**
  * Sets all passed properties of an object to `undefined`.
  * This is a more performant alternative to `_omit` that does picking/deleting.
  */
-export declare function _omitWithUndefined<T extends AnyObject, K extends keyof T>(obj: T, props: readonly K[], mutate?: boolean): T;
+export declare function _omitWithUndefined<T extends AnyObject, K extends keyof T>(obj: T, props: readonly K[], opt?: MutateOptions): T;
 /**
  * Returns object with filtered keys from `props` array.
  * E.g:
@@ -28,26 +29,26 @@ export declare function _omitWithUndefined<T extends AnyObject, K extends keyof
  *  'account.updated',
  * ])
  */
-export declare function _mask<T extends AnyObject>(obj: T, props: string[], mutate?: boolean): T;
+export declare function _mask<T extends AnyObject>(obj: T, props: string[], opt?: MutateOptions): T;
 /**
  * Removes "falsy" values from the object.
  */
-export declare function _filterFalsyValues<T extends AnyObject>(obj: T, mutate?: boolean): T;
+export declare function _filterFalsyValues<T extends AnyObject>(obj: T, opt?: MutateOptions): T;
 /**
  * Removes values from the object that are `null` or `undefined`.
  */
-export declare function _filterNullishValues<T extends AnyObject>(obj: T, mutate?: boolean): T;
+export declare function _filterNullishValues<T extends AnyObject>(obj: T, opt?: MutateOptions): T;
 /**
  * Removes values from the object that are `undefined`.
  * Only `undefined` values are removed. `null` values are kept!
  */
-export declare function _filterUndefinedValues<T extends AnyObject>(obj: T, mutate?: boolean): T;
-export declare function _filterEmptyArrays<T extends AnyObject>(obj: T, mutate?: boolean): T;
+export declare function _filterUndefinedValues<T extends AnyObject>(obj: T, opt?: MutateOptions): T;
+export declare function _filterEmptyArrays<T extends AnyObject>(obj: T, opt?: MutateOptions): T;
 /**
  * Returns clone of `obj` without properties that does not pass `predicate`.
  * Allows filtering by both key and value.
  */
-export declare function _filterObject<T extends AnyObject>(obj: T, predicate: ObjectPredicate<T>, mutate?: boolean): T;
+export declare function _filterObject<T extends AnyObject>(obj: T, predicate: ObjectPredicate<T>, opt?: MutateOptions): T;
 /**
  * var users = {
  *  'fred':    { 'user': 'fred',    'age': 40 },
@@ -59,7 +60,7 @@ export declare function _filterObject<T extends AnyObject>(obj: T, predicate: Ob
  *
  * To skip some key-value pairs - use _mapObject instead.
  */
-export declare function _mapValues<OUT = unknown, IN extends AnyObject = AnyObject>(obj: IN, mapper: ObjectMapper<IN, any>, mutate?: boolean): OUT;
+export declare function _mapValues<OUT = unknown, IN extends AnyObject = AnyObject>(obj: IN, mapper: ObjectMapper<IN, any>, opt?: MutateOptions): OUT;
 /**
  * _.mapKeys({ 'a': 1, 'b': 2 }, (key, value) => key + value)
  * // => { 'a1': 1, 'b2': 2 }
@@ -87,7 +88,7 @@ export declare function _mapKeys<T extends AnyObject>(obj: T, mapper: ObjectMapp
  */
 export declare function _mapObject<OUT = unknown, IN extends AnyObject = AnyObject>(obj: IN, mapper: ObjectMapper<IN, KeyValueTuple<string, any> | typeof SKIP>): OUT;
 export declare function _findKeyByValue<T extends AnyObject>(obj: T, v: ValueOf<T>): keyof T | undefined;
-export declare function _objectNullValuesToUndefined<T extends AnyObject>(obj: T, mutate?: boolean): T;
+export declare function _objectNullValuesToUndefined<T extends AnyObject>(obj: T, opt?: MutateOptions): T;
 /**
  * Deep copy object (by json parse/stringify, since it has unbeatable performance+simplicity combo).
  */
@@ -100,7 +101,7 @@ export declare function _undefinedIfEmpty<T>(obj: T | undefined): T | undefined;
 /**
  * Filters the object by removing all key-value pairs where Value is Empty (according to _isEmpty() specification).
  */
-export declare function _filterEmptyValues<T extends AnyObject>(obj: T, mutate?: boolean): T;
+export declare function _filterEmptyValues<T extends AnyObject>(obj: T, opt?: MutateOptions): T;
 /**
  * Recursively merges own and inherited enumerable properties of source
  * objects into the destination object, skipping source properties that resolve

package/dist/object/object.util.js

@@ -4,8 +4,8 @@ import { _objectEntries, SKIP } from '../types.js';
  * Returns clone of `obj` with only `props` preserved.
  * Opposite of Omit.
  */
-export function _pick(obj, props, mutate = false) {
-    if (mutate) {
+export function _pick(obj, props, opt = {}) {
+    if (opt.mutate) {
         // Start as original object (mutable), DELETE properties that are not whitelisted
         for (const k of Object.keys(obj)) {
             if (!props.includes(k))
@@ -25,8 +25,8 @@ export function _pick(obj, props, mutate = false) {
  * Sets all properties of an object except passed ones to `undefined`.
  * This is a more performant alternative to `_pick` that does picking/deleting.
  */
-export function _pickWithUndefined(obj, props, mutate = false) {
-    const r = mutate ? obj : { ...obj };
+export function _pickWithUndefined(obj, props, opt = {}) {
+    const r = opt.mutate ? obj : { ...obj };
     for (const k of Object.keys(r)) {
         if (!props.includes(k)) {
             r[k] = undefined;
@@ -38,8 +38,8 @@ export function _pickWithUndefined(obj, props, mutate = false) {
  * Returns clone of `obj` with `props` omitted.
  * Opposite of Pick.
  */
-export function _omit(obj, props, mutate = false) {
-    if (mutate) {
+export function _omit(obj, props, opt = {}) {
+    if (opt.mutate) {
         for (const k of props) {
             delete obj[k];
         }
@@ -56,8 +56,8 @@ export function _omit(obj, props, mutate = false) {
  * Sets all passed properties of an object to `undefined`.
  * This is a more performant alternative to `_omit` that does picking/deleting.
  */
-export function _omitWithUndefined(obj, props, mutate = false) {
-    const r = mutate ? obj : { ...obj };
+export function _omitWithUndefined(obj, props, opt = {}) {
+    const r = opt.mutate ? obj : { ...obj };
     for (const k of props) {
         r[k] = undefined;
     }
@@ -71,8 +71,8 @@ export function _omitWithUndefined(obj, props, mutate = false) {
  *  'account.updated',
  * ])
  */
-export function _mask(obj, props, mutate = false) {
-    const r = mutate ? obj : _deepCopy(obj);
+export function _mask(obj, props, opt = {}) {
+    const r = opt.mutate ? obj : _deepCopy(obj);
     for (const k of props) {
         _unset(r, k);
     }
@@ -81,31 +81,31 @@ export function _mask(obj, props, mutate = false) {
 /**
  * Removes "falsy" values from the object.
  */
-export function _filterFalsyValues(obj, mutate = false) {
-    return _filterObject(obj, (_k, v) => !!v, mutate);
+export function _filterFalsyValues(obj, opt = {}) {
+    return _filterObject(obj, (_k, v) => !!v, opt);
 }
 /**
  * Removes values from the object that are `null` or `undefined`.
  */
-export function _filterNullishValues(obj, mutate = false) {
-    return _filterObject(obj, (_k, v) => v !== undefined && v !== null, mutate);
+export function _filterNullishValues(obj, opt = {}) {
+    return _filterObject(obj, (_k, v) => v !== undefined && v !== null, opt);
 }
 /**
  * Removes values from the object that are `undefined`.
  * Only `undefined` values are removed. `null` values are kept!
  */
-export function _filterUndefinedValues(obj, mutate = false) {
-    return _filterObject(obj, (_k, v) => v !== undefined, mutate);
+export function _filterUndefinedValues(obj, opt = {}) {
+    return _filterObject(obj, (_k, v) => v !== undefined, opt);
 }
-export function _filterEmptyArrays(obj, mutate = false) {
-    return _filterObject(obj, (_k, v) => !Array.isArray(v) || v.length > 0, mutate);
+export function _filterEmptyArrays(obj, opt = {}) {
+    return _filterObject(obj, (_k, v) => !Array.isArray(v) || v.length > 0, opt);
 }
 /**
  * Returns clone of `obj` without properties that does not pass `predicate`.
  * Allows filtering by both key and value.
  */
-export function _filterObject(obj, predicate, mutate = false) {
-    if (mutate) {
+export function _filterObject(obj, predicate, opt = {}) {
+    if (opt.mutate) {
         for (const [k, v] of _objectEntries(obj)) {
             if (!predicate(k, v, obj)) {
                 delete obj[k];
@@ -132,8 +132,8 @@ export function _filterObject(obj, predicate, mutate = false) {
  *
  * To skip some key-value pairs - use _mapObject instead.
  */
-export function _mapValues(obj, mapper, mutate = false) {
-    const map = mutate ? obj : {};
+export function _mapValues(obj, mapper, opt = {}) {
+    const map = opt.mutate ? obj : {};
     for (const [k, v] of Object.entries(obj)) {
         map[k] = mapper(k, v, obj);
     }
@@ -183,8 +183,8 @@ export function _mapObject(obj, mapper) {
 export function _findKeyByValue(obj, v) {
     return Object.entries(obj).find(([_, value]) => value === v)?.[0];
 }
-export function _objectNullValuesToUndefined(obj, mutate = false) {
-    return _mapValues(obj, (_k, v) => (v === null ? undefined : v), mutate);
+export function _objectNullValuesToUndefined(obj, opt = {}) {
+    return _mapValues(obj, (_k, v) => (v === null ? undefined : v), opt);
 }
 /**
  * Deep copy object (by json parse/stringify, since it has unbeatable performance+simplicity combo).
@@ -202,8 +202,8 @@ export function _undefinedIfEmpty(obj) {
 /**
  * Filters the object by removing all key-value pairs where Value is Empty (according to _isEmpty() specification).
  */
-export function _filterEmptyValues(obj, mutate = false) {
-    return _filterObject(obj, (_k, v) => !_isEmpty(v), mutate);
+export function _filterEmptyValues(obj, opt = {}) {
+    return _filterObject(obj, (_k, v) => !_isEmpty(v), opt);
 }
 /**
  * Recursively merges own and inherited enumerable properties of source

package/dist/semver.d.ts

@@ -1,4 +1,4 @@
-import type { SortDirection } from './types.js';
+import type { SortOptions } from './array/array.util.js';
 export type SemverInput = string | Semver;
 export type SemverInputNullable = SemverInput | null | undefined;
 export type SemverTokens = [major: number, minor: number, patch: number];
@@ -62,7 +62,7 @@ declare class SemverFactory {
     /**
      * Sorts an array of Semvers in `dir` order (ascending by default).
      */
-    sort(items: Semver[], dir?: SortDirection, mutate?: boolean): Semver[];
+    sort(items: Semver[], opt?: SortOptions): Semver[];
 }
 interface SemverFn extends SemverFactory {
     (input: SemverInput): Semver;

package/dist/semver.js

@@ -118,9 +118,9 @@ class SemverFactory {
     /**
      * Sorts an array of Semvers in `dir` order (ascending by default).
      */
-    sort(items, dir = 'asc', mutate = false) {
-        const mod = dir === 'desc' ? -1 : 1;
-        return (mutate ? items : [...items]).sort((a, b) => a.compare(b) * mod);
+    sort(items, opt = {}) {
+        const mod = opt.dir === 'desc' ? -1 : 1;
+        return (opt.mutate ? items : [...items]).sort((a, b) => a.compare(b) * mod);
     }
 }
 const semverFactory = new SemverFactory();

package/dist/types.d.ts

@@ -117,10 +117,12 @@ export declare const MISS: unique symbol;
 /**
  * Function which is called for every item in `input`. Expected to return a `Promise` or value.
  */
-export type AsyncMapper<IN = any, OUT = any> = (input: IN, index: number) => OUT | PromiseLike<OUT>;
-export type Mapper<IN = any, OUT = any> = (input: IN, index: number) => OUT;
-export declare const _passthroughMapper: Mapper;
-export declare const _passUndefinedMapper: Mapper<any, void>;
+export type AsyncMapper<IN = any, OUT = any> = (input: IN) => OUT | PromiseLike<OUT>;
+export type AsyncIndexedMapper<IN = any, OUT = any> = (input: IN, index: number) => OUT | PromiseLike<OUT>;
+export type Mapper<IN = any, OUT = any> = (input: IN) => OUT;
+export type IndexedMapper<IN = any, OUT = any> = (input: IN, index: number) => OUT;
+export declare const _passthroughMapper: IndexedMapper;
+export declare const _passUndefinedMapper: IndexedMapper<any, void>;
 /**
  * Function that does nothings and returns `undefined`.
  */
@@ -326,7 +328,7 @@ 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 = '()' | '[]' | '[)' | '(]';
+export type Inclusiveness = '[]' | '[)';
 /**
  * @experimental
  */

package/dist/types.js

@@ -24,7 +24,7 @@ export const _passNothingPredicate = () => false;
  * Like _stringMapValues, but values are sorted.
  */
 export function _stringMapValuesSorted(map, mapper, dir = 'asc') {
-    return _sortBy(_stringMapValues(map), mapper, false, dir);
+    return _sortBy(_stringMapValues(map), mapper, { dir });
 }
 /**
  * Needed due to https://github.com/microsoft/TypeScript/issues/13778

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@naturalcycles/js-lib",
   "type": "module",
-  "version": "15.8.1",
+  "version": "15.9.1",
   "dependencies": {
     "tslib": "^2",
     "zod": "^3"