@taiga-ui/cdk 3.49.1 → 3.491.1-canary.5e01f6f

package/fesm2015/taiga-ui-cdk-date-time.js

@@ -33,56 +33,26 @@ const MILLISECONDS_IN_MINUTE = MILLISECONDS_IN_SECOND * SECONDS_IN_MINUTE;
 const MILLISECONDS_IN_HOUR = MILLISECONDS_IN_MINUTE * MINUTES_IN_HOUR;
 const MILLISECONDS_IN_DAY = MILLISECONDS_IN_HOUR * HOURS_IN_DAY;
 
-/**
- * @internal 'dd.mm.yyyy'.length
- * Used in:
- * - {@link TuiInputDateComponent}
- * - {@link TuiInputDateRangeComponent}
- * - {@link TuiInputDateTimeComponent}
- */
 const DATE_FILLER_LENGTH = 10;
-/**
- * @internal
- * Used in {@link TuiInputDateRangeComponent}
- */
 const DATE_RANGE_FILLER_LENGTH = 2 * DATE_FILLER_LENGTH + RANGE_SEPARATOR_CHAR.length;
 
-/**
- * Active date format for Taiga UI
- */
 const TUI_DATE_FORMAT = tuiCreateToken(`DMY`);
 
-/**
- * Date separator for Taiga UI components
- */
 const TUI_DATE_SEPARATOR = tuiCreateToken(`.`);
 const changeDateSeparator = (dateString, newDateSeparator) => dateString.replace(/[^0-9A-Za-zА-Яа-я]/gi, newDateSeparator);
 
