@naturalcycles/js-lib 14.102.0 → 14.103.0

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

@@ -1,5 +1,5 @@
 import { RecursiveArray } from '../lodash.types';
-import { Mapper, Predicate, StringMap } from '../types';
+import { FalsyValue, Mapper, Predicate, StringMap } from '../types';
 /**
  * Creates an array of elements split into groups the length of size. If collection can’t be split evenly, the
  * final chunk will be the remaining elements.
@@ -115,6 +115,9 @@ export declare function _intersection<T>(...arrays: T[][]): T[];
  * // [1]
  */
 export declare function _difference<T>(source: T[], ...diffs: T[][]): T[];
+/**
+ * Returns the sum of items, or 0 for empty array.
+ */
 export declare function _sum(items: number[]): number;
 export declare function _sumBy<T>(items: T[], mapper: Mapper<T, number | undefined>): number;
 /**
@@ -130,7 +133,7 @@ export declare function _sumBy<T>(items: T[], mapper: Mapper<T, number | undefin
  * _mapToObject([1, 2, 3], n => [n, `id${n}`])
  * // { '1': 'id1, '2': 'id2', '3': 'id3' }
  */
-export declare function _mapToObject<T, V>(array: T[], mapper: (item: T) => [key: any, value: V] | undefined | null | false | 0 | void): StringMap<V>;
+export declare function _mapToObject<T, V>(array: T[], mapper: (item: T) => [key: any, value: V] | FalsyValue): StringMap<V>;
 /**
  * Randomly shuffle an array values.
  * Fisher–Yates algorithm.
@@ -146,7 +149,13 @@ 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;
-export declare function _minOrUndefined<T>(array: T[]): T | undefined;
-export declare function _min<T>(array: T[]): T;
-export declare function _maxOrUndefined<T>(array: T[]): T | undefined;
-export declare function _max<T>(array: T[]): T;
+export declare function _minOrUndefined<T>(array: T[]): NonNullable<T> | undefined;
+/**
+ * Filters out nullish values (undefined and null).
+ */
+export declare function _min<T>(array: T[]): NonNullable<T>;
+export declare function _maxOrUndefined<T>(array: T[]): NonNullable<T> | undefined;
+/**
+ * Filters out nullish values (undefined and null).
+ */
+export declare function _max<T>(array: T[]): NonNullable<T>;

package/dist/array/array.util.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 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._sortBy = exports._groupBy = exports._by = exports._uniqBy = exports._uniq = exports._flattenDeep = exports._flatten = 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
  * final chunk will be the remaining elements.
@@ -210,6 +211,9 @@ function _difference(source, ...diffs) {
     return diffs.reduce((a, b) => a.filter(c => !b.includes(c)), source);
 }
 exports._difference = _difference;
+/**
+ * Returns the sum of items, or 0 for empty array.
+ */
 function _sum(items) {
     return items.reduce((sum, n) => sum + n, 0);
 }
@@ -277,26 +281,36 @@ function _lastOrUndefined(array) {
 }
 exports._lastOrUndefined = _lastOrUndefined;
 function _minOrUndefined(array) {
-    if (!array.length)
+    const a = array.filter(is_util_1._isNotNullish);
+    if (!a.length)
         return;
-    return _min(array);
+    return _min(a);
 }
 exports._minOrUndefined = _minOrUndefined;
+/**
+ * Filters out nullish values (undefined and null).
+ */
 function _min(array) {
-    if (!array.length)
+    const a = array.filter(is_util_1._isNotNullish);
+    if (!a.length)
         throw new Error('_min called on empty array');
-    return array.reduce((min, item) => (min <= item ? min : item));
+    return a.reduce((min, item) => (min <= item ? min : item));
 }
 exports._min = _min;
 function _maxOrUndefined(array) {
-    if (!array.length)
+    const a = array.filter(is_util_1._isNotNullish);
+    if (!a.length)
         return;
-    return _max(array);
+    return _max(a);
 }
 exports._maxOrUndefined = _maxOrUndefined;
+/**
+ * Filters out nullish values (undefined and null).
+ */
 function _max(array) {
-    if (!array.length)
+    const a = array.filter(is_util_1._isNotNullish);
+    if (!a.length)
         throw new Error('_max called on empty array');
-    return array.reduce((max, item) => (max >= item ? max : item));
+    return a.reduce((max, item) => (max >= item ? max : item));
 }
 exports._max = _max;

package/dist/decorators/memo.util.js

@@ -1,11 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MapMemoCache = exports.jsonMemoSerializer = void 0;
-const object_util_1 = require("../object/object.util");
+const __1 = require("..");
 const jsonMemoSerializer = args => {
     if (args.length === 0)
         return undefined;
-    if (args.length === 1 && (0, object_util_1._isPrimitive)(args[0]))
+    if (args.length === 1 && (0, __1._isPrimitive)(args[0]))
         return args[0];
     return JSON.stringify(args);
 };

package/dist/index.d.ts

@@ -50,8 +50,9 @@ export * from './string/json.util';
 export * from './string/string.util';
 import { JsonStringifyFunction, StringifyAnyOptions, _stringifyAny } from './string/stringifyAny';
 export * from './time/time.util';
