@naturalcycles/js-lib 14.98.1 → 14.99.0

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

@@ -137,7 +137,16 @@ export declare function _mapToObject<T, V>(array: T[], mapper: (item: T) => [key
  * Based on: https://stackoverflow.com/a/12646864/4919972
  */
 export declare function _shuffle<T>(array: T[], mutate?: boolean): T[];
+/**
+ * Returns last item of non-empty array.
+ * Throws if array is empty.
+ */
+export declare function _last<T>(array: T[]): T;
 /**
  * Returns last item of the array (or undefined if array is empty).
  */
-export declare function _last<T>(array: T[]): T | undefined;
+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;

package/dist/array/array.util.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-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;
+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;
 /**
  * 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.
@@ -260,9 +260,43 @@ function _shuffle(array, mutate = false) {
 }
 exports._shuffle = _shuffle;
 /**
- * Returns last item of the array (or undefined if array is empty).
+ * Returns last item of non-empty array.
+ * Throws if array is empty.
  */
 function _last(array) {
+    if (!array.length)
+        throw new Error('_last called on empty array');
     return array[array.length - 1];
 }
 exports._last = _last;
+/**
+ * Returns last item of the array (or undefined if array is empty).
+ */
+function _lastOrUndefined(array) {
+    return array[array.length - 1];
+}
+exports._lastOrUndefined = _lastOrUndefined;
+function _minOrUndefined(array) {
+    if (!array.length)
+        return;
+    return _min(array);
+}
+exports._minOrUndefined = _minOrUndefined;
+function _min(array) {
+    if (!array.length)
+        throw new Error('_min called on empty array');
+    return array.reduce((min, item) => (min <= item ? min : item));
+}
+exports._min = _min;
+function _maxOrUndefined(array) {
+    if (!array.length)
+        return;
+    return _max(array);
+}
+exports._maxOrUndefined = _maxOrUndefined;
+function _max(array) {
+    if (!array.length)
+        throw new Error('_max called on empty array');
+    return array.reduce((max, item) => (max >= item ? max : item));
+}
+exports._max = _max;

package/dist/datetime/localDate.d.ts

@@ -1,8 +1,10 @@
-import { IsoDateString, UnixTimestampNumber } from '../types';
+import { IsoDateString, IsoDateTimeString, UnixTimestampNumber } from '../types';
 import { LocalTime } from './localTime';
-export declare type LocalDateUnit = 'year' | 'month' | 'day';
+export declare type LocalDateUnit = LocalDateUnitStrict | 'week';
+export declare type LocalDateUnitStrict = 'year' | 'month' | 'day';
 export declare type Inclusiveness = '()' | '[]' | '[)' | '(]';
 export declare type LocalDateConfig = LocalDate | IsoDateString;
+export declare type LocalDateFormatter = (ld: LocalDate) => string;
 /**
  * @experimental
  */
@@ -28,13 +30,13 @@ export declare class LocalDate {
     static today(): LocalDate;
     static todayUTC(): LocalDate;
     static sort(items: LocalDate[], mutate?: boolean, descending?: boolean): LocalDate[];
-    static earliestOrUndefined(items: LocalDate[]): LocalDate | undefined;
-    static earliest(items: LocalDate[]): LocalDate;
-    static latestOrUndefined(items: LocalDate[]): LocalDate | undefined;
-    static latest(items: LocalDate[]): LocalDate;
+    static earliestOrUndefined(items: LocalDateConfig[]): LocalDate | undefined;
+    static earliest(items: LocalDateConfig[]): LocalDate;
+    static latestOrUndefined(items: LocalDateConfig[]): LocalDate | undefined;
+    static latest(items: LocalDateConfig[]): LocalDate;
     static range(min: LocalDateConfig, max: LocalDateConfig, incl?: Inclusiveness, step?: number, stepUnit?: LocalDateUnit): LocalDate[];
-    get(unit: LocalDateUnit): number;
-    set(unit: LocalDateUnit, v: number, mutate?: boolean): LocalDate;
+    get(unit: LocalDateUnitStrict): number;
+    set(unit: LocalDateUnitStrict, v: number, mutate?: boolean): LocalDate;
     year(): number;
     year(v: number): LocalDate;
     month(): number;
@@ -65,8 +67,8 @@ export declare class LocalDate {
     diff(d: LocalDateConfig, unit: LocalDateUnit): number;
     add(num: number, unit: LocalDateUnit, mutate?: boolean): LocalDate;
     subtract(num: number, unit: LocalDateUnit, mutate?: boolean): LocalDate;
-    startOf(unit: LocalDateUnit): LocalDate;
-    endOf(unit: LocalDateUnit): LocalDate;
+    startOf(unit: LocalDateUnitStrict): LocalDate;
+    endOf(unit: LocalDateUnitStrict): LocalDate;
     static getYearLength(year: number): number;
     static getMonthLength(year: number, month: number): number;
     static isLeapYear(year: number): boolean;
@@ -80,11 +82,16 @@ export declare class LocalDate {
     toDate(): Date;
     toLocalTime(): LocalTime;
     toISODate(): IsoDateString;
+    /**
+     * Returns e.g: `1984-06-21T17:56:21`
+     */
+    toISODateTime(): IsoDateTimeString;
     toString(): IsoDateString;
     toStringCompact(): string;
     unix(): UnixTimestampNumber;
     unixMillis(): number;
     toJSON(): IsoDateString;
+    format(fmt: LocalDateFormatter): string;
 }
 /**
  * Shortcut wrapper around `LocalDate.parse` / `LocalDate.today`

package/dist/datetime/localDate.js

@@ -90,16 +90,24 @@ class LocalDate {
     }
     static earliest(items) {
         (0, assert_1._assert)(items.length, 'LocalDate.earliest called on empty array');
-        return items.reduce((min, item) => (min.isSameOrBefore(item) ? min : item));
+        return items
+            .map(i => LocalDate.of(i))
+            .reduce((min, item) => (min.isSameOrBefore(item) ? min : item));
     }
     static latestOrUndefined(items) {
         return items.length ? LocalDate.latest(items) : undefined;
     }
     static latest(items) {
         (0, assert_1._assert)(items.length, 'LocalDate.latest called on empty array');
-        return items.reduce((max, item) => (max.isSameOrAfter(item) ? max : item));
+        return items
+            .map(i => LocalDate.of(i))
+            .reduce((max, item) => (max.isSameOrAfter(item) ? max : item));
     }
     static range(min, max, incl = '[)', step = 1, stepUnit = 'day') {
+        if (stepUnit === 'week') {
+            step *= 7;
+            stepUnit = 'day';
+        }
         const dates = [];
         const $min = LocalDate.of(min);
         const $max = LocalDate.of(max).startOf(stepUnit);
@@ -209,7 +217,7 @@ class LocalDate {
         if (unit === 'month') {
             return (this.$year - d.$year) * 12 + (this.$month - d.$month);
         }
-        // unit is 'day'
+        // unit is 'day' or 'week'
         let days = this.$day - d.$day;
         if (d.$year < this.$year) {
             for (let year = d.$year; year < this.$year; year++) {
@@ -231,10 +239,17 @@ class LocalDate {
                 days -= LocalDate.getMonthLength(d.$year, month);
             }
         }
+        if (unit === 'week') {
+            return Math.floor(days / 7);
+        }
         return days;
     }
     add(num, unit, mutate = false) {
         let { $day, $month, $year } = this;
+        if (unit === 'week') {
+            num *= 7;
+            unit = 'day';
+        }
         if (unit === 'day') {
             $day += num;
         }
@@ -334,6 +349,12 @@ class LocalDate {
     toISODate() {
         return this.toString();
     }
+    /**
+     * Returns e.g: `1984-06-21T17:56:21`
+     */
+    toISODateTime() {
+        return this.toString() + 'T00:00:00';
+    }
     toString() {
         return [
             String(this.$year).padStart(4, '0'),
@@ -358,6 +379,9 @@ class LocalDate {
     toJSON() {
         return this.toString();
     }
+    format(fmt) {
+        return fmt(this);
+    }
 }
 exports.LocalDate = LocalDate;
 /**

package/dist/datetime/localTime.d.ts

@@ -1,7 +1,17 @@
 import { IsoDateString, IsoDateTimeString, UnixTimestampNumber } from '../types';
 import { Inclusiveness, LocalDate } from './localDate';
-export declare type LocalTimeUnit = 'year' | 'month' | 'day' | 'hour' | 'minute' | 'second';
+export declare type LocalTimeUnit = 'year' | 'month' | 'week' | 'day' | 'hour' | 'minute' | 'second';
+export declare enum ISODayOfWeek {
+    MONDAY = 1,
+    TUESDAY = 2,
+    WEDNESDAY = 3,
+    THURSDAY = 4,
+    FRIDAY = 5,
+    SATURDAY = 6,
+    SUNDAY = 7
+}
 export declare type LocalTimeConfig = LocalTime | Date | IsoDateTimeString | UnixTimestampNumber;
+export declare type LocalTimeFormatter = (ld: LocalTime) => string;
 export interface LocalTimeComponents {
     year: number;
     month: number;
@@ -42,8 +52,15 @@ export declare class LocalTime {
     year(v: number): LocalTime;
     month(): number;
     month(v: number): LocalTime;
+    week(): number;
+    week(v: number): LocalTime;
     day(): number;
     day(v: number): LocalTime;
+    /**
+     * Based on ISO: 1-7 is Mon-Sun.
+     */
+    dayOfWeek(): ISODayOfWeek;
+    dayOfWeek(v: ISODayOfWeek): LocalTime;
     hour(): number;
     hour(v: number): LocalTime;
     minute(): number;
@@ -56,11 +73,12 @@ export declare class LocalTime {
     absDiff(other: LocalTimeConfig, unit: LocalTimeUnit): number;
     diff(other: LocalTimeConfig, unit: LocalTimeUnit): number;
     startOf(unit: LocalTimeUnit, mutate?: boolean): LocalTime;
+    endOf(unit: LocalTimeUnit, mutate?: boolean): LocalTime;
     static sort(items: LocalTime[], mutate?: boolean, descending?: boolean): LocalTime[];
-    static earliestOrUndefined(items: LocalTime[]): LocalTime | undefined;
-    static earliest(items: LocalTime[]): LocalTime;
-    static latestOrUndefined(items: LocalTime[]): LocalTime | undefined;
-    static latest(items: LocalTime[]): LocalTime;
+    static earliestOrUndefined(items: LocalTimeConfig[]): LocalTime | undefined;
+    static earliest(items: LocalTimeConfig[]): LocalTime;
+    static latestOrUndefined(items: LocalTimeConfig[]): LocalTime | undefined;
+    static latest(items: LocalTimeConfig[]): LocalTime;
     isSame(d: LocalTimeConfig): boolean;
     isBefore(d: LocalTimeConfig, inclusive?: boolean): boolean;
     isSameOrBefore(d: LocalTimeConfig): boolean;
@@ -83,7 +101,7 @@ export declare class LocalTime {
     toLocalDate(): LocalDate;
     toPretty(seconds?: boolean): IsoDateTimeString;
     /**
-     * Returns e.g: `1984-06-21T17:56:21`, only the date part of DateTime
+     * Returns e.g: `1984-06-21T17:56:21`
      */
     toISODateTime(): IsoDateTimeString;
     /**
@@ -100,6 +118,7 @@ export declare class LocalTime {
     toStringCompact(seconds?: boolean): string;
     toString(): string;
     toJSON(): UnixTimestampNumber;
+    format(fmt: LocalTimeFormatter): string;
 }
 /**
  * Shortcut wrapper around `LocalDate.parse` / `LocalDate.today`

package/dist/datetime/localTime.js

@@ -1,9 +1,24 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.localTime = exports.LocalTime = void 0;
+exports.localTime = exports.LocalTime = exports.ISODayOfWeek = void 0;
 const assert_1 = require("../error/assert");
 const time_util_1 = require("../time/time.util");
 const localDate_1 = require("./localDate");
+var ISODayOfWeek;
+(function (ISODayOfWeek) {
+    ISODayOfWeek[ISODayOfWeek["MONDAY"] = 1] = "MONDAY";
+    ISODayOfWeek[ISODayOfWeek["TUESDAY"] = 2] = "TUESDAY";
+    ISODayOfWeek[ISODayOfWeek["WEDNESDAY"] = 3] = "WEDNESDAY";
+    ISODayOfWeek[ISODayOfWeek["THURSDAY"] = 4] = "THURSDAY";
+    ISODayOfWeek[ISODayOfWeek["FRIDAY"] = 5] = "FRIDAY";
+    ISODayOfWeek[ISODayOfWeek["SATURDAY"] = 6] = "SATURDAY";
+    ISODayOfWeek[ISODayOfWeek["SUNDAY"] = 7] = "SUNDAY";
+})(ISODayOfWeek = exports.ISODayOfWeek || (exports.ISODayOfWeek = {}));
+const weekStartsOn = 1; // mon, as per ISO
+const MILLISECONDS_IN_WEEK = 604800000;
+// const MILLISECONDS_IN_DAY = 86400000
+// const MILLISECONDS_IN_MINUTE = 60000
+const VALID_DAYS_OF_WEEK = new Set([1, 2, 3, 4, 5, 6, 7]);
 /* eslint-disable no-dupe-class-members */
 /**
  * @experimental
@@ -107,6 +122,9 @@ class LocalTime {
         if (unit === 'minute') {
             return this.utcMode ? this.$date.getUTCMinutes() : this.$date.getMinutes();
         }
+        if (unit === 'week') {
+            return getWeek(this.$date);
+        }
         // second
         return this.utcMode ? this.$date.getUTCSeconds() : this.$date.getSeconds();
     }
@@ -131,6 +149,9 @@ class LocalTime {
         else if (unit === 'second') {
             this.utcMode ? t.$date.setUTCSeconds(v) : t.$date.setSeconds(v);
         }
+        else if (unit === 'week') {
+            setWeek(t.$date, v, true);
+        }
         /* eslint-enable @typescript-eslint/no-unused-expressions */
         return t;
     }
@@ -140,9 +161,21 @@ class LocalTime {
     month(v) {
         return v === undefined ? this.get('month') : this.set('month', v);
     }
+    week(v) {
+        return v === undefined ? getWeek(this.$date) : this.set('week', v);
+    }
     day(v) {
         return v === undefined ? this.get('day') : this.set('day', v);
     }
+    dayOfWeek(v) {
+        const dow = (this.$date.getDay() || 7);
+        if (v === undefined) {
+            return dow;
+        }
+        if (!VALID_DAYS_OF_WEEK.has(v))
+            throw new Error(`Invalid dayOfWeek: ${v}`);
+        return this.add(v - dow, 'day');
+    }
     hour(v) {
         return v === undefined ? this.get('hour') : this.set('hour', v);
     }
@@ -177,6 +210,10 @@ class LocalTime {
         return mutate ? this : new LocalTime(d, this.utcMode);
     }
     add(num, unit, mutate = false) {
+        if (unit === 'week') {
+            num *= 7;
+            unit = 'day';
+        }
         return this.set(unit, this.get(unit) + num, mutate);
     }
     subtract(num, unit, mutate = false) {
@@ -200,6 +237,9 @@ class LocalTime {
         if (unit === 'day') {
             r = secDiff / (24 * 60 * 60);
         }
+        else if (unit === 'week') {
+            r = secDiff / (7 * 24 * 60 * 60);
+        }
         else if (unit === 'hour') {
             r = secDiff / (60 * 60);
         }
@@ -210,7 +250,7 @@ class LocalTime {
             // unit === 'second'
             r = secDiff;
         }
-        r = r < 0 ? -Math.floor(-r) : Math.floor(r);
+        r = Math.trunc(r);
         if (Object.is(r, -0))
             return 0;
         return r;
@@ -219,16 +259,53 @@ class LocalTime {
         if (unit === 'second')
             return this;
         const d = mutate ? this.$date : new Date(this.$date);
+        d.setSeconds(0, 0);
         /* eslint-disable @typescript-eslint/no-unused-expressions */
-        this.utcMode ? d.setUTCSeconds(0) : d.setSeconds(0);
         if (unit !== 'minute') {
             this.utcMode ? d.setUTCMinutes(0) : d.setMinutes(0);
             if (unit !== 'hour') {
                 this.utcMode ? d.setUTCHours(0) : d.setHours(0);
                 if (unit !== 'day') {
-                    this.utcMode ? d.setUTCDate(0) : d.setDate(0);
-                    if (unit !== 'month') {
+                    // year, month or week
+                    if (unit === 'year') {
                         this.utcMode ? d.setUTCMonth(0) : d.setMonth(0);
+                        this.utcMode ? d.setUTCDate(1) : d.setDate(1);
+                    }
+                    else if (unit === 'month') {
+                        this.utcMode ? d.setUTCDate(1) : d.setDate(1);
+                    }
+                    else {
+                        // week
+                        startOfWeek(d, true);
+                    }
+                }
+            }
+        }
+        /* eslint-enable @typescript-eslint/no-unused-expressions */
+        return mutate ? this : new LocalTime(d, this.utcMode);
+    }
+    endOf(unit, mutate = false) {
+        if (unit === 'second')
+            return this;
+        const d = mutate ? this.$date : new Date(this.$date);
+        d.setSeconds(59, 0);
+        /* eslint-disable @typescript-eslint/no-unused-expressions */
+        if (unit !== 'minute') {
+            this.utcMode ? d.setUTCMinutes(59) : d.setMinutes(59);
+            if (unit !== 'hour') {
+                this.utcMode ? d.setUTCHours(23) : d.setHours(23);
+                if (unit !== 'day') {
+                    // year, month or week
+                    if (unit === 'year') {
+                        this.utcMode ? d.setUTCMonth(11) : d.setMonth(11);
+                    }
+                    if (unit === 'week') {
+                        endOfWeek(d, true);
+                    }
+                    else {
+                        // year or month
+                        const lastDay = localDate_1.LocalDate.getMonthLength(d.getFullYear(), d.getMonth() + 1);
+                        this.utcMode ? d.setUTCDate(lastDay) : d.setDate(lastDay);
                     }
                 }
             }
@@ -251,14 +328,18 @@ class LocalTime {
     }
     static earliest(items) {
         (0, assert_1._assert)(items.length, 'LocalTime.earliest called on empty array');
-        return items.reduce((min, item) => (min.isSameOrBefore(item) ? min : item));
+        return items
+            .map(i => LocalTime.of(i))
+            .reduce((min, item) => (min.isSameOrBefore(item) ? min : item));
     }
     static latestOrUndefined(items) {
         return items.length ? LocalTime.latest(items) : undefined;
     }
     static latest(items) {
         (0, assert_1._assert)(items.length, 'LocalTime.latest called on empty array');
-        return items.reduce((max, item) => (max.isSameOrAfter(item) ? max : item));
+        return items
+            .map(i => LocalTime.of(i))
+            .reduce((max, item) => (max.isSameOrAfter(item) ? max : item));
     }
     isSame(d) {
         return this.cmp(d) === 0;
@@ -298,7 +379,6 @@ class LocalTime {
             return 0;
         return t1 < t2 ? -1 : 1;
     }
-    // todo: endOf
     components() {
         if (this.utcMode) {
             return {
@@ -371,7 +451,7 @@ class LocalTime {
         //   .join(' ')
     }
     /**
-     * Returns e.g: `1984-06-21T17:56:21`, only the date part of DateTime
+     * Returns e.g: `1984-06-21T17:56:21`
      */
     toISODateTime() {
         return this.$date.toISOString().slice(0, 19);
@@ -423,6 +503,9 @@ class LocalTime {
     toJSON() {
         return this.unix();
     }
+    format(fmt) {
+        return fmt(this);
+    }
 }
 exports.LocalTime = LocalTime;
 /**
@@ -432,3 +515,83 @@ function localTime(d) {
     return d ? LocalTime.of(d) : LocalTime.now();
 }
 exports.localTime = localTime;
+// based on: https://github.com/date-fns/date-fns/blob/master/src/getISOWeek/index.ts
+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);
+    const diff = getWeek(d) - week;
+    d.setDate(d.getDate() - diff * 7);
+    return d;
+}
+// based on: https://github.com/date-fns/date-fns/blob/master/src/startOfISOWeekYear/index.ts
+function startOfWeekYear(date) {
+    const year = getWeekYear(date);
+    const fourthOfJanuary = new Date(0);
+    fourthOfJanuary.setFullYear(year, 0, 4);
+    fourthOfJanuary.setHours(0, 0, 0, 0);
+    return startOfWeek(fourthOfJanuary, true);
+}
+// based on: https://github.com/date-fns/date-fns/blob/fd6bb1a0bab143f2da068c05a9c562b9bee1357d/src/getISOWeekYear/index.ts
+function getWeekYear(date) {
+    const year = date.getFullYear();
+    const fourthOfJanuaryOfNextYear = new Date(0);
+    fourthOfJanuaryOfNextYear.setFullYear(year + 1, 0, 4);
+    fourthOfJanuaryOfNextYear.setHours(0, 0, 0, 0);
+    const startOfNextYear = startOfWeek(fourthOfJanuaryOfNextYear, true);
+    const fourthOfJanuaryOfThisYear = new Date(0);
+    fourthOfJanuaryOfThisYear.setFullYear(year, 0, 4);
+    fourthOfJanuaryOfThisYear.setHours(0, 0, 0, 0);
+    const startOfThisYear = startOfWeek(fourthOfJanuaryOfThisYear, true);
+    if (date.getTime() >= startOfNextYear.getTime()) {
+        return year + 1;
+    }
+    else if (date.getTime() >= startOfThisYear.getTime()) {
+        return year;
+    }
+    else {
+        return year - 1;
+    }
+}
+// function setWeekYear(
+//   date: Date,
+//   year: number,
+// ): Date {
+//   const diff = differenceInCalendarDays(date, startOfWeekYear(date))
+//   const fourthOfJanuary = new Date(0)
+//   fourthOfJanuary.setFullYear(year, 0, 4)
+//   fourthOfJanuary.setHours(0, 0, 0, 0)
+//   date = startOfWeekYear(fourthOfJanuary)
+//   date.setDate(date.getDate() + diff)
+//   return date
+// }
+// function differenceInCalendarDays(
+//   dateLeft: Date,
+//   dateRight: Date,
+// ): number {
+//   return Math.round((startOfDay(dateLeft).getTime() - startOfDay(dateRight).getTime()) / MILLISECONDS_IN_DAY)
+// }
+// function startOfDay(date: Date, mutate = false): Date {
+//   const d = mutate ? date : new Date(date)
+//   d.setHours(0, 0, 0, 0)
+//   return d
+// }
+// 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);
+    const day = d.getDay();
+    const diff = (day < weekStartsOn ? 7 : 0) + day - weekStartsOn;
+    d.setDate(d.getDate() - diff);
+    d.setHours(0, 0, 0, 0);
+    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);
+    const day = d.getDay();
+    const diff = (day < weekStartsOn ? -7 : 0) + 6 - (day - weekStartsOn);
+    d.setDate(d.getDate() + diff);
+    return d;
+}

package/dist/index.d.ts

@@ -51,7 +51,7 @@ export * from './string/string.util';
 import { JsonStringifyFunction, StringifyAnyOptions, _stringifyAny } from './string/stringifyAny';
 export * from './time/time.util';
 import { Class, ConditionalExcept, ConditionalPick, Merge, Promisable, ReadonlyDeep, Simplify } from './typeFest';
-import { AsyncMapper, AsyncPredicate, BaseDBEntity, CreatedUpdated, CreatedUpdatedId, ObjectWithId, AnyObjectWithId, Saved, Unsaved, BatchResult, InstanceId, IsoDate, IsoDateString, IsoDateTimeString, KeyValueTuple, Mapper, ObjectMapper, ObjectPredicate, Predicate, PromiseMap, AnyObject, AnyFunction, Reviver, SavedDBEntity, StringMap, UnixTimestampNumber, 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, UnixTimestamp, Integer, ValueOf, ValuesOf, AbortableMapper, AbortableAsyncPredicate, AbortableAsyncMapper, AbortablePredicate, 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';
@@ -64,9 +64,9 @@ export * from './datetime/localDate';
 export * from './datetime/localTime';
 export * from './datetime/dateInterval';
 export * from './datetime/timeInterval';
-import { LocalDateConfig, LocalDateUnit, Inclusiveness } from './datetime/localDate';
-import { LocalTimeConfig, LocalTimeUnit, LocalTimeComponents } from './datetime/localTime';
+import { LocalDateConfig, LocalDateFormatter, LocalDateUnit, LocalDateUnitStrict, Inclusiveness } from './datetime/localDate';
+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, LocalDateUnit, Inclusiveness, LocalTimeConfig, LocalTimeUnit, 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, UnixTimestamp, Integer, BaseDBEntity, SavedDBEntity, Saved, Unsaved, 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, PMapOptions, Mapper, AsyncMapper, Predicate, AsyncPredicate, BatchResult, DeferredPromise, PRetryOptions, PTimeoutOptions, TryCatchOptions, StringifyAnyOptions, JsonStringifyFunction, Merge, ReadonlyDeep, Promisable, Simplify, ConditionalPick, ConditionalExcept, Class, UnixTimestampNumber, 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

@@ -96,3 +96,4 @@ tslib_1.__exportStar(require("./datetime/localDate"), exports);
 tslib_1.__exportStar(require("./datetime/localTime"), exports);
 tslib_1.__exportStar(require("./datetime/dateInterval"), exports);
 tslib_1.__exportStar(require("./datetime/timeInterval"), exports);
+const localTime_1 = require("./datetime/localTime");

package/dist/types.d.ts

@@ -1,4 +1,4 @@
-import { Merge, Promisable } from './typeFest';
+import { Except, Merge, Promisable } from './typeFest';
 /**
  * Map from String to String (or <T>).
  *
@@ -54,7 +54,10 @@ export interface SavedDBEntity<ID extends string | number = string> {
  */
 export declare type BaseDBEntity<ID extends string | number = string> = Partial<SavedDBEntity<ID>>;
 export declare type Saved<T extends Partial<ObjectWithId>> = Merge<T, SavedDBEntity<Exclude<T['id'], undefined>>>;
-export declare type Unsaved<T extends ObjectWithId> = Merge<T, BaseDBEntity<T['id']>>;
+export declare type Unsaved<T extends Partial<ObjectWithId>> = Merge<T, BaseDBEntity<Exclude<T['id'], undefined>>>;
+export declare type UnsavedId<T extends Partial<ObjectWithId>> = Except<T, 'id'> & {
+    id: Exclude<T['id'], undefined>;
+};
 /**
  * Convenience type shorthand.
  * Because `Function` type is discouraged by eslint.

package/dist/vendor/is.d.ts

@@ -1,4 +1,6 @@
 /// <reference types="node" />
+/// <reference types="node" />
+/// <reference types="node" />
 /// <reference lib="es2018" />
 /// <reference lib="dom" />
 import { Class, ObservableLike, Primitive, TypedArray } from '../typeFest';

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

@@ -237,8 +237,37 @@ export function _shuffle(array, mutate = false) {
     return a;
 }
 /**
- * Returns last item of the array (or undefined if array is empty).
+ * Returns last item of non-empty array.
+ * Throws if array is empty.
  */
 export function _last(array) {
+    if (!array.length)
+        throw new Error('_last called on empty array');
+    return array[array.length - 1];
+}
+/**
+ * Returns last item of the array (or undefined if array is empty).
+ */
+export function _lastOrUndefined(array) {
     return array[array.length - 1];
 }
+export function _minOrUndefined(array) {
+    if (!array.length)
+        return;
+    return _min(array);
+}
+export function _min(array) {
+    if (!array.length)
+        throw new Error('_min called on empty array');
+    return array.reduce((min, item) => (min <= item ? min : item));
+}
+export function _maxOrUndefined(array) {
+    if (!array.length)
+        return;
+    return _max(array);
+}
+export function _max(array) {
+    if (!array.length)
+        throw new Error('_max called on empty array');
+    return array.reduce((max, item) => (max >= item ? max : item));
+}