@maggioli-design-system/magma 2.0.0-beta.1 → 2.0.0-beta.2

package/dist/collection/components/mds-calendar/mds-calendar.js

@@ -5,6 +5,9 @@ import { DateTime } from "luxon";
 import { Locale } from "../../common/locale";
 import { sanitizeISO8601Date } from "../../common/date";
 import clsx from "clsx";
+/**
+ * @slot preselection - Add `HTML elements` or `components` shown in the calendar preselection area.
+ */
 export class MdsCalendar {
     constructor() {
         this.hasPreselection = false;
@@ -22,7 +25,38 @@ export class MdsCalendar {
             es: {},
             el: {},
         });
+        /**
+         * Enables selecting a date range (start and end date) instead of a single date.
+         */
         this.rangePicker = true;
+        /**
+         * Shows the previous navigation button in the calendar header.
+         */
+        this.showPreviousButton = true;
+        /**
+         * Shows the next navigation button in the calendar header.
+         */
+        this.showNextButton = true;
+        /**
+         * Disables switching to month or year selection views from the calendar header.
+         */
+        this.disableMonthYearSelection = false;
+        /**
+         * Shows the preselection area above the calendar view.
+         */
+        this.showPreselection = false;
+        /**
+         * Specifies the date used to determine the visible month without changing the selection.
+         * @description It's in ISO format (YYYY-MM-DD).
+         * @example '2023-10-01'
+         */
+        this.viewDate = null;
+        /**
+         * Specifies the date used to preview the range selection across multiple visible calendars.
+         * @description It's in ISO format (YYYY-MM-DD).
+         * @example '2023-10-15'
+         */
+        this.hoverDate = null;
         /**
          * Specifies the start date of the selection
          * @description It's in ISO format (YYYY-MM-DD).
@@ -51,21 +85,82 @@ export class MdsCalendar {
         this.internalEndDate = this.endDate;
         this.currentMonth = '';
         this.currentYear = '';
+        this.handleMouseOver = (event) => {
+            const target = event.target;
+            if (!target.matches('mds-calendar-cell') ||
+                !this.rangePicker ||
+                this.internalStartDate === null ||
+                this.internalStartDate === '' ||
+                (this.internalEndDate !== null && this.internalEndDate !== '')) {
+                return;
+            }
+            const hoverDate = target.getAttribute('date');
+            if (hoverDate !== null && hoverDate !== '') {
+                this.hoverEmitter.emit({ hoverDate });
+            }
+        };
+        this.handleMouseLeave = () => {
+            if (!this.rangePicker ||
+                this.internalStartDate === null ||
+                this.internalStartDate === '' ||
+                (this.internalEndDate !== null && this.internalEndDate !== '') ||
+                this.hoverDate === null ||
+                this.hoverDate === '') {
+                return;
+            }
+            this.hoverEmitter.emit({ hoverDate: null });
+        };
+        this.handleMonthActionClick = (event) => {
+            event.stopPropagation();
+            if (this.disableMonthYearSelection) {
+                event.preventDefault();
+                return;
+            }
+            this.currentView = this.currentView === 'months' ? 'calendar' : 'months';
+            requestAnimationFrame(() => {
+                this.updateCalendar().then(() => this.setDates());
+            });
+        };
+        this.handleYearActionClick = (event) => {
+            event.stopPropagation();
+            if (this.disableMonthYearSelection) {
+                event.preventDefault();
+                return;
+            }
+            this.currentView = this.currentView === 'years' ? 'calendar' : 'years';
+            requestAnimationFrame(() => {
+                this.updateCalendar().then(() => this.setDates());
+            });
+        };
     }
+    /**
+     * Updates the component's texts to the locale currently set on the host element.
+     */
     async updateLang() {
         this.language = this.t.lang(this.host);
     }
     handleStartDate(newValue) {
         if (newValue !== null && newValue !== '') {
             this.internalStartDate = sanitizeISO8601Date(newValue === null || newValue === void 0 ? void 0 : newValue.toString());
-            if (this.internalEndDate) {
-                const startDateTime = DateTime.fromISO(this.internalStartDate);
+            this.startDateTime = DateTime.fromISO(this.internalStartDate);
+            this.startDateIdentifier = this.startDateTime.toISODate();
+            if (this.internalEndDate !== null && this.internalEndDate !== '') {
                 const endDateTime = DateTime.fromISO(this.internalEndDate);
-                if (startDateTime > endDateTime) {
+                if (this.startDateTime > endDateTime) {
                     console.warn('startDate is after endDate, swapping values');
                     return;
                 }
             }
+            else if (this.rangePicker) {
+                this.isFirstClick = false;
+            }
+            this.updateDates();
+        }
+        else if (newValue === null || newValue === '') {
+            this.internalStartDate = null;
+            this.startDateIdentifier = null;
+            this.startDateTime = null;
+            this.isFirstClick = true;
             this.updateDates();
         }
     }
@@ -76,69 +171,92 @@ export class MdsCalendar {
         }
         else if (newValue !== null && newValue !== '') {
             this.internalEndDate = sanitizeISO8601Date(newValue === null || newValue === void 0 ? void 0 : newValue.toString());
-            if (this.internalStartDate) {
+            this.endDateTime = DateTime.fromISO(this.internalEndDate);
+            this.endDateIdentifier = this.endDateTime.toISODate();
+            if (this.internalStartDate !== null && this.internalStartDate !== '') {
                 const startDateTime = DateTime.fromISO(this.internalStartDate);
-                const endDateTime = DateTime.fromISO(this.internalEndDate);
-                if (startDateTime > endDateTime) {
+                if (startDateTime > this.endDateTime) {
                     console.warn('startDate is after endDate, swapping values');
                     return;
                 }
             }
             this.updateDates();
         }
+        else if (newValue === null || newValue === '') {
+            this.internalEndDate = null;
+            this.endDateIdentifier = null;
+            this.endDateTime = null;
+            this.updateDates();
+        }
+    }
+    handleViewDate(newValue) {
+        if (newValue !== null && newValue !== '') {
+            const viewDate = DateTime.fromISO(newValue.toString());
+            if (viewDate.isValid) {
+                this.currentDate = viewDate;
+                this.updateCalendar().then(() => {
+                    requestAnimationFrame(() => this.setDates());
+                });
+            }
+        }
+    }
+    handleHoverDate() {
+        requestAnimationFrame(() => this.setDates());
     }
     componentWillLoad() {
         var _a, _b;
         this.language = this.t.lang(this.host);
-        if (this.internalStartDate) {
+        if (this.viewDate !== null && this.viewDate !== '') {
+            const viewDate = DateTime.fromISO(this.viewDate.toString());
+            if (viewDate.isValid) {
+                this.currentDate = viewDate;
+            }
+        }
+        else if (this.internalStartDate !== null && this.internalStartDate !== '') {
             this.internalStartDate = sanitizeISO8601Date((_a = this.internalStartDate) === null || _a === void 0 ? void 0 : _a.toString());
             this.startDateTime = DateTime.fromISO(this.internalStartDate);
             if (this.startDateTime.isValid) {
                 this.currentDate = this.startDateTime;
             }
         }
-        if (this.internalEndDate) {
+        if (this.internalEndDate !== null && this.internalEndDate !== '') {
             this.internalEndDate = sanitizeISO8601Date((_b = this.internalEndDate) === null || _b === void 0 ? void 0 : _b.toString());
             this.endDateTime = DateTime.fromISO(this.internalEndDate);
         }
         this.updateCalendar();
     }
     componentDidLoad() {
-        var _a, _b, _c;
+        var _a, _b, _c, _d, _e;
         this.hasPreselection =
             ((_a = this.host) === null || _a === void 0 ? void 0 : _a.querySelector('.date-preselection--has-preselection')) !== null;
-        (_c = (_b = this.host) === null || _b === void 0 ? void 0 : _b.shadowRoot) === null || _c === void 0 ? void 0 : _c.addEventListener('mouseover', (event) => {
-            const target = event.target;
-            if (target.matches('mds-calendar-cell') && this.startDateIdentifier && this.rangePicker) {
-                this.handleHover(target);
-            }
-        });
+        (_c = (_b = this.host) === null || _b === void 0 ? void 0 : _b.shadowRoot) === null || _c === void 0 ? void 0 : _c.addEventListener('mouseover', this.handleMouseOver);
+        (_e = (_d = this.host) === null || _d === void 0 ? void 0 : _d.shadowRoot) === null || _e === void 0 ? void 0 : _e.addEventListener('mouseleave', this.handleMouseLeave);
         this.setDates();
     }
     disconnectedCallback() {
-        var _a, _b;
-        (_b = (_a = this.host) === null || _a === void 0 ? void 0 : _a.shadowRoot) === null || _b === void 0 ? void 0 : _b.removeEventListener('mouseover', (event) => {
-            const target = event.target;
-            if (target.matches('mds-calendar-cell') && this.startDateIdentifier && this.rangePicker) {
-                this.handleHover(target);
-            }
-        });
+        var _a, _b, _c, _d;
+        (_b = (_a = this.host) === null || _a === void 0 ? void 0 : _a.shadowRoot) === null || _b === void 0 ? void 0 : _b.removeEventListener('mouseover', this.handleMouseOver);
+        (_d = (_c = this.host) === null || _c === void 0 ? void 0 : _c.shadowRoot) === null || _d === void 0 ? void 0 : _d.removeEventListener('mouseleave', this.handleMouseLeave);
     }
+    /**
+     * Sets the calendar's current date and re-renders the calendar accordingly.
+     * @param date the date to display, in ISO format (YYYY-MM-DD)
+     */
     async updateCurrentDate(date) {
         this.currentDate = DateTime.fromISO(date);
+        await this.updateCalendar();
+        await new Promise((resolve) => {
+            requestAnimationFrame(() => {
+                this.setDates();
+                resolve();
+            });
+        });
         return Promise.resolve();
     }
     updateDates() {
-        if (this.internalStartDate && this.internalEndDate && this.rangePicker) {
-            this.updateCalendar().then(() => {
-                requestAnimationFrame(() => this.setDates());
-            });
-        }
-        else if (this.internalStartDate && !this.rangePicker) {
-            this.updateCalendar().then(() => {
-                requestAnimationFrame(() => this.setDates());
-            });
-        }
+        this.updateCalendar().then(() => {
+            requestAnimationFrame(() => this.setDates());
+        });
     }
     async updateCalendar() {
         try {
@@ -155,36 +273,58 @@ export class MdsCalendar {
     }
     setDates() {
         const calendar = this.host;
-        if (!calendar)
+        if (calendar == null)
             return;
         const { shadowRoot } = calendar;
         if (!shadowRoot)
             return;
-        const calendarCells = shadowRoot.querySelectorAll('mds-calendar-cell[selection]');
-        if (this.isFirstClick) {
-            if (this.rangePicker) {
-                this.setRangeSelection(calendarCells, shadowRoot);
+        const calendarCells = shadowRoot.querySelectorAll('mds-calendar-cell[selection], mds-calendar-cell[preview]');
+        if (this.rangePicker) {
+            if (this.hoverDate !== null &&
+                this.hoverDate !== '' &&
+                (this.internalEndDate === null || this.internalEndDate === '')) {
+                this.setHoverSelection(calendarCells, shadowRoot);
             }
             else {
-                this.setSingleSelection(calendarCells, shadowRoot);
+                this.setRangeSelection(calendarCells, shadowRoot);
             }
         }
+        else {
+            this.setSingleSelection(calendarCells, shadowRoot);
+        }
     }
-    setRangeSelection(calendarCells, shadowRoot) {
+    clearSelectionState(calendarCells) {
         calendarCells.forEach((day) => {
             day.removeAttribute('selection');
             day.removeAttribute('preview');
         });
-        if (!this.internalStartDate || !this.internalEndDate)
+    }
+    setRangeSelection(calendarCells, shadowRoot) {
+        this.clearSelectionState(calendarCells);
+        if (this.internalStartDate === null || this.internalStartDate === '')
             return;
         this.startDateTime = DateTime.fromISO(this.internalStartDate.toString());
+        if (this.internalEndDate === null || this.internalEndDate === '') {
+            this.startDateIdentifier = this.startDateTime.toISODate();
+            this.isFirstClick = false;
+            const cells = shadowRoot.querySelectorAll('mds-calendar-cell');
+            cells.forEach((cell) => {
+                if (cell.getAttribute('date') === this.startDateTime.toFormat('yyyy-MM-dd')) {
+                    cell.setAttribute('selection', 'single');
+                    cell.setAttribute('preview', 'true');
+                }
+            });
+            return;
+        }
         this.endDateTime = DateTime.fromISO(this.internalEndDate.toString());
+        this.startDateIdentifier = this.startDateTime.toISODate();
+        this.endDateIdentifier = this.endDateTime.toISODate();
         const cells = shadowRoot.querySelectorAll('mds-calendar-cell');
-        if (cells) {
+        if (cells != null) {
             let isBetweenDates;
             for (let i = 0; i < cells.length; i++) {
                 const cellDate = cells[i].getAttribute('date');
-                if (cellDate) {
+                if (cellDate !== null && cellDate !== '') {
                     const currentDate = DateTime.fromISO(cellDate);
                     if (currentDate.toFormat('yyyy-MM-dd') === this.startDateTime.toFormat('yyyy-MM-dd')) {
                         cells[i].setAttribute('selection', 'start');
@@ -205,18 +345,59 @@ export class MdsCalendar {
             }
         }
     }
-    setSingleSelection(calendarCells, shadowRoot) {
-        calendarCells.forEach((cell) => {
-            cell.removeAttribute('selection');
+    setHoverSelection(calendarCells, shadowRoot) {
+        this.clearSelectionState(calendarCells);
+        if (this.internalStartDate === null ||
+            this.internalStartDate === '' ||
+            this.hoverDate === null ||
+            this.hoverDate === '') {
+            this.setRangeSelection(calendarCells, shadowRoot);
+            return;
+        }
+        const startDate = DateTime.fromISO(this.internalStartDate);
+        const hoverDate = DateTime.fromISO(this.hoverDate);
+        if (!startDate.isValid || !hoverDate.isValid) {
+            this.setRangeSelection(calendarCells, shadowRoot);
+            return;
+        }
+        const isForwardSelection = startDate <= hoverDate;
+        const cells = Array.from(shadowRoot.querySelectorAll('mds-calendar-cell'));
+        cells.forEach((cell) => {
+            const cellDateString = cell.getAttribute('date');
+            if (cellDateString === null || cellDateString === '')
+                return;
+            const cellDate = DateTime.fromISO(cellDateString);
+            if (!cellDate.isValid)
+                return;
+            const isInRange = isForwardSelection
+                ? cellDate >= startDate && cellDate <= hoverDate
+                : cellDate >= hoverDate && cellDate <= startDate;
+            if (!isInRange)
+                return;
+            cell.setAttribute('preview', 'true');
+            let selectionType = 'middle';
+            if (startDate.equals(hoverDate) && cellDate.equals(startDate)) {
+                selectionType = 'single';
+            }
+            else if (cellDate.equals(startDate)) {
+                selectionType = isForwardSelection ? 'start' : 'end';
+            }
+            else if (cellDate.equals(hoverDate)) {
+                selectionType = isForwardSelection ? 'end' : 'start';
+            }
+            cell.setAttribute('selection', selectionType);
         });
-        if (!this.internalStartDate)
+    }
+    setSingleSelection(calendarCells, shadowRoot) {
+        this.clearSelectionState(calendarCells);
+        if (this.internalStartDate === null || this.internalStartDate === '')
             return;
         this.startDateTime = DateTime.fromISO(this.internalStartDate.toString());
         const cells = shadowRoot.querySelectorAll('mds-calendar-cell');
-        if (cells) {
+        if (cells != null) {
             for (let i = 0; i < cells.length; i++) {
                 const cellDate = cells[i].getAttribute('date');
-                if (cellDate) {
+                if (cellDate !== null && cellDate !== '') {
                     const currentDate = DateTime.fromISO(cellDate);
                     if (currentDate.toFormat('yyyy-MM-dd') === this.startDateTime.toFormat('yyyy-MM-dd')) {
                         cells[i].setAttribute('selection', 'single');
@@ -230,6 +411,10 @@ export class MdsCalendar {
         this.updateCalendar().then(() => {
             requestAnimationFrame(() => this.setDates());
         });
+        this.navigationEmitter.emit({
+            currentDate: this.currentDate.toISODate(),
+            delta,
+        });
     }
     calculateWeekDaysInMonth() {
         const startOfMonth = this.currentDate.startOf('month');
@@ -254,6 +439,18 @@ export class MdsCalendar {
     }
     handleRange(element, dayInfo) {
         var _a, _b;
+        const pendingStartDate = this.startDate || this.host.getAttribute('start-date');
+        if (this.rangePicker &&
+            pendingStartDate !== null &&
+            pendingStartDate !== '' &&
+            (this.endDate === null || this.endDate === '') &&
+            (this.internalEndDate === null || this.internalEndDate === '') &&
+            this.isFirstClick) {
+            this.internalStartDate = sanitizeISO8601Date(pendingStartDate.toString());
+            this.startDateTime = DateTime.fromISO(this.internalStartDate);
+            this.startDateIdentifier = this.startDateTime.toISODate();
+            this.isFirstClick = false;
+        }
         const resetSelection = () => {
             this.internalStartDate = null;
             this.internalEndDate = null;
@@ -271,7 +468,10 @@ export class MdsCalendar {
                 });
             });
         };
-        if (this.startDateIdentifier && this.endDateIdentifier) {
+        if (this.startDateIdentifier !== null &&
+            this.startDateIdentifier !== '' &&
+            this.endDateIdentifier !== null &&
+            this.endDateIdentifier !== '') {
             resetSelection();
         }
         if (this.isFirstClick) {
@@ -290,13 +490,15 @@ export class MdsCalendar {
                 element.setAttribute('selection', 'single');
                 element.setAttribute('preview', 'true');
             });
+            this.datesEmitter.emit({ startDate: this.internalStartDate });
             return;
         }
         const calendar = this.host;
         const mdsCalendarCellElements = (_a = calendar === null || calendar === void 0 ? void 0 : calendar.shadowRoot) === null || _a === void 0 ? void 0 : _a.querySelectorAll('mds-calendar-cell');
         const startDateElementIndex = Array.from(mdsCalendarCellElements !== null && mdsCalendarCellElements !== void 0 ? mdsCalendarCellElements : []).findIndex((cell) => cell.getAttribute('date') === this.startDateIdentifier);
         const elementIndex = Array.from(mdsCalendarCellElements !== null && mdsCalendarCellElements !== void 0 ? mdsCalendarCellElements : []).indexOf(element);
-        if (this.startDateIdentifier &&
+        if (this.startDateIdentifier !== null &&
+            this.startDateIdentifier !== '' &&
             DateTime.fromISO(this.startDateIdentifier) <
                 DateTime.fromISO(element.getAttribute('date'))) {
             this.endDateIdentifier = element.getAttribute('date');
@@ -319,71 +521,14 @@ export class MdsCalendar {
                 mdsCalendarCellElements[i].setAttribute('selection', 'middle');
             }
         }
-        if (this.internalStartDate && this.internalEndDate) {
+        if (this.internalStartDate !== null &&
+            this.internalStartDate !== '' &&
+            this.internalEndDate !== null &&
+            this.internalEndDate !== '') {
             this.datesEmitter.emit({ startDate: this.internalStartDate, endDate: this.internalEndDate });
             this.checkPreselectionsEmitter.emit();
         }
     }
-    handleHover(element) {
-        var _a, _b;
-        const typedElement = element;
-        const startDate = DateTime.fromISO(this.internalStartDate);
-        if (!startDate.isValid || this.endDateIdentifier !== null)
-            return;
-        const calendar = this.host;
-        const mdsCalendarCellElements = Array.from((_b = (_a = calendar === null || calendar === void 0 ? void 0 : calendar.shadowRoot) === null || _a === void 0 ? void 0 : _a.querySelectorAll('mds-calendar-cell')) !== null && _b !== void 0 ? _b : []);
-        const hoveredDateStr = typedElement.getAttribute('date');
-        if (!hoveredDateStr)
-            return;
-        const hoveredDate = DateTime.fromISO(hoveredDateStr);
-        if (!hoveredDate.isValid)
-            return;
-        const startTypedElement = mdsCalendarCellElements.find((cell) => cell.getAttribute('date') === this.internalStartDate);
-        mdsCalendarCellElements.forEach((cell) => {
-            cell.removeAttribute('preview');
-            cell.removeAttribute('selection');
-        });
-        typedElement.setAttribute('preview', 'true');
-        const typedDateStr = typedElement.getAttribute('date');
-        if (typedDateStr) {
-            const typedDate = DateTime.fromISO(typedDateStr);
-            if (typedDate.isValid && startTypedElement) {
-                if (startDate < typedDate) {
-                    startTypedElement.setAttribute('selection', 'start');
-                }
-                else if (startDate > typedDate) {
-                    startTypedElement.setAttribute('selection', 'end');
-                    typedElement.setAttribute('selection', 'start');
-                }
-                else {
-                    typedElement.setAttribute('selection', 'single');
-                }
-            }
-        }
-        if (startDate.equals(hoveredDate)) {
-            typedElement.setAttribute('selection', 'single');
-        }
-        else {
-            const [start, end] = startDate < hoveredDate ? [startDate, hoveredDate] : [hoveredDate, startDate];
-            mdsCalendarCellElements.forEach((cell) => {
-                const cellDateStr = cell.getAttribute('date');
-                if (!cellDateStr)
-                    return;
-                const cellDate = DateTime.fromISO(cellDateStr);
-                if (!cellDate.isValid)
-                    return;
-                if (cellDate >= start && cellDate <= end) {
-                    cell.setAttribute('preview', 'true');
-                    let selectionType = 'middle';
-                    if (cellDate.equals(start))
-                        selectionType = 'start';
-                    if (cellDate.equals(end))
-                        selectionType = 'end';
-                    cell.setAttribute('selection', selectionType);
-                }
-            });
-        }
-    }
     handleSingleSelection(element, dayInfo) {
         var _a;
         const calendar = this.host;
@@ -395,12 +540,13 @@ export class MdsCalendar {
         this.internalStartDate = this.startDateTime.toISO().split('T')[0];
         this.isFirstClick = false;
         element.setAttribute('selection', 'single');
-        if (this.internalStartDate) {
+        if (this.internalStartDate !== null && this.internalStartDate !== '') {
             this.datesEmitter.emit({ startDate: this.internalStartDate });
         }
     }
     render() {
-        return (h(Host, { key: '9cf4758a496018f7555c8211259d875b67beb034' }, h("div", { key: '3fdd1bdcc0f8f75bcd591d6a2cbdfd0758c711e3', class: clsx('calendar-preselection', this.hasPreselection && 'calendar-preselection--has-preselection') }, h("slot", { key: '25aca5bda0a4180f936d984ad0a0f4c48506fb22', name: "preselection" })), h("div", { key: '79b17b93bfc52747a53cdcb270b42e8a8ff305ce', class: "calendar-view" }, h("nav", { key: '233c62791f8dc73343afd206aac928ef4b7eb5d1' }, h("mds-button", { key: 'd99f2792d37706f1556a96dad440a867c1c12b14', class: "action-back", icon: miBaselineBackIosNew, variant: "dark", tone: "text", onClick: (event) => {
+        return (h(Host, { key: '1eb387ba6abf7eca71b0fc607c7005ce29a61ead' }, h("div", { key: '0119ec58bd3b3787c855c37d23330213f2f451dd', class: clsx('calendar-preselection', (this.showPreselection || this.hasPreselection) &&
+                'calendar-preselection--has-preselection') }, h("slot", { key: '0d14d1aedf9fc330bbc5378e9be16d870f46e46f', name: "preselection" })), h("div", { key: '2ad32a9c10cf82522611857dc2024b0e725c686b', class: "calendar-view" }, h("nav", { key: 'e99cd48ef3430e3681fe95bbccebc44516218bd9' }, this.showPreviousButton && (h("mds-button", { key: '21286c151fd2cb5b4c48f633d7889a439099510c', class: "action-back", icon: miBaselineBackIosNew, variant: "dark", tone: "text", onClick: (event) => {
                 if (this.currentView === 'calendar') {
                     event.stopPropagation();
                     this.changeMonth(-1);
@@ -412,19 +558,7 @@ export class MdsCalendar {
                 else {
                     event.stopPropagation();
                 }
-            } }), h("div", { key: '9ddbaa32f8e022e45433aa99bee03b611a74e921', class: "select-month-or-year" }, (this.currentView === 'calendar' || this.currentView === 'months') && (h("mds-button", { key: 'ae8b3d52c9715469054cc0d0d10c4f9ed0ef7b80', class: "action-month", variant: "dark", tone: "text", onClick: (event) => {
-                event.stopPropagation();
-                this.currentView = this.currentView === 'months' ? 'calendar' : 'months';
-                requestAnimationFrame(() => {
-                    this.updateCalendar().then(() => this.setDates());
-                });
-            } }, this.currentMonth)), (this.currentView === 'calendar' || this.currentView === 'years') && (h("mds-button", { key: '1d827a7d18ad12dae8caa9ac55b187b4a042cfa3', class: "action-year", variant: "dark", tone: "text", onClick: (event) => {
-                event.stopPropagation();
-                this.currentView = this.currentView === 'years' ? 'calendar' : 'years';
-                requestAnimationFrame(() => {
-                    this.updateCalendar().then(() => this.setDates());
-                });
-            } }, this.currentYear))), h("mds-button", { key: '0f489501bed0661b8b7af6978a0a524524034a32', class: "action-forward", icon: miBaselineForwardIos, variant: "dark", tone: "text", onClick: (event) => {
+            } })), h("div", { key: 'fa9ca6714345f63863ff8311b0890872a26c21a5', class: "select-month-or-year" }, (this.currentView === 'calendar' || this.currentView === 'months') && (h("mds-button", { key: 'e0d20e39741b9434fb970fc384a0e18ac77f34bb', class: "action-month", truncate: "none", variant: "dark", tone: "text", label: this.currentMonth, onClick: this.handleMonthActionClick })), (this.currentView === 'calendar' || this.currentView === 'years') && (h("mds-button", { key: 'c8046b37184632df0dc142bbe25efd0e5b95373c', class: "action-year", truncate: "none", variant: "dark", tone: "text", label: this.currentYear, onClick: this.handleYearActionClick }))), this.showNextButton && (h("mds-button", { key: '4b93409bdf7f775af4f42f8f160f663ec6fcd970', class: "action-forward", icon: miBaselineForwardIos, variant: "dark", tone: "text", onClick: (event) => {
                 if (this.currentView === 'calendar') {
                     event.stopPropagation();
                     this.changeMonth(1);
@@ -436,13 +570,13 @@ export class MdsCalendar {
                 else {
                     event.stopPropagation();
                 }
-            } })), this.currentView === 'calendar' && (h("section", { key: 'ec747fc2e244ccd71aa8c7cfd3287b4423c851aa', class: "month-view" }, h("header", { key: '79385d765efa7e6bfe3bf3396bd2473309c11782', class: "month-view__days-names" }, this.weekdays.map((day) => (h("mds-button", { class: "week-day-name", variant: "dark", tone: "text" }, day)))), h("div", { key: '496d96bfe9897e963141134de34b553b45eb6a4b', class: "month-view__cells" }, this.weekDaysinMonth.map((dayInfo, index) => (h("mds-calendar-cell", { key: index, today: DateTime.now().toFormat('yyyy-MM-dd') === dayInfo.date.toFormat('yyyy-MM-dd'), date: dayInfo.date.toFormat('yyyy-MM-dd'), month: dayInfo.isCurrentMonth ? 'current' : 'other', disabled: (() => {
-                if (this.min &&
+            } }))), this.currentView === 'calendar' && (h("section", { key: '0ac4fb2d6b5099b675a4b07c4dbcd0e839e05721', class: "month-view" }, h("header", { key: 'dbb841edaa6435521e128eef973db34cbe98568f', class: "month-view__days-names" }, this.weekdays.map((day) => (h("mds-button", { class: "week-day-name", variant: "dark", tone: "text", label: day })))), h("div", { key: '211d488ff233741097cf28ca5039a0591da999e3', class: "month-view__cells" }, this.weekDaysinMonth.map((dayInfo, index) => (h("mds-calendar-cell", { key: index, today: DateTime.now().toFormat('yyyy-MM-dd') === dayInfo.date.toFormat('yyyy-MM-dd'), date: dayInfo.date.toFormat('yyyy-MM-dd'), month: dayInfo.isCurrentMonth ? 'current' : 'other', disabled: (() => {
+                if (this.min !== null &&
                     this.min !== '' &&
                     dayInfo.date < DateTime.fromISO(this.min)) {
                     return true;
                 }
-                if (this.max &&
+                if (this.max !== null &&
                     this.max !== '' &&
                     dayInfo.date > DateTime.fromISO(this.max)) {
                     return true;
@@ -458,12 +592,12 @@ export class MdsCalendar {
             }, title: dayInfo.date
                 .setLocale(this.language)
                 .toFormat('cccc d LLLL')
-                .replace(/^./, (char) => char.toUpperCase()), label: dayInfo.date.toFormat('dd') })))))), this.currentView === 'months' && (h("section", { key: 'b7917b0b12133f6731c844f4fbceafa4f932b4d7', class: "month-selection" }, h("header", { key: '38509395e4476b9b3174819dad4250e9a5962b7a', class: "month-view__month-names" }, Array.from({ length: 12 }).map((_, index) => {
+                .replace(/^./, (char) => char.toUpperCase()), label: dayInfo.date.toFormat('dd') })))))), this.currentView === 'months' && (h("section", { key: '4676197c1020dc31d126ca3dd25c018d5fd4531d', class: "month-selection" }, h("header", { key: '19efaa277ef13ccb5b04896c9d93a4c2a71df374', class: "month-view__month-names" }, Array.from({ length: 12 }).map((_, index) => {
             const monthName = DateTime.local()
                 .set({ month: index + 1 })
                 .setLocale(this.language)
                 .toFormat('MMMM');
-            return (h("mds-button", { class: "action", variant: "dark", tone: "text", onClick: (event) => {
+            return (h("mds-button", { class: "action", variant: "dark", tone: "text", label: monthName, onClick: (event) => {
                     event.stopPropagation();
                     this.currentDate = this.currentDate.set({ month: index + 1 });
                     this.currentMonth = this.currentDate.toFormat('MMMM');
@@ -471,10 +605,10 @@ export class MdsCalendar {
                     this.updateCalendar().then(() => {
                         requestAnimationFrame(() => this.setDates());
                     });
-                } }, monthName));
-        })))), this.currentView === 'years' && (h("section", { key: '02987c943f5089b76e14ccbcc2ab11cc611e93d1', class: "year-selection" }, h("header", { key: '9e3c0d96dfbab49bbad856cc11791e2adbeb886d', class: "month-view__years" }, Array.from({ length: 12 }).map((_, index) => {
+                } }));
+        })))), this.currentView === 'years' && (h("section", { key: 'e854ef954fd530baa48a5044de94ac8389853a12', class: "year-selection" }, h("header", { key: '7175d42c0853411c9a0b70be855f49e1cdc1ec60', class: "month-view__years" }, Array.from({ length: 12 }).map((_, index) => {
             const year = this.selectedYear + index;
-            return (h("mds-button", { class: "action", variant: "dark", tone: "text", onClick: (event) => {
+            return (h("mds-button", { class: "action", variant: "dark", tone: "text", label: `${year}`, onClick: (event) => {
                     event.stopPropagation();
                     this.currentDate = this.currentDate.set({ year });
                     this.currentYear = year.toString();
@@ -482,7 +616,7 @@ export class MdsCalendar {
                     this.updateCalendar().then(() => {
                         requestAnimationFrame(() => this.setDates());
                     });
-                } }, year));
+                } }));
         })))))));
     }
     static get is() { return "mds-calendar"; }
@@ -511,7 +645,7 @@ export class MdsCalendar {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Enables selecting a date range (start and end date) instead of a single date."
                 },
                 "getter": false,
                 "setter": false,
@@ -519,6 +653,138 @@ export class MdsCalendar {
                 "attribute": "range-picker",
                 "defaultValue": "true"
             },
+            "showPreviousButton": {
+                "type": "boolean",
+                "mutable": false,
+                "complexType": {
+                    "original": "boolean",
+                    "resolved": "boolean",
+                    "references": {}
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [],
+                    "text": "Shows the previous navigation button in the calendar header."
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false,
+                "attribute": "show-previous-button",
+                "defaultValue": "true"
+            },
+            "showNextButton": {
+                "type": "boolean",
+                "mutable": false,
+                "complexType": {
+                    "original": "boolean",
+                    "resolved": "boolean",
+                    "references": {}
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [],
+                    "text": "Shows the next navigation button in the calendar header."
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false,
+                "attribute": "show-next-button",
+                "defaultValue": "true"
+            },
+            "disableMonthYearSelection": {
+                "type": "boolean",
+                "mutable": false,
+                "complexType": {
+                    "original": "boolean",
+                    "resolved": "boolean",
+                    "references": {}
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [],
+                    "text": "Disables switching to month or year selection views from the calendar header."
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false,
+                "attribute": "disable-month-year-selection",
+                "defaultValue": "false"
+            },
+            "showPreselection": {
+                "type": "boolean",
+                "mutable": false,
+                "complexType": {
+                    "original": "boolean",
+                    "resolved": "boolean",
+                    "references": {}
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [],
+                    "text": "Shows the preselection area above the calendar view."
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": false,
+                "attribute": "show-preselection",
+                "defaultValue": "false"
+            },
+            "viewDate": {
+                "type": "string",
+                "mutable": false,
+                "complexType": {
+                    "original": "string | null",
+                    "resolved": "null | string",
+                    "references": {}
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [{
+                            "name": "description",
+                            "text": "It's in ISO format (YYYY-MM-DD)."
+                        }, {
+                            "name": "example",
+                            "text": "'2023-10-01'"
+                        }],
+                    "text": "Specifies the date used to determine the visible month without changing the selection."
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": true,
+                "attribute": "view-date",
+                "defaultValue": "null"
+            },
+            "hoverDate": {
+                "type": "string",
+                "mutable": false,
+                "complexType": {
+                    "original": "string | null",
+                    "resolved": "null | string",
+                    "references": {}
+                },
+                "required": false,
+                "optional": false,
+                "docs": {
+                    "tags": [{
+                            "name": "description",
+                            "text": "It's in ISO format (YYYY-MM-DD)."
+                        }, {
+                            "name": "example",
+                            "text": "'2023-10-15'"
+                        }],
+                    "text": "Specifies the date used to preview the range selection across multiple visible calendars."
+                },
+                "getter": false,
+                "setter": false,
+                "reflect": true,
+                "attribute": "hover-date",
+                "defaultValue": "null"
+            },
             "startDate": {
                 "type": "string",
                 "mutable": false,
@@ -638,7 +904,9 @@ export class MdsCalendar {
             "selectedYear": {},
             "language": {},
             "internalStartDate": {},
-            "internalEndDate": {}
+            "internalEndDate": {},
+            "currentMonth": {},
+            "currentYear": {}
         };
     }
     static get events() {
@@ -650,13 +918,43 @@ export class MdsCalendar {
                 "composed": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Emitted when the selected date or date range changes."
                 },
                 "complexType": {
                     "original": "{\n    startDate: string;\n    endDate?: string;\n  }",
                     "resolved": "{ startDate: string; endDate?: string | undefined; }",
                     "references": {}
                 }
+            }, {
+                "method": "navigationEmitter",
+                "name": "mdsCalendarNavigate",
+                "bubbles": true,
+                "cancelable": true,
+                "composed": true,
+                "docs": {
+                    "tags": [],
+                    "text": "Emitted when the user navigates to a different month or year."
+                },
+                "complexType": {
+                    "original": "{\n    currentDate: string;\n    delta: number;\n  }",
+                    "resolved": "{ currentDate: string; delta: number; }",
+                    "references": {}
+                }
+            }, {
+                "method": "hoverEmitter",
+                "name": "mdsCalendarHover",
+                "bubbles": true,
+                "cancelable": true,
+                "composed": true,
+                "docs": {
+                    "tags": [],
+                    "text": "Emitted when the user hovers over a day, used to preview a range selection."
+                },
+                "complexType": {
+                    "original": "{\n    hoverDate: string | null;\n  }",
+                    "resolved": "{ hoverDate: string | null; }",
+                    "references": {}
+                }
             }, {
                 "method": "checkPreselectionsEmitter",
                 "name": "mdsCalendarPreselect",
@@ -665,7 +963,7 @@ export class MdsCalendar {
                 "composed": true,
                 "docs": {
                     "tags": [],
-                    "text": ""
+                    "text": "Emitted when the calendar's preselection options need to be re-evaluated."
                 },
                 "complexType": {
                     "original": "void",
@@ -689,7 +987,7 @@ export class MdsCalendar {
                     "return": "Promise<void>"
                 },
                 "docs": {
-                    "text": "",
+                    "text": "Updates the component's texts to the locale currently set on the host element.",
                     "tags": []
                 }
             },
@@ -699,7 +997,7 @@ export class MdsCalendar {
                     "parameters": [{
                             "name": "date",
                             "type": "string",
-                            "docs": ""
+                            "docs": "the date to display, in ISO format (YYYY-MM-DD)"
                         }],
                     "references": {
                         "Promise": {
@@ -710,8 +1008,11 @@ export class MdsCalendar {
                     "return": "Promise<void>"
                 },
                 "docs": {
-                    "text": "",
-                    "tags": []
+                    "text": "Sets the calendar's current date and re-renders the calendar accordingly.",
+                    "tags": [{
+                            "name": "param",
+                            "text": "date the date to display, in ISO format (YYYY-MM-DD)"
+                        }]
                 }
             }
         };
@@ -724,6 +1025,12 @@ export class MdsCalendar {
             }, {
                 "propName": "endDate",
                 "methodName": "handleEndDate"
+            }, {
+                "propName": "viewDate",
+                "methodName": "handleViewDate"
+            }, {
+                "propName": "hoverDate",
+                "methodName": "handleHoverDate"
             }];
     }
 }