@taiga-ui/cdk 2.28.0 → 2.29.0

package/README.md

@@ -5,13 +5,12 @@
 [![Discord](https://img.shields.io/discord/748677963142135818?color=7289DA&label=%23taiga-ui&logo=discord&logoColor=white)](https://discord.gg/Us8d8JVaTg)
 
 [Website](https://taiga-ui.dev) • [Documentation](https://taiga-ui.dev/getting-started) •
-[CDK Wiki](https://github.com/TinkoffCreditSystems/taiga-ui/wiki) •
-[Core team](https://github.com/TinkoffCreditSystems/taiga-ui/#core-team)
+[CDK Wiki](https://github.com/tinkoff/taiga-ui/wiki) • [Core team](https://github.com/tinkoff/taiga-ui/#core-team)
 
 > Development kit consisting of the low level tools and abstractions used to develop Taiga UI Angular entities
 
-It's a part of [**Taiga UI**](https://github.com/TinkoffCreditSystems/taiga-ui) that is fully-treeshakable Angular UI
-Kit consisting of multiple base libraries and several add-ons
+It's a part of [**Taiga UI**](https://github.com/tinkoff/taiga-ui) that is fully-treeshakable Angular UI Kit consisting
+of multiple base libraries and several add-ons
 
 ## How to install
 
@@ -24,4 +23,4 @@ that there is no redundant code in your bundle. Bundlphobia badge shows size of
 
 ## Docs
 
-[CDK Documentation on Github Wiki](https://github.com/TinkoffCreditSystems/taiga-ui/wiki/CDK)
+[CDK Documentation on Github Wiki](https://github.com/tinkoff/taiga-ui/wiki/CDK)

package/bundles/taiga-ui-cdk-date-time.umd.js

@@ -279,6 +279,10 @@
         factory: function () { return 'DMY'; },
     });
 
+    var TUI_DATE_SEPARATOR = new core.InjectionToken('Date separator for Taiga UI components', {
+        factory: function () { return '.'; },
+    });
+
     /**
      * Immutable year object
      * @nosideeffects
@@ -720,17 +724,42 @@
             return Math.round((to.toLocalNativeDate().getTime() - from.toLocalNativeDate().getTime()) /
                 (1000 * 60 * 60 * 24));
         };
+        TuiDay.parseRawDateString = function (date, dateMode) {
+            if (dateMode === void 0) { dateMode = 'DMY'; }
+            classes.tuiAssert.assert(date.length === DATE_FILLER_LENGTH, '[parseRawDateString]: wrong date string length');
+            switch (dateMode) {
+                case 'YMD':
+                    return {
+                        day: parseInt(date.slice(8, 10), 10),
+                        month: parseInt(date.slice(5, 7), 10) - 1,
+                        year: parseInt(date.slice(0, 4), 10),
+                    };
+                case 'MDY':
+                    return {
+                        day: parseInt(date.slice(3, 5), 10),
+                        month: parseInt(date.slice(0, 2), 10) - 1,
+                        year: parseInt(date.slice(6, 10), 10),
+                    };
+                default:
+                case 'DMY':
+                    return {
+                        day: parseInt(date.slice(0, 2), 10),
+                        month: parseInt(date.slice(3, 5), 10) - 1,
+                        year: parseInt(date.slice(6, 10), 10),
+                    };
+            }
+        };
         // TODO: Move month and year related code corresponding classes
         /**
          * Parsing a string with date with normalization
          *
-         * @param yearMonthDayString date string in format of DD.MM.Yyyy
+         * @param rawDate date string
+         * @param dateMode date format of the date string (DMY | MDY | YMD)
          * @return normalized date
          */
-        TuiDay.normalizeParse = function (yearMonthDayString) {
-            var day = parseInt(yearMonthDayString.slice(0, 2), 10);
-            var month = parseInt(yearMonthDayString.slice(3, 5), 10) - 1;
-            var year = parseInt(yearMonthDayString.slice(6, 10), 10);
+        TuiDay.normalizeParse = function (rawDate, dateMode) {
+            if (dateMode === void 0) { dateMode = 'DMY'; }
+            var _a = this.parseRawDateString(rawDate, dateMode), day = _a.day, month = _a.month, year = _a.year;
             return TuiDay.normalizeOf(year, month, day);
         };
         /**
@@ -740,9 +769,7 @@
          * @throws exceptions if any part of the date is invalid
          */
         TuiDay.jsonParse = function (yearMonthDayString) {
-            var day = parseInt(yearMonthDayString.slice(8, 10), 10);
-            var month = parseInt(yearMonthDayString.slice(5, 7), 10) - 1;
-            var year = parseInt(yearMonthDayString.slice(0, 4), 10);
+            var _a = this.parseRawDateString(yearMonthDayString, 'YMD'), day = _a.day, month = _a.month, year = _a.year;
             if (!TuiYear.isValidYear(year)) {
                 throw new Error('Invalid year: ' + year);
             }
@@ -769,6 +796,8 @@
         });
         Object.defineProperty(TuiDay.prototype, "formattedDay", {
             /**
+             * @deprecated use {@link getFormattedDay} instead
+             * TODO remove in 3.0
              * Formatted whole date
              */
             get: function () {
@@ -894,8 +923,28 @@
             }
             return new TuiDay(years, months, days);
         };
-        TuiDay.prototype.toString = function () {
-            return this.formattedDay;
+        /**
+         * Returns formatted whole date
+         */
+        TuiDay.prototype.getFormattedDay = function (dateFormat, separator) {
+            classes.tuiAssert.assert(separator.length === 1, 'Separator should consist of only 1 symbol');
+            var dd = this.formattedDayPart;
+            var mm = this.formattedMonthPart;
+            var yyyy = this.formattedYear;
+            switch (dateFormat) {
+                case 'YMD':
+                    return "" + yyyy + separator + mm + separator + dd;
+                case 'MDY':
+                    return "" + mm + separator + dd + separator + yyyy;
+                case 'DMY':
+                default:
+                    return "" + dd + separator + mm + separator + yyyy;
+            }
+        };
+        TuiDay.prototype.toString = function (dateFormat, separator) {
+            if (dateFormat === void 0) { dateFormat = 'DMY'; }
+            if (separator === void 0) { separator = '.'; }
+            return this.getFormattedDay(dateFormat, separator);
         };
         TuiDay.prototype.toJSON = function () {
             return _super.prototype.toJSON.call(this) + "-" + this.formattedDayPart;
@@ -952,6 +1001,13 @@
         return TuiMonthRange;
     }());
 
+    /**
+     * Temporary type guard to satisfy ts-overloading of normalizeParse method
+     * @deprecated TODO rm in v3.0
+     */
+    var isDateMode = function (dateMode) {
+        return ['DMY', 'YMD', 'MDY'].includes(dateMode);
+    };
     /**
      * An immutable range of two {@link TuiDay} objects
      */
@@ -980,14 +1036,17 @@
          * 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
          */
-        TuiDayRange.normalizeParse = function (rangeString) {
-            var leftDay = TuiDay.normalizeParse(rangeString.slice(0, DATE_FILLER_LENGTH));
+        TuiDayRange.normalizeParse = function (rangeString, dateMode) {
+            if (dateMode === void 0) { dateMode = 'DMY'; }
+            var dateFormat = isDateMode(dateMode) ? dateMode : 'DMY';
+            var leftDay = TuiDay.normalizeParse(rangeString.slice(0, DATE_FILLER_LENGTH), dateFormat);
             if (rangeString.length < DATE_RANGE_FILLER_LENGTH) {
                 return new TuiDayRange(leftDay, leftDay);
             }
-            return TuiDayRange.sort(leftDay, TuiDay.normalizeParse(rangeString.slice(DATE_FILLER_LENGTH + RANGE_SEPARATOR_CHAR.length)));
+            return TuiDayRange.sort(leftDay, TuiDay.normalizeParse(rangeString.slice(DATE_FILLER_LENGTH + RANGE_SEPARATOR_CHAR.length), dateFormat));
         };
         Object.defineProperty(TuiDayRange.prototype, "isSingleDay", {
             get: function () {
@@ -999,9 +1058,12 @@
         Object.defineProperty(TuiDayRange.prototype, "formattedDayRange", {
             /**
              * Human readable format.
+             * @deprecated use {@link getFormattedDayRange} instead
              */
             get: function () {
-                return "" + this.from.formattedDay + RANGE_SEPARATOR_CHAR + this.to.formattedDay;
+                var from = this.from.getFormattedDay('DMY', '.');
+                var to = this.to.getFormattedDay('DMY', '.');
+                return "" + from + RANGE_SEPARATOR_CHAR + to;
             },
             enumerable: true,
             configurable: true
@@ -1025,6 +1087,21 @@
         TuiDayRange.prototype.dayLimit = function (min, max) {
             return new TuiDayRange(this.from.dayLimit(min, max), this.to.dayLimit(min, max));
         };
+        /**
+         * Human readable format.
+         */
+        TuiDayRange.prototype.getFormattedDayRange = function (dateFormat, dateSeparator) {
+            var from = this.from.getFormattedDay(dateFormat, dateSeparator);
+            var to = this.to.getFormattedDay(dateFormat, dateSeparator);
+            return "" + from + RANGE_SEPARATOR_CHAR + to;
+        };
+        TuiDayRange.prototype.toString = function (dateFormat, dateSeparator) {
+            if (dateFormat === void 0) { dateFormat = 'DMY'; }
+            if (dateSeparator === void 0) { dateSeparator = '.'; }
+            var from = this.from.getFormattedDay(dateFormat, dateSeparator);
+            var to = this.to.getFormattedDay(dateFormat, dateSeparator);
+            return "" + from + RANGE_SEPARATOR_CHAR + to;
+        };
         return TuiDayRange;
     }(TuiMonthRange));
 
@@ -1171,6 +1248,7 @@
     exports.TUI_DATE_FILLER = TUI_DATE_FILLER;
     exports.TUI_DATE_FORMAT = TUI_DATE_FORMAT;
     exports.TUI_DATE_RANGE_FILLER = TUI_DATE_RANGE_FILLER;
+    exports.TUI_DATE_SEPARATOR = TUI_DATE_SEPARATOR;
     exports.TUI_FIRST_DAY = TUI_FIRST_DAY;
     exports.TUI_LAST_DAY = TUI_LAST_DAY;
     exports.TuiDay = TuiDay;
@@ -1179,6 +1257,7 @@
     exports.TuiMonthRange = TuiMonthRange;
     exports.TuiTime = TuiTime;
     exports.TuiYear = TuiYear;
+    exports.isDateMode = isDateMode;
 
     Object.defineProperty(exports, '__esModule', { value: true });