+export * from './is.util';
 import { Class, ConditionalExcept, ConditionalPick, Merge, Promisable, ReadonlyDeep, Simplify } from './typeFest';
-import { AsyncMapper, AsyncPredicate, BaseDBEntity, CreatedUpdated, CreatedUpdatedId, ObjectWithId, AnyObjectWithId, Saved, Unsaved, UnsavedId, BatchResult, InstanceId, IsoDate, IsoDateString, IsoDateTimeString, KeyValueTuple, Mapper, ObjectMapper, ObjectPredicate, Predicate, PromiseMap, AnyObject, AnyFunction, Reviver, SavedDBEntity, StringMap, UnixTimestampNumber, UnixTimestampMillisNumber, UnixTimestamp, Integer, ValueOf, ValuesOf, AbortableMapper, AbortableAsyncPredicate, AbortableAsyncMapper, AbortablePredicate, END, SKIP, _noop, _objectKeys, _passNothingPredicate, _passthroughMapper, _passthroughPredicate, _passUndefinedMapper, _stringMapEntries, _stringMapValues } from './types';
+import { AsyncMapper, AsyncPredicate, BaseDBEntity, CreatedUpdated, CreatedUpdatedId, ObjectWithId, AnyObjectWithId, Saved, Unsaved, UnsavedId, BatchResult, InstanceId, IsoDate, IsoDateString, IsoDateTimeString, KeyValueTuple, Mapper, ObjectMapper, ObjectPredicate, Predicate, PromiseMap, AnyObject, AnyFunction, Reviver, SavedDBEntity, StringMap, UnixTimestampNumber, UnixTimestampMillisNumber, UnixTimestamp, Integer, ValueOf, ValuesOf, AbortableMapper, AbortableAsyncPredicate, AbortableAsyncMapper, AbortablePredicate, NullishValue, FalsyValue, END, SKIP, _noop, _objectKeys, _passNothingPredicate, _passthroughMapper, _passthroughPredicate, _passUndefinedMapper, _stringMapEntries, _stringMapValues } from './types';
 export * from './unit/size.util';
 import { is } from './vendor/is';
 import { CommonLogLevel, CommonLogFunction, CommonLogger, commonLoggerMinLevel, commonLoggerNoop, commonLogLevelNumber, commonLoggerPipe, commonLoggerPrefix, CommonLogWithLevelFunction, commonLoggerCreate } from './log/commonLogger';
