@naturalcycles/js-lib 14.190.0 → 14.192.0

package/dist/array/range.d.ts

@@ -1,3 +1,4 @@
+import { Iterable2 } from '../iter/iterable2';
 /**
  * Returns an array with ranges from `from` up to (but not including) `to`.
  *
@@ -10,3 +11,8 @@
  */
 export declare function _range(toExcl: number): number[];
 export declare function _range(fromIncl: number, toExcl: number, step?: number): number[];
+/**
+ * Like _range, but returns an Iterable2.
+ */
+export declare function _rangeIt(toExcl: number): Iterable2<number>;
+export declare function _rangeIt(fromIncl: number, toExcl: number, step?: number): Iterable2<number>;

package/dist/array/range.js

@@ -1,7 +1,7 @@
 "use strict";
-/* eslint-disable no-redeclare, unicorn/no-new-array */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports._range = void 0;
+exports._rangeIt = exports._range = void 0;
+const iterable2_1 = require("../iter/iterable2");
 function _range(fromIncl, toExcl, step = 1) {
     if (toExcl === undefined) {
         return Array.from(new Array(fromIncl), (_, i) => i);
@@ -9,3 +9,17 @@ function _range(fromIncl, toExcl, step = 1) {
     return Array.from({ length: Math.ceil((toExcl - fromIncl) / step) }, (_, i) => i * step + fromIncl);
 }
 exports._range = _range;
+function _rangeIt(fromIncl, toExcl, step = 1) {
+    if (toExcl === undefined) {
+        toExcl = fromIncl;
+        fromIncl = 0;
+    }
+    return iterable2_1.Iterable2.of({
+        *[Symbol.iterator]() {
+            for (let i = fromIncl; i < toExcl; i += step) {
+                yield i;
+            }
+        },
+    });
+}
+exports._rangeIt = _rangeIt;

package/dist/datetime/localDate.d.ts

@@ -1,3 +1,4 @@
+import { Iterable2 } from '../iter/iterable2';
 import type { IsoDateString, IsoDateTimeString, MonthId, SortDirection, UnixTimestampMillisNumber, UnixTimestampNumber } from '../types';
 import { LocalTime } from './localTime';
 export type LocalDateUnit = LocalDateUnitStrict | 'week';
@@ -35,6 +36,10 @@ export declare class LocalDate {
     static latestOrUndefined(items: LocalDateInput[]): LocalDate | undefined;
     static latest(items: LocalDateInput[]): LocalDate;
     static range(min: LocalDateInput, max: LocalDateInput, incl?: Inclusiveness, step?: number, stepUnit?: LocalDateUnit): LocalDate[];
+    /**
+     * Experimental, returns the range as Iterable2.
+     */
+    static rangeIt(min: LocalDateInput, max: LocalDateInput, incl?: Inclusiveness, step?: number, stepUnit?: LocalDateUnit): Iterable2<LocalDate>;
     get(unit: LocalDateUnitStrict): number;
     set(unit: LocalDateUnitStrict, v: number, mutate?: boolean): LocalDate;
     year(): number;

package/dist/datetime/localDate.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.localDateOrToday = exports.localDateOrUndefined = exports.localDateToday = exports.localDate = exports.LocalDate = void 0;
 const assert_1 = require("../error/assert");
+const iterable2_1 = require("../iter/iterable2");
 const localTime_1 = require("./localTime");
 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)$/;
@@ -104,27 +105,37 @@ class LocalDate {
             .reduce((max, item) => (max.isSameOrAfter(item) ? max : item));
     }
     static range(min, max, incl = '[)', step = 1, stepUnit = 'day') {
+        return this.rangeIt(min, max, incl, step, stepUnit).toArray();
+    }
+    /**
+     * Experimental, returns the range as Iterable2.
+     */
+    static rangeIt(min, max, incl = '[)', step = 1, stepUnit = 'day') {
         if (stepUnit === 'week') {
             step *= 7;
             stepUnit = 'day';
         }
-        const dates = [];
-        const $min = LocalDate.of(min);
+        const $min = LocalDate.of(min).startOf(stepUnit);
         const $max = LocalDate.of(max).startOf(stepUnit);
-        let current = $min.startOf(stepUnit);
+        let value = $min;
         // eslint-disable-next-line @typescript-eslint/prefer-string-starts-ends-with
-        if (current.isAfter($min, incl[0] === '[')) {
+        if (value.isAfter($min, incl[0] === '[')) {
             // ok
         }
         else {
-            current.plus(1, stepUnit, true);
+            value.plus(1, stepUnit, true);
         }
-        const incl2 = incl[1] === ']';
-        while (current.isBefore($max, incl2)) {
-            dates.push(current);
-            current = current.plus(step, stepUnit);
-        }
-        return dates;
+        const rightInclusive = incl[1] === ']';
+        return iterable2_1.Iterable2.of({
+            *[Symbol.iterator]() {
+                while (value.isBefore($max, rightInclusive)) {
+                    yield value;
+                    // We don't mutate, because we already returned `current`
+                    // in the previous iteration
+                    value = value.plus(step, stepUnit);
+                }
+            },
+        });
     }
     get(unit) {
         return unit === 'year' ? this.$year : unit === 'month' ? this.$month : this.$day;

package/dist/decorators/logMethod.decorator.js

@@ -27,7 +27,7 @@ function _LogMethod(opt = {}) {
         let { logResultFn } = opt;
         if (!logResultFn) {
             if (logResult) {
-                logResultFn = r => ['result:', (0, __1._stringifyAny)(r)];
+                logResultFn = r => ['result:', (0, __1._stringify)(r)];
             }
             else if (logResultLength) {
                 logResultFn = r => (Array.isArray(r) ? [`result: ${r.length} items`] : []);

package/dist/error/assert.js

@@ -36,7 +36,7 @@ exports._assert = _assert;
 function _assertEquals(actual, expected, message, errorData) {
     if (actual !== expected) {
         const msg = message ||
-            ['not equal', `expected: ${(0, __1._stringifyAny)(expected)}`, `got     : ${(0, __1._stringifyAny)(actual)}`]
+            ['not equal', `expected: ${(0, __1._stringify)(expected)}`, `got     : ${(0, __1._stringify)(actual)}`]
                 .filter(Boolean)
                 .join('\n');
         throw new __1.AssertionError(msg, {
@@ -55,11 +55,7 @@ exports._assertEquals = _assertEquals;
 function _assertDeepEquals(actual, expected, message, errorData) {
     if (!(0, __1._deepEquals)(actual, expected)) {
         const msg = message ||
-            [
-                `not deeply equal`,
-                `expected: ${(0, __1._stringifyAny)(expected)}`,
-                `got     : ${(0, __1._stringifyAny)(actual)}`,
-            ]
+            [`not deeply equal`, `expected: ${(0, __1._stringify)(expected)}`, `got     : ${(0, __1._stringify)(actual)}`]
                 .filter(Boolean)
                 .join('\n');
         throw new __1.AssertionError(msg, {

package/dist/error/error.util.d.ts

@@ -12,7 +12,7 @@ export declare function _anyToError<ERROR_TYPE extends Error = Error>(o: any, er
  * Converts "anything" to ErrorObject.
  * Detects if it's HttpErrorResponse, HttpErrorObject, ErrorObject, Error, etc..
  * If object is Error - Error.message will be used.
- * Objects (not Errors) get converted to prettified JSON string (via `_stringifyAny`).
+ * Objects (not Errors) get converted to prettified JSON string (via `_stringify`).
  */
 export declare function _anyToErrorObject<DATA_TYPE extends ErrorData = ErrorData>(o: any, errorData?: Partial<DATA_TYPE>): ErrorObject<DATA_TYPE>;
 export declare function _errorLikeToErrorObject<DATA_TYPE extends ErrorData = ErrorData>(e: AppError<DATA_TYPE> | Error | ErrorLike): ErrorObject<DATA_TYPE>;

package/dist/error/error.util.js

@@ -34,7 +34,7 @@ exports._anyToError = _anyToError;
  * Converts "anything" to ErrorObject.
  * Detects if it's HttpErrorResponse, HttpErrorObject, ErrorObject, Error, etc..
  * If object is Error - Error.message will be used.
- * Objects (not Errors) get converted to prettified JSON string (via `_stringifyAny`).
+ * Objects (not Errors) get converted to prettified JSON string (via `_stringify`).
  */
 function _anyToErrorObject(o, errorData) {
     let eo;
@@ -57,7 +57,7 @@ function _anyToErrorObject(o, errorData) {
             // so, fair to return `data: {}` in the end
             // Also we're sure it includes no "error name", e.g no `Error: ...`,
             // so, fair to include `name: 'Error'`
-            const message = (0, __1._stringifyAny)(o);
+            const message = (0, __1._stringify)(o);
             eo = {
                 name: 'Error',
                 message,

package/dist/error/try.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports._expectedErrorString = exports.pExpectedErrorString = exports.pExpectedError = exports._expectedError = exports.pTry = exports._try = void 0;
-const stringifyAny_1 = require("../string/stringifyAny");
+const stringify_1 = require("../string/stringify");
 const assert_1 = require("./assert");
 const error_util_1 = require("./error.util");
 /**
@@ -101,7 +101,7 @@ exports.pExpectedError = pExpectedError;
  */
 async function pExpectedErrorString(promise, errorClass) {
     const err = await pExpectedError(promise, errorClass);
-    return (0, stringifyAny_1._stringifyAny)(err);
+    return (0, stringify_1._stringify)(err);
 }
 exports.pExpectedErrorString = pExpectedErrorString;
 /**
@@ -109,6 +109,6 @@ exports.pExpectedErrorString = pExpectedErrorString;
  */
 function _expectedErrorString(fn, errorClass) {
     const err = _expectedError(fn, errorClass);
-    return (0, stringifyAny_1._stringifyAny)(err);
+    return (0, stringify_1._stringify)(err);
 }
 exports._expectedErrorString = _expectedErrorString;

package/dist/http/fetcher.js

@@ -12,7 +12,7 @@ const object_util_1 = require("../object/object.util");
 const pDelay_1 = require("../promise/pDelay");
 const pTimeout_1 = require("../promise/pTimeout");
 const json_util_1 = require("../string/json.util");
-const stringifyAny_1 = require("../string/stringifyAny");
+const stringify_1 = require("../string/stringify");
 const time_util_1 = require("../time/time.util");
 const http_model_1 = require("./http.model");
 const acceptByResponseType = {
@@ -392,7 +392,7 @@ class Fetcher {
                 .filter(Boolean)
                 .join(' ') + '\n', 
             // We're stringifying the error here, otherwise Sentry shows it as [object Object]
-            (0, stringifyAny_1._stringifyAny)(res.err.cause || res.err));
+            (0, stringify_1._stringify)(res.err.cause || res.err));
         }
         if (retryStatus.retryStopped)
             return;

package/dist/index.d.ts

@@ -50,7 +50,7 @@ export * from './string/string.util';
 export * from './string/readingTime';
 export * from './string/escape';
 export * from './string/pupa';
-export * from './string/stringifyAny';
+export * from './string/stringify';
 export * from './time/time.util';
 export * from './is.util';
 export * from './typeFest';
@@ -60,7 +60,7 @@ export * from './log/commonLogger';
 export * from './string/safeJsonStringify';
 export * from './promise/pQueue';
 export * from './promise/abortable';
-export * from './seq/seq';
+export * from './iter/iterable2';
 export * from './math/stack.util';
 export * from './string/leven';
 export * from './datetime/localDate';

package/dist/index.js

@@ -54,7 +54,7 @@ tslib_1.__exportStar(require("./string/string.util"), exports);
 tslib_1.__exportStar(require("./string/readingTime"), exports);
 tslib_1.__exportStar(require("./string/escape"), exports);
 tslib_1.__exportStar(require("./string/pupa"), exports);
-tslib_1.__exportStar(require("./string/stringifyAny"), exports);
+tslib_1.__exportStar(require("./string/stringify"), exports);
 tslib_1.__exportStar(require("./time/time.util"), exports);
 tslib_1.__exportStar(require("./is.util"), exports);
 tslib_1.__exportStar(require("./typeFest"), exports);
@@ -64,7 +64,7 @@ tslib_1.__exportStar(require("./log/commonLogger"), exports);
 tslib_1.__exportStar(require("./string/safeJsonStringify"), exports);
 tslib_1.__exportStar(require("./promise/pQueue"), exports);
 tslib_1.__exportStar(require("./promise/abortable"), exports);
-tslib_1.__exportStar(require("./seq/seq"), exports);
+tslib_1.__exportStar(require("./iter/iterable2"), exports);
 tslib_1.__exportStar(require("./math/stack.util"), exports);
 tslib_1.__exportStar(require("./string/leven"), exports);
 tslib_1.__exportStar(require("./datetime/localDate"), exports);

package/dist/iter/iterable2.d.ts

@@ -0,0 +1,21 @@
+import { AbortableMapper, AbortablePredicate, END, Predicate } from '../types';
+/**
+ * Iterable2 is a wrapper around Iterable that implements "Iterator Helpers proposal":
+ * https://github.com/tc39/proposal-iterator-helpers
+ *
+ * Iterable2 can be removed after the proposal is widely implemented in Node & browsers.
+ *
+ * @experimental
+ */
+export declare class Iterable2<T> implements Iterable<T> {
+    private it;
+    private constructor();
+    static of<T>(it: Iterable<T>): Iterable2<T>;
+    static empty<T>(): Iterable2<T>;
+    [Symbol.iterator](): Iterator<T>;
+    toArray(): T[];
+    forEach(cb: (v: T, i: number) => any | typeof END): void;
+    find(cb: Predicate<T>): T | undefined;
+    filter(cb: AbortablePredicate<T>): Iterable2<T>;
+    map<OUT>(mapper: AbortableMapper<T, OUT>): Iterable2<OUT>;
+}

package/dist/iter/iterable2.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Iterable2 = void 0;
+const types_1 = require("../types");
+/**
+ * Iterable2 is a wrapper around Iterable that implements "Iterator Helpers proposal":
+ * https://github.com/tc39/proposal-iterator-helpers
+ *
+ * Iterable2 can be removed after the proposal is widely implemented in Node & browsers.
+ *
+ * @experimental
+ */
+class Iterable2 {
+    constructor(it) {
+        this.it = it;
+    }
+    static of(it) {
+        return new Iterable2(it);
+    }
+    static empty() {
+        return new Iterable2([]);
+    }
+    [Symbol.iterator]() {
+        return this.it[Symbol.iterator]();
+    }
+    toArray() {
+        return [...this.it];
+    }
+    forEach(cb) {
+        let i = 0;
+        for (const v of this.it) {
+            if (cb(v, i++) === types_1.END)
+                return;
+        }
+    }
+    find(cb) {
+        let i = 0;
+        for (const v of this.it) {
+            if (cb(v, i++))
+                return v;
+        }
+    }
+    filter(cb) {
+        const { it } = this;
+        return new Iterable2({
+            *[Symbol.iterator]() {
+                let i = 0;
+                for (const v of it) {
+                    const r = cb(v, i++);
+                    if (r === types_1.END)
+                        return;
+                    if (r)
+                        yield v;
+                }
+            },
+        });
+    }
+    map(mapper) {
+        const { it } = this;
+        return new Iterable2({
+            *[Symbol.iterator]() {
+                let i = 0;
+                for (const v of it) {
+                    const r = mapper(v, i++);
+                    if (r === types_1.END)
+                        return;
+                    if (r === types_1.SKIP)
+                        continue;
+                    yield r;
+                }
+            },
+        });
+    }
+}
+exports.Iterable2 = Iterable2;

package/dist/string/{stringifyAny.d.ts → stringify.d.ts}

@@ -3,18 +3,18 @@ import type { Reviver } from '../types';
  * Allows to set Global "stringifyFunction" that will be used to "pretty-print" objects
  * in various cases.
  *
- * Used, for example, by _stringifyAny() to pretty-print objects/arrays.
+ * Used, for example, by _stringify() to pretty-print objects/arrays.
  *
  * Defaults to _safeJsonStringify.
  *
- * Node.js project can set it to _inspectAny, which allows to use `util.inspect`
+ * Node.js project can set it to _inspect, which allows to use `util.inspect`
  * as pretty-printing function.
  *
  * It's recommended that this function is circular-reference-safe.
  */
 export declare function setGlobalStringifyFunction(fn: JsonStringifyFunction): void;
 export type JsonStringifyFunction = (obj: any, reviver?: Reviver, space?: number) => string;
-export interface StringifyAnyOptions {
+export interface StringifyOptions {
     /**
      * @default 10_000
      * Default limit is less than in Node, cause it's likely to be used e.g in Browser alert()
@@ -47,13 +47,13 @@ export interface StringifyAnyOptions {
     stringifyFn?: JsonStringifyFunction;
 }
 /**
- * Inspired by inspectAny from nodejs-lib, which is based on util.inpect that is not available in the Browser.
+ * Inspired by `_inspect` from nodejs-lib, which is based on util.inpect that is not available in the Browser.
  * Potentially can do this (with extra 2Kb gz size): https://github.com/deecewan/browser-util-inspect
  *
  * Transforms ANY to human-readable string (via JSON.stringify pretty).
  * Safe (no error throwing).
  *
- * Correclty prints Errors, AppErrors, ErrorObjects: error.message + \n + stringifyAny(error.data)
+ * Correctly prints Errors, AppErrors, ErrorObjects: error.message + \n + _stringify(error.data)
  *
  * Enforces max length (default to 1000, pass 0 to skip it).
  *
@@ -64,4 +64,8 @@ export interface StringifyAnyOptions {
  * Returns 'empty_string' if empty string is passed.
  * Returns 'undefined' if undefined is passed (default util.inspect behavior).
  */
-export declare function _stringifyAny(obj: any, opt?: StringifyAnyOptions): string;
+export declare function _stringify(obj: any, opt?: StringifyOptions): string;
+/**
+ * @deprecated renamed to _stringify
+ */
+export declare const _stringifyAny: typeof _stringify;

package/dist/string/{stringifyAny.js → stringify.js}

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports._stringifyAny = exports.setGlobalStringifyFunction = void 0;
+exports._stringifyAny = exports._stringify = exports.setGlobalStringifyFunction = void 0;
 const error_util_1 = require("../error/error.util");
 const json_util_1 = require("./json.util");
 const safeJsonStringify_1 = require("./safeJsonStringify");
@@ -10,11 +10,11 @@ let globalStringifyFunction = safeJsonStringify_1._safeJsonStringify;
  * Allows to set Global "stringifyFunction" that will be used to "pretty-print" objects
  * in various cases.
  *
- * Used, for example, by _stringifyAny() to pretty-print objects/arrays.
+ * Used, for example, by _stringify() to pretty-print objects/arrays.
  *
  * Defaults to _safeJsonStringify.
  *
- * Node.js project can set it to _inspectAny, which allows to use `util.inspect`
+ * Node.js project can set it to _inspect, which allows to use `util.inspect`
  * as pretty-printing function.
  *
  * It's recommended that this function is circular-reference-safe.
@@ -24,13 +24,13 @@ function setGlobalStringifyFunction(fn) {
 }
 exports.setGlobalStringifyFunction = setGlobalStringifyFunction;
 /**
- * Inspired by inspectAny from nodejs-lib, which is based on util.inpect that is not available in the Browser.
+ * Inspired by `_inspect` from nodejs-lib, which is based on util.inpect that is not available in the Browser.
  * Potentially can do this (with extra 2Kb gz size): https://github.com/deecewan/browser-util-inspect
  *
  * Transforms ANY to human-readable string (via JSON.stringify pretty).
  * Safe (no error throwing).
  *
- * Correclty prints Errors, AppErrors, ErrorObjects: error.message + \n + stringifyAny(error.data)
+ * Correctly prints Errors, AppErrors, ErrorObjects: error.message + \n + _stringify(error.data)
  *
  * Enforces max length (default to 1000, pass 0 to skip it).
  *
@@ -41,7 +41,7 @@ exports.setGlobalStringifyFunction = setGlobalStringifyFunction;
  * Returns 'empty_string' if empty string is passed.
  * Returns 'undefined' if undefined is passed (default util.inspect behavior).
  */
-function _stringifyAny(obj, opt = {}) {
+function _stringify(obj, opt = {}) {
     if (obj === undefined)
         return 'undefined';
     if (obj === null)
@@ -57,7 +57,7 @@ function _stringifyAny(obj, opt = {}) {
     // HttpErrorResponse
     //
     if ((0, error_util_1._isBackendErrorResponseObject)(obj)) {
-        return _stringifyAny(obj.error, opt);
+        return _stringify(obj.error, opt);
     }
     if (obj instanceof Error || (0, error_util_1._isErrorLike)(obj)) {
         const { includeErrorCause = true } = opt;
@@ -79,7 +79,7 @@ function _stringifyAny(obj, opt = {}) {
             s += `\ncode: ${obj.code}`;
         }
         if (opt.includeErrorData && (0, error_util_1._isErrorObject)(obj) && Object.keys(obj.data).length) {
-            s += '\n' + _stringifyAny(obj.data, opt);
+            s += '\n' + _stringify(obj.data, opt);
         }
         if (opt.includeErrorStack && obj.stack) {
             // Here we're using the previously-generated "title line" (e.g "Error: some_message"),
@@ -94,11 +94,11 @@ function _stringifyAny(obj, opt = {}) {
             s = [
                 s,
                 `${obj.errors.length} error(s):`,
-                ...obj.errors.map((err, i) => `${i + 1}. ${_stringifyAny(err, opt)}`),
+                ...obj.errors.map((err, i) => `${i + 1}. ${_stringify(err, opt)}`),
             ].join('\n');
         }
         if (obj.cause && includeErrorCause) {
-            s = s + '\nCaused by: ' + _stringifyAny(obj.cause, opt);
+            s = s + '\nCaused by: ' + _stringify(obj.cause, opt);
         }
     }
     else if (typeof obj === 'string') {
@@ -129,4 +129,8 @@ function _stringifyAny(obj, opt = {}) {
     }
     return s;
 }
-exports._stringifyAny = _stringifyAny;
+exports._stringify = _stringify;
+/**
+ * @deprecated renamed to _stringify
+ */
+exports._stringifyAny = _stringify;

package/dist/zod/zod.util.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ZodValidationError = exports.zSafeValidate = exports.zValidate = exports.zIsValid = void 0;
 const zod_1 = require("zod");
-const stringifyAny_1 = require("../string/stringifyAny");
+const stringify_1 = require("../string/stringify");
 function zIsValid(value, schema) {
     const { success } = schema.safeParse(value);
     return success;
@@ -48,7 +48,7 @@ class ZodValidationError extends zod_1.ZodError {
             `Invalid ${objectTitle}`,
             '',
             'Input:',
-            (0, stringifyAny_1._stringifyAny)(this.value),
+            (0, stringify_1._stringify)(this.value),
             this.issues.length > 1 ? `\n${this.issues.length} issues:` : '',
             ...this.issues.slice(0, 100).map(i => {
                 return [i.path.join('.'), i.message].filter(Boolean).join(': ');

package/dist-esm/array/range.js

@@ -1,7 +1,20 @@
-/* eslint-disable no-redeclare, unicorn/no-new-array */
+import { Iterable2 } from '../iter/iterable2';
 export function _range(fromIncl, toExcl, step = 1) {
     if (toExcl === undefined) {
         return Array.from(new Array(fromIncl), (_, i) => i);
     }
     return Array.from({ length: Math.ceil((toExcl - fromIncl) / step) }, (_, i) => i * step + fromIncl);
 }
+export function _rangeIt(fromIncl, toExcl, step = 1) {
+    if (toExcl === undefined) {
+        toExcl = fromIncl;
+        fromIncl = 0;
+    }
+    return Iterable2.of({
+        *[Symbol.iterator]() {
+            for (let i = fromIncl; i < toExcl; i += step) {
+                yield i;
+            }
+        },
+    });
+}

package/dist-esm/datetime/localDate.js

@@ -1,4 +1,5 @@
 import { _assert } from '../error/assert';
+import { Iterable2 } from '../iter/iterable2';
 import { LocalTime } from './localTime';
 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)$/;
@@ -101,27 +102,37 @@ export class LocalDate {
             .reduce((max, item) => (max.isSameOrAfter(item) ? max : item));
     }
     static range(min, max, incl = '[)', step = 1, stepUnit = 'day') {
+        return this.rangeIt(min, max, incl, step, stepUnit).toArray();
+    }
+    /**
+     * Experimental, returns the range as Iterable2.
+     */
+    static rangeIt(min, max, incl = '[)', step = 1, stepUnit = 'day') {
         if (stepUnit === 'week') {
             step *= 7;
             stepUnit = 'day';
         }
-        const dates = [];
-        const $min = LocalDate.of(min);
+        const $min = LocalDate.of(min).startOf(stepUnit);
         const $max = LocalDate.of(max).startOf(stepUnit);
-        let current = $min.startOf(stepUnit);
+        let value = $min;
         // eslint-disable-next-line @typescript-eslint/prefer-string-starts-ends-with
-        if (current.isAfter($min, incl[0] === '[')) {
+        if (value.isAfter($min, incl[0] === '[')) {
             // ok
         }
         else {
-            current.plus(1, stepUnit, true);
+            value.plus(1, stepUnit, true);
         }
-        const incl2 = incl[1] === ']';
-        while (current.isBefore($max, incl2)) {
-            dates.push(current);
-            current = current.plus(step, stepUnit);
-        }
-        return dates;
+        const rightInclusive = incl[1] === ']';
+        return Iterable2.of({
+            *[Symbol.iterator]() {
+                while (value.isBefore($max, rightInclusive)) {
+                    yield value;
+                    // We don't mutate, because we already returned `current`
+                    // in the previous iteration
+                    value = value.plus(step, stepUnit);
+                }
+            },
+        });
     }
     get(unit) {
         return unit === 'year' ? this.$year : unit === 'month' ? this.$month : this.$day;

package/dist-esm/decorators/logMethod.decorator.js

@@ -1,4 +1,4 @@
-import { SimpleMovingAverage, _stringifyAny, _assert } from '..';
+import { SimpleMovingAverage, _stringify, _assert } from '..';
 import { _ms } from '../time/time.util';
 import { _getArgsSignature, _getMethodSignature } from './decorator.util';
 /**
@@ -24,7 +24,7 @@ export function _LogMethod(opt = {}) {
         let { logResultFn } = opt;
         if (!logResultFn) {
             if (logResult) {
-                logResultFn = r => ['result:', _stringifyAny(r)];
+                logResultFn = r => ['result:', _stringify(r)];
             }
             else if (logResultLength) {
                 logResultFn = r => (Array.isArray(r) ? [`result: ${r.length} items`] : []);

package/dist-esm/error/assert.js

@@ -1,4 +1,4 @@
-import { _deepEquals, _isErrorObject, _stringifyAny, AssertionError } from '..';
+import { _deepEquals, _isErrorObject, _stringify, AssertionError } from '..';
 /**
  * Evaluates the `condition` (casts it to Boolean).
  * Expects it to be truthy, otherwise throws AppError.
@@ -29,7 +29,7 @@ message, errorData) {
 export function _assertEquals(actual, expected, message, errorData) {
     if (actual !== expected) {
         const msg = message ||
-            ['not equal', `expected: ${_stringifyAny(expected)}`, `got     : ${_stringifyAny(actual)}`]
+            ['not equal', `expected: ${_stringify(expected)}`, `got     : ${_stringify(actual)}`]
                 .filter(Boolean)
                 .join('\n');
         throw new AssertionError(msg, Object.assign({ userFriendly: true }, errorData));
@@ -44,11 +44,7 @@ export function _assertEquals(actual, expected, message, errorData) {
 export function _assertDeepEquals(actual, expected, message, errorData) {
     if (!_deepEquals(actual, expected)) {
         const msg = message ||
-            [
-                `not deeply equal`,
-                `expected: ${_stringifyAny(expected)}`,
-                `got     : ${_stringifyAny(actual)}`,
-            ]
+            [`not deeply equal`, `expected: ${_stringify(expected)}`, `got     : ${_stringify(actual)}`]
                 .filter(Boolean)
                 .join('\n');
         throw new AssertionError(msg, Object.assign({ userFriendly: true }, errorData));