-/**
- * Immutable year object
- * @nosideeffects
- */
 class TuiYear {
     constructor(year) {
         this.year = year;
         ngDevMode && tuiAssert.assert(TuiYear.isValidYear(year));
     }
-    /**
-     * Checks year for validity
-     */
     static isValidYear(year) {
         return Number.isInteger(year) && tuiInRange(year, MIN_YEAR, MAX_YEAR + 1);
     }
-    /**
-     * Check if passed year is a leap year
-     */
     static isLeapYear(year) {
         ngDevMode && tuiAssert.assert(TuiYear.isValidYear(year));
         return year % 400 === 0 || (year % 4 === 0 && year % 100 !== 0);
     }
-    /**
-     * Returns amount of leap years from year 0 to the passed one
-     */
     static getAbsoluteLeapYears(year) {
         ngDevMode && tuiAssert.assert(TuiYear.isValidYear(year));
         return Math.ceil(year / 400) + (Math.ceil(year / 4) - Math.ceil(year / 100));
@@ -90,9 +60,6 @@ class TuiYear {
     static lengthBetween(from, to) {
         return to.year - from.year;
     }
-    /**
-     * Normalizes year by clamping it between min and max years
-     */
     static normalizeYearPart(year) {
         return tuiNormalizeToIntNumber(year, MIN_YEAR, MAX_YEAR);
     }
@@ -102,45 +69,24 @@ class TuiYear {
     get isLeapYear() {
         return TuiYear.isLeapYear(this.year);
     }
-    /**
-     * Returns amount of leap years from year 0 to current
-     */
     get absoluteLeapYears() {
         return TuiYear.getAbsoluteLeapYears(this.year);
     }
-    /**
-     * Passed year is after current
-     */
     yearBefore({ year }) {
         return this.year < year;
     }
-    /**
-     * Passed year is the same or after current
-     */
     yearSameOrBefore({ year }) {
         return this.year <= year;
     }
-    /**
-     * Passed year is the same as current
-     */
     yearSame({ year }) {
         return this.year === year;
     }
-    /**
-     * Passed year is either the same of before the current
-     */
     yearSameOrAfter({ year }) {
         return this.year >= year;
     }
-    /**
-     * Passed year is before current
-     */
     yearAfter({ year }) {
         return this.year > year;
     }
-    /**
-     * Immutably offsets year
-     */
     append({ year = 0 }) {
         ngDevMode && tuiAssert.assert(Number.isInteger(year));
         const resultYear = this.year + year;
@@ -153,11 +99,6 @@ class TuiYear {
     valueOf() {
         return this.year;
     }
-    /**
-     * Returns the primitive value of the given Date object.
-     * Depending on the argument, the method can return either a string or a number.
-     * @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/@@toPrimitive
-     */
     [Symbol.toPrimitive](hint) {
         return Date.prototype[Symbol.toPrimitive].call(this, hint);
     }
@@ -166,28 +107,15 @@ class TuiYear {
     }
 }
 
-/**
- * Immutable object consisting of year and month
- */
 class TuiMonth extends TuiYear {
-    /**
-     * @param year
-     * @param month (starting with 0)
-     */
     constructor(year, month) {
         super(year);
         this.month = month;
         ngDevMode && tuiAssert.assert(TuiMonth.isValidMonth(year, month));
     }
-    /**
-     * Tests month and year for validity
-     */
     static isValidMonth(year, month) {
         return TuiYear.isValidYear(year) && TuiMonth.isValidMonthPart(month);
     }
-    /**
-     * Returns number of days in a month
-     */
     static getMonthDaysCount(month, isLeapYear) {
         ngDevMode && tuiAssert.assert(TuiMonth.isValidMonthPart(month));
         switch (month) {
@@ -202,17 +130,10 @@ class TuiMonth extends TuiYear {
                 return 31;
         }
     }
-    /**
-     * Returns current month and year based on local time zone
-     * @nosideeffects
-     */
     static currentLocal() {
         const nativeDate = new Date();
         return new TuiMonth(nativeDate.getFullYear(), nativeDate.getMonth());
     }
-    /**
-     * Returns current month and year based on UTC
-     */
     static currentUtc() {
         const nativeDate = new Date();
         return new TuiMonth(nativeDate.getUTCFullYear(), nativeDate.getUTCMonth());
@@ -222,67 +143,37 @@ class TuiMonth extends TuiYear {
         const absoluteTo = to.month + to.year * 12;
         return absoluteTo - absoluteFrom;
     }
-    /**
-     * Normalizes number by clamping it between min and max month
-     */
     static normalizeMonthPart(month) {
         return tuiNormalizeToIntNumber(month, MIN_MONTH, MAX_MONTH);
     }
-    /**
-     * Tests month for validity
-     */
     static isValidMonthPart(month) {
         return Number.isInteger(month) && tuiInRange(month, MIN_MONTH, MAX_MONTH + 1);
     }
     get formattedMonthPart() {
         return String(this.month + 1).padStart(2, `0`);
     }
-    /**
-     * Returns days in a month
-     */
     get daysCount() {
         return TuiMonth.getMonthDaysCount(this.month, this.isLeapYear);
     }
-    /**
-     * Passed month and year are after current
-     */
     monthBefore(another) {
         return (this.yearBefore(another) ||
             (this.yearSame(another) && this.month < another.month));
     }
-    /**
-     * Passed month and year are after or the same as current
-     */
     monthSameOrBefore(another) {
         return (this.yearBefore(another) ||
             (this.yearSame(another) && this.month <= another.month));
     }
-    /**
-     * Passed month and year are the same as current
-     */
     monthSame(another) {
         return this.yearSame(another) && this.month === another.month;
     }
-    /**
-     * Passed month and year are either before or equal to current
-     */
     monthSameOrAfter(another) {
         return (this.yearAfter(another) ||
             (this.yearSame(another) && this.month >= another.month));
     }
-    /**
-     * Passed month and year are before current
-     */
     monthAfter(another) {
         return (this.yearAfter(another) ||
             (this.yearSame(another) && this.month > another.month));
     }
-    /**
-     * Immutably alters current month and year by passed offset
-     *
-     * @param offset
-     * @return new month and year object as a result of offsetting current
-     */
     append({ year = 0, month = 0 }) {
         const totalMonths = (this.year + year) * MONTHS_IN_YEAR + this.month + month;
         return new TuiMonth(Math.floor(totalMonths / MONTHS_IN_YEAR), totalMonths % MONTHS_IN_YEAR);
@@ -296,58 +187,31 @@ class TuiMonth extends TuiYear {
     toJSON() {
         return `${super.toJSON()}-${this.formattedMonthPart}`;
     }
-    /**
-     * Returns native {@link Date} based on local time zone
-     */
     toLocalNativeDate() {
         return new Date(this.year, this.month);
     }
-    /**
-     * Returns native {@link Date} based on UTC
-     */
     toUtcNativeDate() {
         return new Date(Date.UTC(this.year, this.month));
     }
 }
 
-// TODO: Localized formatting
-/**
- * Immutable date object, consisting of day, month and year
- */
 class TuiDay extends TuiMonth {
     constructor(year, month, day) {
         super(year, month);
         this.day = day;
         ngDevMode && tuiAssert.assert(TuiDay.isValidDay(year, month, day));
     }
-    /**
-     * Creates {@link TuiDay} from native {@link Date} based on local time zone
-     */
     static fromLocalNativeDate(date) {
         return new TuiDay(date.getFullYear(), date.getMonth(), date.getDate());
     }
-    /**
-     * Creates {@link TuiDay} from native {@link Date} using UTC
-     */
     static fromUtcNativeDate(date) {
         return new TuiDay(date.getUTCFullYear(), date.getUTCMonth(), date.getUTCDate());
     }
-    /**
-     * Check validity of year, month and day
-     *
-     * @param year
-     * @param month
-     * @param day
-     * @return boolean validity
-     */
     static isValidDay(year, month, day) {
         return (TuiMonth.isValidMonth(year, month) &&
             Number.isInteger(day) &&
             tuiInRange(day, MIN_DAY, TuiMonth.getMonthDaysCount(month, TuiYear.isLeapYear(year)) + 1));
     }
-    /**
-     * Current day based on local time zone
-     */
     static currentLocal() {
         const nativeDate = new Date();
         const year = nativeDate.getFullYear();
@@ -355,9 +219,6 @@ class TuiDay extends TuiMonth {
         const day = nativeDate.getDate();
         return new TuiDay(year, month, day);
     }
-    /**
-     * Returns current day based on UTC
-     */
     static currentUtc() {
         const nativeDate = new Date();
         const year = nativeDate.getUTCFullYear();
@@ -365,14 +226,6 @@ class TuiDay extends TuiMonth {
         const day = nativeDate.getUTCDate();
         return new TuiDay(year, month, day);
     }
-    /**
-     * Calculates {@link TuiDay} normalizing year, month and day. {@link NaN} is turned into minimal value.
-     *
-     * @param year any year value, including invalid
-     * @param month any month value, including invalid (months start with 0)
-     * @param day any day value, including invalid
-     * @return normalized date
-     */
     static normalizeOf(year, month, day) {
         const normalizedYear = TuiYear.normalizeYearPart(year);
         const normalizedMonth = TuiMonth.normalizeMonthPart(month);
@@ -408,24 +261,10 @@ class TuiDay extends TuiMonth {
                 };
         }
     }
-    // TODO: Move month and year related code corresponding classes
-    /**
-     * Parsing a string with date with normalization
-     *
-     * @param rawDate date string
-     * @param dateMode date format of the date string (DMY | MDY | YMD)
-     * @return normalized date
-     */
     static normalizeParse(rawDate, dateMode = `DMY`) {
         const { day, month, year } = this.parseRawDateString(rawDate, dateMode);
         return TuiDay.normalizeOf(year, month, day);
     }
-    /**
-     * Parsing a date stringified in a toJSON format
-     * @param yearMonthDayString date string in format of YYYY-MM-DD
-     * @return date
-     * @throws exceptions if any part of the date is invalid
-     */
     static jsonParse(yearMonthDayString) {
         const { day, month, year } = this.parseRawDateString(yearMonthDayString, `YMD`);
         if (!TuiYear.isValidYear(year)) {
@@ -452,59 +291,31 @@ class TuiDay extends TuiMonth {
         const dayOfWeek = this.dayOfWeek(false);
         return dayOfWeek === TuiDayOfWeek.Saturday || dayOfWeek === TuiDayOfWeek.Sunday;
     }
-    /**
-     * Returns day of week
-     *
-     * @param startFromMonday whether week starts from Monday and not from Sunday
-     * @return day of week (from 0 to 6)
-     */
     dayOfWeek(startFromMonday = true) {
         const dayOfWeek = startFromMonday
             ? this.toLocalNativeDate().getDay() - 1
             : this.toLocalNativeDate().getDay();
         return dayOfWeek < 0 ? 6 : dayOfWeek;
     }
-    /**
-     * Passed date is after current
-     */
     dayBefore(another) {
         return (this.monthBefore(another) ||
             (this.monthSame(another) && this.day < another.day));
     }
-    /**
-     * Passed date is after or equals to current
-     */
     daySameOrBefore(another) {
         return (this.monthBefore(another) ||
             (this.monthSame(another) && this.day <= another.day));
     }
-    /**
-     * Passed date is the same as current
-     */
     daySame(another) {
         return this.monthSame(another) && this.day === another.day;
     }
-    /**
-     * Passed date is either before or the same as current
-     */
     daySameOrAfter(another) {
         return (this.monthAfter(another) ||
             (this.monthSame(another) && this.day >= another.day));
     }
-    /**
-     * Passed date is before current
-     */
     dayAfter(another) {
         return (this.monthAfter(another) ||
             (this.monthSame(another) && this.day > another.day));
     }
-    /**
-     * Clamping date between two limits
-     *
-     * @param min
-     * @param max
-     * @return clamped date
-     */
     dayLimit(min, max) {
         if (min !== null && this.dayBefore(min)) {
             return min;
@@ -514,16 +325,6 @@ class TuiDay extends TuiMonth {
         }
         return this;
     }
-    /**
-     * Immutably alters current day by passed offset
-     *
-     * If resulting month has more days than original one, date is rounded to the maximum day
-     * in the resulting month. Offset of days will be calculated based on the resulted year and month
-     * to not interfere with parent classes methods
-     *
-     * @param offset
-     * @return new date object as a result of offsetting current
-     */
     append({ year = 0, month = 0, day = 0 }) {
         const totalMonths = (this.year + year) * MONTHS_IN_YEAR + this.month + month;
         let years = Math.floor(totalMonths / MONTHS_IN_YEAR);
@@ -551,9 +352,6 @@ class TuiDay extends TuiMonth {
         }
         return new TuiDay(years, months, days);
     }
-    /**
-     * Returns formatted whole date
-     */
     getFormattedDay(dateFormat, separator) {
         ngDevMode &&
             tuiAssert.assert(separator.length === 1, `Separator should consist of only 1 symbol`);
@@ -576,23 +374,14 @@ class TuiDay extends TuiMonth {
     toJSON() {
         return `${super.toJSON()}-${this.formattedDayPart}`;
     }
-    /**
-     * Returns native {@link Date} based on local time zone
-     */
     toLocalNativeDate() {
         return new Date(this.year, this.month, this.day);
     }
-    /**
-     * Returns native {@link Date} based on UTC
-     */
     toUtcNativeDate() {
         return new Date(Date.UTC(this.year, this.month, this.day));
     }
 }
 
-/**
- * An immutable range of two {@link TuiMonth} objects
- */
 class TuiMonthRange {
     constructor(from, to) {
         this.from = from;
@@ -615,9 +404,6 @@ class TuiMonthRange {
     }
 }
 
-/**
- * An immutable range of two {@link TuiDay} objects
- */
 class TuiDayRange extends TuiMonthRange {
     constructor(from, to) {
         super(from, to);
@@ -625,25 +411,11 @@ class TuiDayRange extends TuiMonthRange {
         this.to = to;
         ngDevMode && tuiAssert.assert(from.daySameOrBefore(to));
     }
-    /**
-     * Creates range from two days after sorting them
-     *
-     * @param day1
-     * @param day2
-     * @return new range with sorted days
-     */
     static sort(day1, day2) {
         return day1.daySameOrBefore(day2)
             ? new TuiDayRange(day1, day2)
             : new TuiDayRange(day2, day1);
     }
-    /**
-     * Parse and correct a day range in string format
-     *
-     * @param rangeString a string of dates in a format dd.mm.yyyy - dd.mm.yyyy
-     * @param dateMode {@link TuiDateMode}
-     * @return normalized day range object
-     */
     static normalizeParse(rangeString, dateMode = `DMY`) {
         const leftDay = TuiDay.normalizeParse(rangeString.slice(0, DATE_FILLER_LENGTH), dateMode);
         if (rangeString.length < DATE_RANGE_FILLER_LENGTH) {
@@ -654,28 +426,12 @@ class TuiDayRange extends TuiMonthRange {
     get isSingleDay() {
         return this.from.daySame(this.to);
     }
-    /**
-     * Tests ranges for identity
-     *
-     * @param another second range to test against current
-     * @return `true` if days are identical
-     */
     daySame(another) {
         return this.from.daySame(another.from) && this.to.daySame(another.to);
     }
-    /**
-     * Locks range between two days included, or limits from one side if the other is null
-     *
-     * @param min
-     * @param max
-     * @return range — clamped range
-     */
     dayLimit(min, max) {
         return new TuiDayRange(this.from.dayLimit(min, max), this.to.dayLimit(min, max));
     }
-    /**
-     * Human readable format.
-     */
     getFormattedDayRange(dateFormat, dateSeparator) {
         const from = this.from.getFormattedDay(dateFormat, dateSeparator);
         const to = this.to.getFormattedDay(dateFormat, dateSeparator);
@@ -691,9 +447,6 @@ class TuiDayRange extends TuiMonthRange {
 const TUI_FIRST_DAY = new TuiDay(MIN_YEAR, MIN_MONTH, MIN_DAY);
 const TUI_LAST_DAY = new TuiDay(MAX_YEAR, MAX_MONTH, 31);
 
-/**
- * Immutable time object with hours, minutes, seconds and ms
- */
 class TuiTime {
     constructor(hours, minutes, seconds = 0, ms = 0) {
         this.hours = hours;
@@ -703,9 +456,6 @@ class TuiTime {
         ngDevMode &&
             tuiAssert.assert(TuiTime.isValidTime(hours, minutes, seconds, ms), `Time must be real, but got:`, hours, minutes, seconds, ms);
     }
-    /**
-     * Checks if time is valid
-     */
     static isValidTime(hours, minutes, seconds = 0, ms = 0) {
         return (Number.isInteger(hours) &&
             tuiInRange(hours, 0, HOURS_IN_DAY) &&
@@ -716,23 +466,14 @@ class TuiTime {
             Number.isInteger(ms) &&
             tuiInRange(ms, 0, 1000));
     }
-    /**
-     * Current UTC time.
-     */
     static current() {
         return TuiTime.fromAbsoluteMilliseconds(Date.now() % MILLISECONDS_IN_DAY);
     }
-    /**
-     * Current time in local timezone
-     */
     static currentLocal() {
         const date = new Date();
         return TuiTime.fromAbsoluteMilliseconds((Date.now() - date.getTimezoneOffset() * MILLISECONDS_IN_MINUTE) %
             MILLISECONDS_IN_DAY);
     }
-    /**
-     * Calculates TuiTime from milliseconds
-     */
     static fromAbsoluteMilliseconds(milliseconds) {
         ngDevMode && tuiAssert.assert(Number.isInteger(milliseconds));
         ngDevMode &&
@@ -743,9 +484,6 @@ class TuiTime {
         const ms = Math.floor(((milliseconds % MILLISECONDS_IN_HOUR) % MILLISECONDS_IN_MINUTE) % 1000) || 0;
         return new TuiTime(hours, minutes, seconds, ms);
     }
-    /**
-     * Parses string into TuiTime object
-     */
     static fromString(time) {
         const hours = Number(time.slice(0, 2));
         const minutes = Number(time.slice(3, 5));
@@ -753,16 +491,9 @@ class TuiTime {
         const ms = Number(time.slice(9, 12)) || 0;
         return new TuiTime(hours, minutes, seconds, ms);
     }
-    /**
-     * Converts Date object into TuiTime
-     * @param date
-     */
     static fromLocalNativeDate(date) {
         return new TuiTime(date.getHours(), date.getMinutes(), date.getSeconds(), date.getMilliseconds());
     }
-    /**
-     * Shifts time by hours and minutes
-     */
     shift({ hours = 0, minutes = 0, seconds = 0, ms = 0 }) {
         const newMs = (1000 + this.ms + (ms % 1000)) % 1000;
         const secondsInMs = ms < 0 ? Math.ceil(ms / 1000) : Math.floor(ms / 1000);
@@ -780,9 +511,6 @@ class TuiTime {
         const newHours = (24 + this.hours + (hoursToAdd % 24)) % 24;
         return new TuiTime(newHours, newMinutes, newSeconds, newMs);
     }
-    /**
-     * Converts TuiTime to string
-     */
     toString(mode) {
         const needAddMs = mode === `HH:MM:SS.MSS` || (!mode && this.ms > 0);
         const needAddSeconds = needAddMs || mode === `HH:MM:SS` || (!mode && this.seconds > 0);
@@ -793,17 +521,9 @@ class TuiTime {
     valueOf() {
         return this.toAbsoluteMilliseconds();
     }
-    /**
-     * Returns the primitive value of the given Date object.
-     * Depending on the argument, the method can return either a string or a number.
-     * @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/@@toPrimitive
-     */
     [Symbol.toPrimitive](hint) {
         return Date.prototype[Symbol.toPrimitive].call(this, hint);
     }
-    /**
-     * Converts TuiTime to milliseconds
-     */
     toAbsoluteMilliseconds() {
         return (this.hours * MILLISECONDS_IN_HOUR +
             this.minutes * MILLISECONDS_IN_MINUTE +
@@ -815,9 +535,5 @@ class TuiTime {
     }
 }
 
-/**
- * Generated bundle index. Do not edit.
- */
-
 export { DATE_FILLER_LENGTH, DATE_RANGE_FILLER_LENGTH, DAYS_IN_LEAP_YEAR, DAYS_IN_NORMAL_YEAR, DAYS_IN_WEEK, HOURS_IN_DAY, MAX_MONTH, MAX_YEAR, MILLISECONDS_IN_DAY, MILLISECONDS_IN_HOUR, MILLISECONDS_IN_MINUTE, MILLISECONDS_IN_SECOND, MINUTES_IN_HOUR, MIN_DAY, MIN_MONTH, MIN_YEAR, MONTHS_IN_YEAR, RANGE_SEPARATOR_CHAR, SECONDS_IN_MINUTE, TUI_DATE_FORMAT, TUI_DATE_SEPARATOR, TUI_FIRST_DAY, TUI_LAST_DAY, TuiDay, TuiDayRange, TuiMonth, TuiMonthRange, TuiTime, TuiYear, changeDateSeparator, tuiDateClamp };
 //# sourceMappingURL=taiga-ui-cdk-date-time.js.map