@@ -68,5 +69,5 @@ import { LocalDateConfig, LocalDateFormatter, LocalDateUnit, LocalDateUnitStrict
 import { LocalTimeConfig, LocalTimeFormatter, LocalTimeUnit, LocalTimeComponents, ISODayOfWeek } from './datetime/localTime';
 import { DateIntervalConfig, DateIntervalString } from './datetime/dateInterval';
 import { TimeIntervalConfig, TimeIntervalString } from './datetime/timeInterval';
-export type { DateIntervalConfig, DateIntervalString, TimeIntervalConfig, TimeIntervalString, LocalDateConfig, LocalDateFormatter, LocalDateUnit, LocalDateUnitStrict, Inclusiveness, LocalTimeConfig, LocalTimeFormatter, LocalTimeUnit, ISODayOfWeek, LocalTimeComponents, AbortableMapper, AbortablePredicate, AbortableAsyncPredicate, AbortableAsyncMapper, PQueueCfg, MemoCache, AsyncMemoCache, PromiseDecoratorCfg, PromiseDecoratorResp, ErrorData, ErrorObject, HttpErrorData, HttpErrorResponse, Admin401ErrorData, Admin403ErrorData, StringMap, PromiseMap, AnyObject, AnyFunction, ValuesOf, ValueOf, KeyValueTuple, ObjectMapper, ObjectPredicate, InstanceId, IsoDate, IsoDateString, IsoDateTimeString, Reviver, PMapOptions, Mapper, AsyncMapper, Predicate, AsyncPredicate, BatchResult, DeferredPromise, PRetryOptions, PTimeoutOptions, TryCatchOptions, StringifyAnyOptions, JsonStringifyFunction, Merge, ReadonlyDeep, Promisable, Simplify, ConditionalPick, ConditionalExcept, Class, UnixTimestampNumber, UnixTimestampMillisNumber, UnixTimestamp, Integer, BaseDBEntity, SavedDBEntity, Saved, Unsaved, UnsavedId, CreatedUpdated, CreatedUpdatedId, ObjectWithId, AnyObjectWithId, JsonSchema, JsonSchemaAny, JsonSchemaOneOf, JsonSchemaAllOf, JsonSchemaAnyOf, JsonSchemaNot, JsonSchemaRef, JsonSchemaConst, JsonSchemaEnum, JsonSchemaString, JsonSchemaNumber, JsonSchemaBoolean, JsonSchemaNull, JsonSchemaRootObject, JsonSchemaObject, JsonSchemaArray, JsonSchemaTuple, JsonSchemaBuilder, CommonLogLevel, CommonLogWithLevelFunction, CommonLogFunction, CommonLogger, };
+export type { DateIntervalConfig, DateIntervalString, TimeIntervalConfig, TimeIntervalString, LocalDateConfig, LocalDateFormatter, LocalDateUnit, LocalDateUnitStrict, Inclusiveness, LocalTimeConfig, LocalTimeFormatter, LocalTimeUnit, ISODayOfWeek, LocalTimeComponents, AbortableMapper, AbortablePredicate, AbortableAsyncPredicate, AbortableAsyncMapper, PQueueCfg, MemoCache, AsyncMemoCache, PromiseDecoratorCfg, PromiseDecoratorResp, ErrorData, ErrorObject, HttpErrorData, HttpErrorResponse, Admin401ErrorData, Admin403ErrorData, StringMap, PromiseMap, AnyObject, AnyFunction, ValuesOf, ValueOf, KeyValueTuple, ObjectMapper, ObjectPredicate, InstanceId, IsoDate, IsoDateString, IsoDateTimeString, Reviver, FalsyValue, NullishValue, PMapOptions, Mapper, AsyncMapper, Predicate, AsyncPredicate, BatchResult, DeferredPromise, PRetryOptions, PTimeoutOptions, TryCatchOptions, StringifyAnyOptions, JsonStringifyFunction, Merge, ReadonlyDeep, Promisable, Simplify, ConditionalPick, ConditionalExcept, Class, UnixTimestampNumber, UnixTimestampMillisNumber, UnixTimestamp, Integer, BaseDBEntity, SavedDBEntity, Saved, Unsaved, UnsavedId, CreatedUpdated, CreatedUpdatedId, ObjectWithId, AnyObjectWithId, JsonSchema, JsonSchemaAny, JsonSchemaOneOf, JsonSchemaAllOf, JsonSchemaAnyOf, JsonSchemaNot, JsonSchemaRef, JsonSchemaConst, JsonSchemaEnum, JsonSchemaString, JsonSchemaNumber, JsonSchemaBoolean, JsonSchemaNull, JsonSchemaRootObject, JsonSchemaObject, JsonSchemaArray, JsonSchemaTuple, JsonSchemaBuilder, CommonLogLevel, CommonLogWithLevelFunction, CommonLogFunction, CommonLogger, };
 export { is, _createPromiseDecorator, _stringMapValues, _stringMapEntries, _objectKeys, pMap, _passthroughMapper, _passUndefinedMapper, _passthroughPredicate, _passNothingPredicate, _noop, ErrorMode, pDefer, AggregatedError, pRetry, pRetryFn, pTimeout, pTimeoutFn, _tryCatch, _TryCatch, _stringifyAny, jsonSchema, JsonSchemaAnyBuilder, commonLoggerMinLevel, commonLoggerNoop, commonLogLevelNumber, commonLoggerPipe, commonLoggerPrefix, commonLoggerCreate, PQueue, END, SKIP, };

package/dist/index.js

@@ -65,6 +65,7 @@ tslib_1.__exportStar(require("./string/string.util"), exports);
 const stringifyAny_1 = require("./string/stringifyAny");
 Object.defineProperty(exports, "_stringifyAny", { enumerable: true, get: function () { return stringifyAny_1._stringifyAny; } });
 tslib_1.__exportStar(require("./time/time.util"), exports);
+tslib_1.__exportStar(require("./is.util"), exports);
 const types_1 = require("./types");
 Object.defineProperty(exports, "END", { enumerable: true, get: function () { return types_1.END; } });
 Object.defineProperty(exports, "SKIP", { enumerable: true, get: function () { return types_1.SKIP; } });

package/dist/is.util.d.ts

@@ -0,0 +1,40 @@
+import { Primitive } from './typeFest';
+import { AnyObject, FalsyValue, NullishValue } from './types';
+declare type Nullish<T> = T extends NullishValue ? T : never;
+declare type Truthy<T> = T extends FalsyValue ? never : T;
+declare type Falsy<T> = T extends FalsyValue ? T : never;
+export declare const _isNull: <T>(v: T) => v is T extends null ? T : never;
+export declare const _isUndefined: <T>(v: T) => v is T extends undefined ? T : never;
+export declare const _isNullish: <T>(v: T) => v is Nullish<T>;
+export declare const _isNotNullish: <T>(v: T) => v is NonNullable<T>;
+/**
+ * Same as Boolean, but with correct type output.
+ * Related:
+ * https://github.com/microsoft/TypeScript/issues/16655
+ * https://www.karltarvas.com/2021/03/11/typescript-array-filter-boolean.html
+ *
+ * @example
+ *
+ * [1, 2, undefined].filter(_isTruthy)
+ * // => [1, 2]
+ */
+export declare const _isTruthy: <T>(v: T) => v is Truthy<T>;
+export declare const _isFalsy: <T>(v: T) => v is Falsy<T>;
+/**
+ * Returns true if item is Object, not null and not Array.
+ */
+export declare function _isObject(item: any): item is AnyObject;
+export declare function _isPrimitive(v: any): v is Primitive;
+export declare function _isEmptyObject(obj: any): boolean;
+/**
+ * Object is considered empty if it's one of:
+ * undefined
+ * null
+ * '' (empty string)
+ * [] (empty array)
+ * {} (empty object)
+ * new Map() (empty Map)
+ * new Set() (empty Set)
+ */
+export declare function _isEmpty(obj: any): boolean;
+export {};

package/dist/is.util.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports._isEmpty = exports._isEmptyObject = exports._isPrimitive = exports._isObject = exports._isFalsy = exports._isTruthy = exports._isNotNullish = exports._isNullish = exports._isUndefined = exports._isNull = void 0;
+const _isNull = (v) => v === null;
+exports._isNull = _isNull;
+const _isUndefined = (v) => typeof v === 'undefined';
+exports._isUndefined = _isUndefined;
+const _isNullish = (v) => typeof v === 'undefined' || v === null;
+exports._isNullish = _isNullish;
+const _isNotNullish = (v) => v !== undefined && v !== null;
+exports._isNotNullish = _isNotNullish;
+/**
+ * Same as Boolean, but with correct type output.
+ * Related:
+ * https://github.com/microsoft/TypeScript/issues/16655
+ * https://www.karltarvas.com/2021/03/11/typescript-array-filter-boolean.html
+ *
+ * @example
+ *
+ * [1, 2, undefined].filter(_isTruthy)
+ * // => [1, 2]
+ */
+const _isTruthy = (v) => !!v;
+exports._isTruthy = _isTruthy;
+const _isFalsy = (v) => !v;
+exports._isFalsy = _isFalsy;
+/**
+ * Returns true if item is Object, not null and not Array.
+ */
+function _isObject(item) {
+    return (typeof item === 'object' && item !== null && !Array.isArray(item)) || false;
+}
+exports._isObject = _isObject;
+function _isPrimitive(v) {
+    return (v === null ||
+        v === undefined ||
+        typeof v === 'number' ||
+        typeof v === 'boolean' ||
+        typeof v === 'string' ||
+        typeof v === 'bigint' ||
+        typeof v === 'symbol');
+}
+exports._isPrimitive = _isPrimitive;
+function _isEmptyObject(obj) {
+    return obj && obj.constructor === Object && Object.keys(obj).length === 0;
+}
+exports._isEmptyObject = _isEmptyObject;
+/**
+ * Object is considered empty if it's one of:
+ * undefined
+ * null
+ * '' (empty string)
+ * [] (empty array)
+ * {} (empty object)
+ * new Map() (empty Map)
+ * new Set() (empty Set)
+ */
+function _isEmpty(obj) {
+    if (obj === undefined || obj === null)
+        return true;
+    if (typeof obj === 'string' || Array.isArray(obj)) {
+        return obj.length === 0;
+    }
+    if (obj instanceof Map || obj instanceof Set) {
+        return obj.size === 0;
+    }
+    if (typeof obj === 'object') {
+        return Object.keys(obj).length === 0;
+    }
+    return false;
+}
+exports._isEmpty = _isEmpty;

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

@@ -84,23 +84,6 @@ export declare function _objectNullValuesToUndefined<T extends AnyObject>(obj: T
  * Deep copy object (by json parse/stringify, since it has unbeatable performance+simplicity combo).
  */
 export declare function _deepCopy<T>(o: T): T;
-/**
- * Returns true if item is Object, not null and not Array.
- */
-export declare function _isObject(item: any): item is AnyObject;
-export declare function _isPrimitive(v: any): v is null | undefined | number | boolean | string;
-export declare function _isEmptyObject(obj: any): boolean;
-/**
- * Object is considered empty if it's one of:
- * undefined
- * null
- * '' (empty string)
- * [] (empty array)
- * {} (empty object)
- * new Map() (empty Map)
- * new Set() (empty Set)
- */
-export declare function _isEmpty(obj: any): boolean;
 /**
  * Returns `undefined` if it's empty (according to `_isEmpty()` specification),
  * otherwise returns the original object.

package/dist/object/object.util.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports._has = exports._set = exports._get = exports._invertMap = exports._invert = exports._unset = exports._deepTrim = exports._merge = exports._filterEmptyValues = exports._undefinedIfEmpty = exports._isEmpty = exports._isEmptyObject = exports._isPrimitive = exports._isObject = exports._deepCopy = exports._objectNullValuesToUndefined = exports._findKeyByValue = exports._mapObject = exports._mapKeys = exports._mapValues = exports._filterObject = exports._filterEmptyArrays = exports._filterUndefinedValues = exports._filterNullishValues = exports._filterFalsyValues = exports._mask = exports._omit = exports._pick = void 0;
+exports._has = exports._set = exports._get = exports._invertMap = exports._invert = exports._unset = exports._deepTrim = exports._merge = exports._filterEmptyValues = exports._undefinedIfEmpty = exports._deepCopy = exports._objectNullValuesToUndefined = exports._findKeyByValue = exports._mapObject = exports._mapKeys = exports._mapValues = exports._filterObject = exports._filterEmptyArrays = exports._filterUndefinedValues = exports._filterNullishValues = exports._filterFalsyValues = exports._mask = exports._omit = exports._pick = void 0;
+const is_util_1 = require("../is.util");
 /**
  * Returns clone of `obj` with only `props` preserved.
  * Opposite of Omit.
@@ -164,63 +165,19 @@ function _deepCopy(o) {
     return JSON.parse(JSON.stringify(o));
 }
 exports._deepCopy = _deepCopy;
-/**
- * Returns true if item is Object, not null and not Array.
- */
-function _isObject(item) {
-    return (typeof item === 'object' && item !== null && !Array.isArray(item)) || false;
-}
-exports._isObject = _isObject;
-function _isPrimitive(v) {
-    return (v === null ||
-        v === undefined ||
-        typeof v === 'number' ||
-        typeof v === 'boolean' ||
-        typeof v === 'string');
-}
-exports._isPrimitive = _isPrimitive;
-function _isEmptyObject(obj) {
-    return obj && obj.constructor === Object && Object.keys(obj).length === 0;
-}
-exports._isEmptyObject = _isEmptyObject;
-/**
- * Object is considered empty if it's one of:
- * undefined
- * null
- * '' (empty string)
- * [] (empty array)
- * {} (empty object)
- * new Map() (empty Map)
- * new Set() (empty Set)
- */
-function _isEmpty(obj) {
-    if (obj === undefined || obj === null)
-        return true;
-    if (typeof obj === 'string' || Array.isArray(obj)) {
-        return obj.length === 0;
-    }
-    if (obj instanceof Map || obj instanceof Set) {
-        return obj.size === 0;
-    }
-    if (typeof obj === 'object') {
-        return Object.keys(obj).length === 0;
-    }
-    return false;
-}
-exports._isEmpty = _isEmpty;
 /**
  * Returns `undefined` if it's empty (according to `_isEmpty()` specification),
  * otherwise returns the original object.
  */
 function _undefinedIfEmpty(obj) {
-    return _isEmpty(obj) ? undefined : obj;
+    return (0, is_util_1._isEmpty)(obj) ? undefined : obj;
 }
 exports._undefinedIfEmpty = _undefinedIfEmpty;
 /**
  * Filters the object by removing all key-value pairs where Value is Empty (according to _isEmpty() specification).
  */
 function _filterEmptyValues(obj, mutate = false) {
-    return _filterObject(obj, (_k, v) => !_isEmpty(v), mutate);
+    return _filterObject(obj, (_k, v) => !(0, is_util_1._isEmpty)(v), mutate);
 }
 exports._filterEmptyValues = _filterEmptyValues;
 /**
@@ -254,9 +211,9 @@ exports._filterEmptyValues = _filterEmptyValues;
  */
 function _merge(target, ...sources) {
     sources.forEach(source => {
-        if (_isObject(source)) {
+        if ((0, is_util_1._isObject)(source)) {
             Object.keys(source).forEach(key => {
-                if (_isObject(source[key])) {
+                if ((0, is_util_1._isObject)(source[key])) {
                     if (!target[key])
                         Object.assign(target, { [key]: {} });
                     _merge(target[key], source[key]);
@@ -292,7 +249,7 @@ exports._deepTrim = _deepTrim;
 // from: https://github.com/jonschlinkert/unset-value
 // mutates obj
 function _unset(obj, prop) {
-    if (!_isObject(obj)) {
+    if (!(0, is_util_1._isObject)(obj)) {
         return;
     }
     // eslint-disable-next-line no-prototype-builtins
@@ -305,11 +262,11 @@ function _unset(obj, prop) {
     while (segs.length && segs[segs.length - 1].slice(-1) === '\\') {
         last = segs.pop().slice(0, -1) + '.' + last;
     }
-    while (segs.length && _isObject(obj)) {
+    while (segs.length && (0, is_util_1._isObject)(obj)) {
         const k = (prop = segs.shift());
         obj = obj[k];
     }
-    if (!_isObject(obj))
+    if (!(0, is_util_1._isObject)(obj))
         return;
     delete obj[last];
 }

package/dist/object/sortObjectDeep.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports._sortObjectDeep = void 0;
-const object_util_1 = require("./object.util");
+const __1 = require("..");
 /**
  * based on: https://github.com/IndigoUnited/js-deep-sort-object
  */
@@ -11,7 +11,7 @@ function _sortObjectDeep(o) {
         // eslint-disable-next-line unicorn/no-array-callback-reference
         return o.map(_sortObjectDeep);
     }
-    if ((0, object_util_1._isObject)(o)) {
+    if ((0, __1._isObject)(o)) {
         const out = {};
         Object.keys(o)
             .sort((a, b) => a.localeCompare(b))

package/dist/types.d.ts

@@ -189,3 +189,5 @@ export declare function _stringMapEntries<T>(m: StringMap<T>): [k: string, v: T]
  * @experimental
  */
 export declare function _objectKeys<T extends AnyObject>(obj: T): (keyof T)[];
+export declare type NullishValue = null | undefined;
+export declare type FalsyValue = false | '' | 0 | null | undefined;

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

@@ -1,3 +1,4 @@
+import { _isNotNullish } from '../is.util';
 /**
  * Creates an array of elements split into groups the length of size. If collection can’t be split evenly, the
  * final chunk will be the remaining elements.
@@ -191,6 +192,9 @@ export function _intersection(...arrays) {
 export function _difference(source, ...diffs) {
     return diffs.reduce((a, b) => a.filter(c => !b.includes(c)), source);
 }
+/**
+ * Returns the sum of items, or 0 for empty array.
+ */
 export function _sum(items) {
     return items.reduce((sum, n) => sum + n, 0);
 }
@@ -252,22 +256,32 @@ export function _lastOrUndefined(array) {
     return array[array.length - 1];
 }
 export function _minOrUndefined(array) {
-    if (!array.length)
+    const a = array.filter(_isNotNullish);
+    if (!a.length)
         return;
-    return _min(array);
+    return _min(a);
 }
+/**
+ * Filters out nullish values (undefined and null).
+ */
 export function _min(array) {
-    if (!array.length)
+    const a = array.filter(_isNotNullish);
+    if (!a.length)
         throw new Error('_min called on empty array');
-    return array.reduce((min, item) => (min <= item ? min : item));
+    return a.reduce((min, item) => (min <= item ? min : item));
 }
 export function _maxOrUndefined(array) {
-    if (!array.length)
+    const a = array.filter(_isNotNullish);
+    if (!a.length)
         return;
-    return _max(array);
+    return _max(a);
 }
+/**
+ * Filters out nullish values (undefined and null).
+ */
 export function _max(array) {
-    if (!array.length)
+    const a = array.filter(_isNotNullish);
+    if (!a.length)
         throw new Error('_max called on empty array');
-    return array.reduce((max, item) => (max >= item ? max : item));
+    return a.reduce((max, item) => (max >= item ? max : item));
 }

package/dist-esm/decorators/memo.util.js

@@ -1,4 +1,4 @@
-import { _isPrimitive } from '../object/object.util';
+import { _isPrimitive } from '..';
 export const jsonMemoSerializer = args => {
     if (args.length === 0)
         return undefined;

package/dist-esm/index.js

@@ -47,6 +47,7 @@ export * from './string/json.util';
 export * from './string/string.util';
 import { _stringifyAny } from './string/stringifyAny';
 export * from './time/time.util';
+export * from './is.util';
 import { END, SKIP, _noop, _objectKeys, _passNothingPredicate, _passthroughMapper, _passthroughPredicate, _passUndefinedMapper, _stringMapEntries, _stringMapValues, } from './types';
 export * from './unit/size.util';
 import { is } from './vendor/is';

package/dist-esm/is.util.js

@@ -0,0 +1,59 @@
+export const _isNull = (v) => v === null;
+export const _isUndefined = (v) => typeof v === 'undefined';
+export const _isNullish = (v) => typeof v === 'undefined' || v === null;
+export const _isNotNullish = (v) => v !== undefined && v !== null;
+/**
+ * Same as Boolean, but with correct type output.
+ * Related:
+ * https://github.com/microsoft/TypeScript/issues/16655
+ * https://www.karltarvas.com/2021/03/11/typescript-array-filter-boolean.html
+ *
+ * @example
+ *
+ * [1, 2, undefined].filter(_isTruthy)
+ * // => [1, 2]
+ */
+export const _isTruthy = (v) => !!v;
+export const _isFalsy = (v) => !v;
+/**
+ * Returns true if item is Object, not null and not Array.
+ */
+export function _isObject(item) {
+    return (typeof item === 'object' && item !== null && !Array.isArray(item)) || false;
+}
+export function _isPrimitive(v) {
+    return (v === null ||
+        v === undefined ||
+        typeof v === 'number' ||
+        typeof v === 'boolean' ||
+        typeof v === 'string' ||
+        typeof v === 'bigint' ||
+        typeof v === 'symbol');
+}
+export function _isEmptyObject(obj) {
+    return obj && obj.constructor === Object && Object.keys(obj).length === 0;
+}
+/**
+ * Object is considered empty if it's one of:
+ * undefined
+ * null
+ * '' (empty string)
+ * [] (empty array)
+ * {} (empty object)
+ * new Map() (empty Map)
+ * new Set() (empty Set)
+ */
+export function _isEmpty(obj) {
+    if (obj === undefined || obj === null)
+        return true;
+    if (typeof obj === 'string' || Array.isArray(obj)) {
+        return obj.length === 0;
+    }
+    if (obj instanceof Map || obj instanceof Set) {
+        return obj.size === 0;
+    }
+    if (typeof obj === 'object') {
+        return Object.keys(obj).length === 0;
+    }
+    return false;
+}

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

@@ -1,3 +1,4 @@
+import { _isEmpty, _isObject } from '../is.util';
 /**
  * Returns clone of `obj` with only `props` preserved.
  * Opposite of Omit.
@@ -148,46 +149,6 @@ export function _objectNullValuesToUndefined(obj, mutate = false) {
 export function _deepCopy(o) {
     return JSON.parse(JSON.stringify(o));
 }
-/**
- * Returns true if item is Object, not null and not Array.
- */
-export function _isObject(item) {
-    return (typeof item === 'object' && item !== null && !Array.isArray(item)) || false;
-}
-export function _isPrimitive(v) {
-    return (v === null ||
-        v === undefined ||
-        typeof v === 'number' ||
-        typeof v === 'boolean' ||
-        typeof v === 'string');
-}
-export function _isEmptyObject(obj) {
-    return obj && obj.constructor === Object && Object.keys(obj).length === 0;
-}
-/**
- * Object is considered empty if it's one of:
- * undefined
- * null
- * '' (empty string)
- * [] (empty array)
- * {} (empty object)
- * new Map() (empty Map)
- * new Set() (empty Set)
- */
-export function _isEmpty(obj) {
-    if (obj === undefined || obj === null)
-        return true;
-    if (typeof obj === 'string' || Array.isArray(obj)) {
-        return obj.length === 0;
-    }
-    if (obj instanceof Map || obj instanceof Set) {
-        return obj.size === 0;
-    }
-    if (typeof obj === 'object') {
-        return Object.keys(obj).length === 0;
-    }
-    return false;
-}
 /**
  * Returns `undefined` if it's empty (according to `_isEmpty()` specification),
  * otherwise returns the original object.

package/dist-esm/object/sortObjectDeep.js

@@ -1,4 +1,4 @@
-import { _isObject } from './object.util';
+import { _isObject } from '..';
 /**
  * based on: https://github.com/IndigoUnited/js-deep-sort-object
  */

package/package.json

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

package/src/array/array.util.ts

@@ -1,5 +1,6 @@
+import { _isNotNullish } from '../is.util'
 import { RecursiveArray } from '../lodash.types'
-import { Mapper, Predicate, StringMap } from '../types'
+import { FalsyValue, Mapper, Predicate, StringMap } from '../types'
 
 /**
  * Creates an array of elements split into groups the length of size. If collection can’t be split evenly, the
@@ -216,6 +217,9 @@ export function _difference<T>(source: T[], ...diffs: T[][]): T[] {
   return diffs.reduce((a, b) => a.filter(c => !b.includes(c)), source)
 }
 
+/**
+ * Returns the sum of items, or 0 for empty array.
+ */
 export function _sum(items: number[]): number {
   return items.reduce((sum, n) => sum + n, 0)
 }
@@ -242,7 +246,7 @@ export function _sumBy<T>(items: T[], mapper: Mapper<T, number | undefined>): nu
  */
 export function _mapToObject<T, V>(
   array: T[],
-  mapper: (item: T) => [key: any, value: V] | undefined | null | false | 0 | void,
+  mapper: (item: T) => [key: any, value: V] | FalsyValue,
 ): StringMap<V> {
   const m: StringMap<V> = {}
 
@@ -288,22 +292,32 @@ export function _lastOrUndefined<T>(array: T[]): T | undefined {
   return array[array.length - 1]
 }
 
-export function _minOrUndefined<T>(array: T[]): T | undefined {
-  if (!array.length) return
-  return _min(array)
+export function _minOrUndefined<T>(array: T[]): NonNullable<T> | undefined {
+  const a = array.filter(_isNotNullish)
+  if (!a.length) return
+  return _min(a)
 }
 
-export function _min<T>(array: T[]): T {
-  if (!array.length) throw new Error('_min called on empty array')
-  return array.reduce((min, item) => (min <= item ? min : item))
+/**
+ * Filters out nullish values (undefined and null).
+ */
+export function _min<T>(array: T[]): NonNullable<T> {
+  const a = array.filter(_isNotNullish)
+  if (!a.length) throw new Error('_min called on empty array')
+  return a.reduce((min, item) => (min <= item ? min : item))
 }
 
-export function _maxOrUndefined<T>(array: T[]): T | undefined {
-  if (!array.length) return
-  return _max(array)
+export function _maxOrUndefined<T>(array: T[]): NonNullable<T> | undefined {
+  const a = array.filter(_isNotNullish)
+  if (!a.length) return
+  return _max(a)
 }
 
-export function _max<T>(array: T[]): T {
-  if (!array.length) throw new Error('_max called on empty array')
-  return array.reduce((max, item) => (max >= item ? max : item))
+/**
+ * Filters out nullish values (undefined and null).
+ */
+export function _max<T>(array: T[]): NonNullable<T> {
+  const a = array.filter(_isNotNullish)
+  if (!a.length) throw new Error('_max called on empty array')
+  return a.reduce((max, item) => (max >= item ? max : item))
 }

package/src/decorators/memo.util.ts

@@ -1,4 +1,4 @@
-import { _isPrimitive } from '../object/object.util'
+import { _isPrimitive } from '..'
 import { Promisable } from '../typeFest'
 
 export type MemoSerializer = (args: any[]) => any

package/src/index.ts

@@ -83,6 +83,8 @@ export * from './string/json.util'
 export * from './string/string.util'
 import { JsonStringifyFunction, StringifyAnyOptions, _stringifyAny } from './string/stringifyAny'
 export * from './time/time.util'
+export * from './is.util'
+
 import {
   Class,
   ConditionalExcept,
@@ -129,6 +131,8 @@ import {
   AbortableAsyncPredicate,
   AbortableAsyncMapper,
   AbortablePredicate,
+  NullishValue,
+  FalsyValue,
   END,
   SKIP,
   _noop,
@@ -224,6 +228,8 @@ export type {
   IsoDateString,
   IsoDateTimeString,
   Reviver,
+  FalsyValue,
+  NullishValue,
   PMapOptions,
   Mapper,
   AsyncMapper,

package/src/is.util.ts

@@ -0,0 +1,77 @@
+import { Primitive } from './typeFest'
+import { AnyObject, FalsyValue, NullishValue } from './types'
+
+type Nullish<T> = T extends NullishValue ? T : never
+type Truthy<T> = T extends FalsyValue ? never : T
+type Falsy<T> = T extends FalsyValue ? T : never
+
+export const _isNull = <T>(v: T): v is T extends null ? T : never => v === null
+export const _isUndefined = <T>(v: T): v is T extends undefined ? T : never =>
+  typeof v === 'undefined'
+export const _isNullish = <T>(v: T): v is Nullish<T> => typeof v === 'undefined' || v === null
+export const _isNotNullish = <T>(v: T): v is NonNullable<T> => v !== undefined && v !== null
+
+/**
+ * Same as Boolean, but with correct type output.
+ * Related:
+ * https://github.com/microsoft/TypeScript/issues/16655
+ * https://www.karltarvas.com/2021/03/11/typescript-array-filter-boolean.html
+ *
+ * @example
+ *
+ * [1, 2, undefined].filter(_isTruthy)
+ * // => [1, 2]
+ */
+export const _isTruthy = <T>(v: T): v is Truthy<T> => !!v
+export const _isFalsy = <T>(v: T): v is Falsy<T> => !v
+
+/**
+ * Returns true if item is Object, not null and not Array.
+ */
+export function _isObject(item: any): item is AnyObject {
+  return (typeof item === 'object' && item !== null && !Array.isArray(item)) || false
+}
+
+export function _isPrimitive(v: any): v is Primitive {
+  return (
+    v === null ||
+    v === undefined ||
+    typeof v === 'number' ||
+    typeof v === 'boolean' ||
+    typeof v === 'string' ||
+    typeof v === 'bigint' ||
+    typeof v === 'symbol'
+  )
+}
+
+export function _isEmptyObject(obj: any): boolean {
+  return obj && obj.constructor === Object && Object.keys(obj).length === 0
+}
+
+/**
+ * Object is considered empty if it's one of:
+ * undefined
+ * null
+ * '' (empty string)
+ * [] (empty array)
+ * {} (empty object)
+ * new Map() (empty Map)
+ * new Set() (empty Set)
+ */
+export function _isEmpty(obj: any): boolean {
+  if (obj === undefined || obj === null) return true
+
+  if (typeof obj === 'string' || Array.isArray(obj)) {
+    return obj.length === 0
+  }
+
+  if (obj instanceof Map || obj instanceof Set) {
+    return obj.size === 0
+  }
+
+  if (typeof obj === 'object') {
+    return Object.keys(obj).length === 0
+  }
+
+  return false
+}

package/src/object/object.util.ts

@@ -1,3 +1,4 @@
+import { _isEmpty, _isObject } from '../is.util'
 import { PropertyPath } from '../lodash.types'
 import { AnyObject, ObjectMapper, ObjectPredicate, StringMap, ValueOf } from '../types'
 
@@ -190,55 +191,6 @@ export function _deepCopy<T>(o: T): T {
   return JSON.parse(JSON.stringify(o))
 }
 
-/**
- * Returns true if item is Object, not null and not Array.
- */
-export function _isObject(item: any): item is AnyObject {
-  return (typeof item === 'object' && item !== null && !Array.isArray(item)) || false
-}
-
-export function _isPrimitive(v: any): v is null | undefined | number | boolean | string {
-  return (
-    v === null ||
-    v === undefined ||
-    typeof v === 'number' ||
-    typeof v === 'boolean' ||
-    typeof v === 'string'
-  )
-}
-
-export function _isEmptyObject(obj: any): boolean {
-  return obj && obj.constructor === Object && Object.keys(obj).length === 0
-}
-
-/**
- * Object is considered empty if it's one of:
- * undefined
- * null
- * '' (empty string)
- * [] (empty array)
- * {} (empty object)
- * new Map() (empty Map)
- * new Set() (empty Set)
- */
-export function _isEmpty(obj: any): boolean {
-  if (obj === undefined || obj === null) return true
-
-  if (typeof obj === 'string' || Array.isArray(obj)) {
-    return obj.length === 0
-  }
-
-  if (obj instanceof Map || obj instanceof Set) {
-    return obj.size === 0
-  }
-
-  if (typeof obj === 'object') {
-    return Object.keys(obj).length === 0
-  }
-
-  return false
-}
-
 /**
  * Returns `undefined` if it's empty (according to `_isEmpty()` specification),
  * otherwise returns the original object.

package/src/object/sortObjectDeep.ts

@@ -1,4 +1,4 @@
-import { _isObject } from './object.util'
+import { _isObject } from '..'
 
 /**
  * based on: https://github.com/IndigoUnited/js-deep-sort-object

package/src/types.ts

@@ -260,3 +260,6 @@ export function _stringMapEntries<T>(m: StringMap<T>): [k: string, v: T][] {
 export function _objectKeys<T extends AnyObject>(obj: T): (keyof T)[] {
   return Object.keys(obj)
 }
+
+export type NullishValue = null | undefined
+export type FalsyValue = false | '' | 0 | null | undefined