voyager-ionic-core 7.2.3 → 7.5.0

package/dist/collection/components/datetime/datetime.js

@@ -1,21 +1,21 @@
 /*!
  * (C) Ionic http://ionicframework.com - MIT License
  */
-import { Host, h, writeTask } from '@stencil/core';
+import { Host, h, writeTask } from "@stencil/core";
 import { startFocusVisible } from "../../utils/focus-visible";
 import { getElementRoot, raf, renderHiddenInput } from "../../utils/helpers";
 import { printIonError, printIonWarning } from "../../utils/logging/index";
 import { isRTL } from "../../utils/rtl/index";
 import { createColorClasses } from "../../utils/theme";
-import { caretDownSharp, caretUpSharp, chevronBack, chevronDown, chevronForward } from 'ionicons/icons';
-import { getIonMode } from '../../global/ionic-global';
-import { isSameDay, warnIfValueOutOfBounds, isBefore, isAfter } from './utils/comparison';
-import { generateMonths, getDaysOfMonth, getDaysOfWeek, getToday, getMonthColumnData, getDayColumnData, getYearColumnData, getTimeColumnsData, getCombinedDateColumnData, } from './utils/data';
-import { formatValue, getLocalizedTime, getMonthAndDay, getMonthAndYear } from './utils/format';
-import { is24Hour, isLocaleDayPeriodRTL, isMonthFirstLocale, getNumDaysInMonth } from './utils/helpers';
-import { calculateHourFromAMPM, convertDataToISO, getClosestValidDate, getEndOfWeek, getNextDay, getNextMonth, getNextWeek, getNextYear, getPreviousDay, getPreviousMonth, getPreviousWeek, getPreviousYear, getStartOfWeek, validateParts, } from './utils/manipulation';
-import { clampDate, convertToArrayOfNumbers, getPartsFromCalendarDay, parseAmPm, parseDate, parseMaxParts, parseMinParts, } from './utils/parse';
-import { getCalendarDayState, getHighlightStyles, isDayDisabled, isMonthDisabled, isNextMonthDisabled, isPrevMonthDisabled, } from './utils/state';
+import { caretDownSharp, caretUpSharp, chevronBack, chevronDown, chevronForward } from "ionicons/icons";
+import { getIonMode } from "../../global/ionic-global";
+import { isSameDay, warnIfValueOutOfBounds, isBefore, isAfter } from "./utils/comparison";
+import { generateMonths, getDaysOfMonth, getDaysOfWeek, getToday, getMonthColumnData, getDayColumnData, getYearColumnData, getTimeColumnsData, getCombinedDateColumnData, } from "./utils/data";
+import { formatValue, getLocalizedTime, getMonthAndDay, getMonthAndYear } from "./utils/format";
+import { isLocaleDayPeriodRTL, isMonthFirstLocale, getNumDaysInMonth, getHourCycle } from "./utils/helpers";
+import { calculateHourFromAMPM, convertDataToISO, getClosestValidDate, getEndOfWeek, getNextDay, getNextMonth, getNextWeek, getNextYear, getPreviousDay, getPreviousMonth, getPreviousWeek, getPreviousYear, getStartOfWeek, validateParts, } from "./utils/manipulation";
+import { clampDate, convertToArrayOfNumbers, getPartsFromCalendarDay, parseAmPm, parseDate, parseMaxParts, parseMinParts, } from "./utils/parse";
+import { getCalendarDayState, getHighlightStyles, isDayDisabled, isMonthDisabled, isNextMonthDisabled, isPrevMonthDisabled, } from "./utils/state";
 /**
  * @virtualProp {"ios" | "md"} mode - The mode determines which platform styles to use.
  *
@@ -33,16 +33,17 @@ import { getCalendarDayState, getHighlightStyles, isDayDisabled, isMonthDisabled
  *
  * @part month-year-button - The button that opens the month/year picker when
  * using a grid style layout.
+ *
+ * @part calendar-day - The individual buttons that display a day inside of the datetime
+ * calendar.
+ * @part calendar-day active - The currently selected calendar day.
+ * @part calendar-day today - The calendar day that contains the current day.
+ * @part calendar-day disabled - The calendar day that is disabled.
  */
 export class Datetime {
   constructor() {
     this.inputId = `ion-dt-${datetimeIds++}`;
     this.prevPresentation = null;
-    /**
-     * Duplicate reference to `activeParts` that does not trigger a re-render of the component.
-     * Allows caching an instance of the `activeParts` in between render cycles.
-     */
-    this.activePartsClone = [];
     this.warnIfIncorrectValueUsage = () => {
       const { multiple, value } = this;
       if (!multiple && Array.isArray(value)) {
@@ -70,9 +71,9 @@ export class Datetime {
      * data. This should be used when rendering an
      * interface in an environment where the `value`
      * may not be set. This function works
-     * by returning the first selected date in
-     * "activePartsClone" and then falling back to
-     * defaultParts if no active date is selected.
+     * by returning the first selected date and then
+     * falling back to defaultParts if no active date
+     * is selected.
      */
     this.getActivePartsWithFallback = () => {
       var _a;
@@ -80,8 +81,8 @@ export class Datetime {
       return (_a = this.getActivePart()) !== null && _a !== void 0 ? _a : defaultParts;
     };
     this.getActivePart = () => {
-      const { activePartsClone } = this;
-      return Array.isArray(activePartsClone) ? activePartsClone[0] : activePartsClone;
+      const { activeParts } = this;
+      return Array.isArray(activeParts) ? activeParts[0] : activeParts;
     };
     this.closeParentOverlay = () => {
       const popoverOrModal = this.el.closest('ion-modal, ion-popover');
@@ -93,7 +94,7 @@ export class Datetime {
       this.workingParts = Object.assign({}, parts);
     };
     this.setActiveParts = (parts, removeDate = false) => {
-      const { multiple, minParts, maxParts, activePartsClone } = this;
+      const { multiple, minParts, maxParts, activeParts } = this;
       /**
        * When setting the active parts, it is possible
        * to set invalid data. For example,
@@ -107,16 +108,7 @@ export class Datetime {
       const validatedParts = validateParts(parts, minParts, maxParts);
       this.setWorkingParts(validatedParts);
       if (multiple) {
-        /**
-         * We read from activePartsClone here because valueChanged() only updates that,
-         * so it's the more reliable source of truth. If we read from activeParts, then
-         * if you click July 1, manually set the value to July 2, and then click July 3,
-         * the new value would be [July 1, July 3], ignoring the value set.
-         *
-         * We can then pass the new value to activeParts (rather than activePartsClone)
-         * since the clone will be updated automatically by activePartsChanged().
-         */
-        const activePartsArray = Array.isArray(activePartsClone) ? activePartsClone : [activePartsClone];
+        const activePartsArray = Array.isArray(activeParts) ? activeParts : [activeParts];
         if (removeDate) {
           this.activeParts = activePartsArray.filter((p) => !isSameDay(p, validatedParts));
         }
@@ -241,7 +233,7 @@ export class Datetime {
       /**
        * Get the number of padding days so
        * we know how much to offset our next selector by
-       * to grab the correct calenday-day element.
+       * to grab the correct calendar-day element.
        */
       const padding = currentMonth.querySelectorAll('.calendar-day-padding');
       const { day } = this.workingParts;
@@ -252,7 +244,7 @@ export class Datetime {
        * Get the calendar day element
        * and focus it.
        */
-      const dayEl = currentMonth.querySelector(`.calendar-day:nth-of-type(${padding.length + day})`);
+      const dayEl = currentMonth.querySelector(`.calendar-day-wrapper:nth-of-type(${padding.length + day}) .calendar-day`);
       if (dayEl) {
         dayEl.focus();
       }
@@ -333,6 +325,19 @@ export class Datetime {
           const monthBox = month.getBoundingClientRect();
           if (Math.abs(monthBox.x - box.x) > 2)
             return;
+          /**
+           * If we're force-rendering a month, assume we've
+           * scrolled to that and return it.
+           *
+           * If forceRenderDate is ever used in a context where the
+           * forced month is not immediately auto-scrolled to, this
+           * should be updated to also check whether `month` has the
+           * same month and year as the forced date.
+           */
+          const { forceRenderDate } = this;
+          if (forceRenderDate !== undefined) {
+            return { month: forceRenderDate.month, year: forceRenderDate.year, day: forceRenderDate.day };
+          }
           /**
            * From here, we can determine if the start
            * month or the end month was scrolled into view.
@@ -387,6 +392,9 @@ export class Datetime {
             this.setWorkingParts(Object.assign(Object.assign({}, this.workingParts), { month, day: day, year }));
             calendarBodyRef.scrollLeft = workingMonth.clientWidth * (isRTL(this.el) ? -1 : 1);
             calendarBodyRef.style.removeProperty('overflow');
+            if (this.resolveForceDateScrolling) {
+              this.resolveForceDateScrolling();
+            }
           });
         };
         /**
@@ -441,10 +449,17 @@ export class Datetime {
       }
     };
     this.processValue = (value) => {
-      const hasValue = value !== null && value !== undefined;
+      const hasValue = value !== null && value !== undefined && (!Array.isArray(value) || value.length > 0);
       const valueToProcess = hasValue ? parseDate(value) : this.defaultParts;
-      const { minParts, maxParts } = this;
+      const { minParts, maxParts, workingParts, el } = this;
       this.warnIfIncorrectValueUsage();
+      /**
+       * Return early if the value wasn't parsed correctly, such as
+       * if an improperly formatted date string was provided.
+       */
+      if (!valueToProcess) {
+        return;
+      }
       /**
        * Datetime should only warn of out of bounds values
        * if set by the user. If the `value` is undefined,
@@ -462,16 +477,9 @@ export class Datetime {
        * that the values don't necessarily have to be in order.
        */
       const singleValue = Array.isArray(valueToProcess) ? valueToProcess[0] : valueToProcess;
-      const { month, day, year, hour, minute } = clampDate(singleValue, minParts, maxParts);
+      const targetValue = clampDate(singleValue, minParts, maxParts);
+      const { month, day, year, hour, minute } = targetValue;
       const ampm = parseAmPm(hour);
-      this.setWorkingParts({
-        month,
-        day,
-        year,
-        hour,
-        minute,
-        ampm,
-      });
       /**
        * Since `activeParts` indicates a value that
        * been explicitly selected either by the
@@ -501,6 +509,62 @@ export class Datetime {
          */
         this.activeParts = [];
       }
+      /**
+       * Only animate if:
+       * 1. We're using grid style (wheel style pickers should just jump to new value)
+       * 2. The month and/or year actually changed, and both are defined (otherwise there's nothing to animate to)
+       * 3. The calendar body is visible (prevents animation when in collapsed datetime-button, for example)
+       * 4. The month/year picker is not open (since you wouldn't see the animation anyway)
+       */
+      const didChangeMonth = (month !== undefined && month !== workingParts.month) || (year !== undefined && year !== workingParts.year);
+      const bodyIsVisible = el.classList.contains('datetime-ready');
+      const { isGridStyle, showMonthAndYear } = this;
+      if (isGridStyle && didChangeMonth && bodyIsVisible && !showMonthAndYear) {
+        this.animateToDate(targetValue);
+      }
+      else {
+        /**
+         * We only need to do this if we didn't just animate to a new month,
+         * since that calls prevMonth/nextMonth which calls setWorkingParts for us.
+         */
+        this.setWorkingParts({
+          month,
+          day,
+          year,
+          hour,
+          minute,
+          ampm,
+        });
+      }
+    };
+    this.animateToDate = async (targetValue) => {
+      const { workingParts } = this;
+      /**
+       * Tell other render functions that we need to force the
+       * target month to appear in place of the actual next/prev month.
+       * Because this is a State variable, a rerender will be triggered
+       * automatically, updating the rendered months.
+       */
+      this.forceRenderDate = targetValue;
+      /**
+       * Flag that we've started scrolling to the forced date.
+       * The resolve function will be called by the datetime's
+       * scroll listener when it's done updating everything.
+       * This is a replacement for making prev/nextMonth async,
+       * since the logic we're waiting on is in a listener.
+       */
+      const forceDateScrollingPromise = new Promise((resolve) => {
+        this.resolveForceDateScrolling = resolve;
+      });
+      /**
+       * Animate smoothly to the forced month. This will also update
+       * workingParts and correct the surrounding months for us.
+       */
+      const targetMonthIsBefore = isBefore(targetValue, workingParts);
+      targetMonthIsBefore ? this.prevMonth() : this.nextMonth();
+      await forceDateScrollingPromise;
+      this.resolveForceDateScrolling = undefined;
+      this.forceRenderDate = undefined;
     };
     this.onFocus = () => {
       this.ionFocus.emit();
@@ -556,6 +620,7 @@ export class Datetime {
       ampm: 'pm',
     };
     this.isTimePopoverOpen = false;
+    this.forceRenderDate = undefined;
     this.color = 'primary';
     this.name = this.inputId;
     this.disabled = false;
@@ -595,6 +660,11 @@ export class Datetime {
   maxChanged() {
     this.processMaxParts();
   }
+  get isGridStyle() {
+    const { presentation, preferWheel } = this;
+    const hasDatePresentation = presentation === 'date' || presentation === 'date-time' || presentation === 'time-date';
+    return hasDatePresentation && !preferWheel;
+  }
   yearValuesChanged() {
     this.parsedYearValues = convertToArrayOfNumbers(this.yearValues);
   }
@@ -610,51 +680,13 @@ export class Datetime {
   minuteValuesChanged() {
     this.parsedMinuteValues = convertToArrayOfNumbers(this.minuteValues);
   }
-  activePartsChanged() {
-    this.activePartsClone = this.activeParts;
-  }
   /**
    * Update the datetime value when the value changes
    */
-  valueChanged() {
-    const { value, minParts, maxParts, workingParts } = this;
+  async valueChanged() {
+    const { value } = this;
     if (this.hasValue()) {
-      this.warnIfIncorrectValueUsage();
-      /**
-       * Clones the value of the `activeParts` to the private clone, to update
-       * the date display on the current render cycle without causing another render.
-       *
-       * This allows us to update the current value's date/time display without
-       * refocusing or shifting the user's display (leaves the user in place).
-       */
-      const valueDateParts = parseDate(value);
-      if (valueDateParts) {
-        warnIfValueOutOfBounds(valueDateParts, minParts, maxParts);
-        if (Array.isArray(valueDateParts)) {
-          this.activePartsClone = [...valueDateParts];
-        }
-        else {
-          const { month, day, year, hour, minute } = valueDateParts;
-          const ampm = hour != null ? (hour >= 12 ? 'pm' : 'am') : undefined;
-          this.activePartsClone = Object.assign(Object.assign({}, this.activeParts), { month,
-            day,
-            year,
-            hour,
-            minute,
-            ampm });
-          /**
-           * The working parts am/pm value must be updated when the value changes, to
-           * ensure the time picker hour column values are generated correctly.
-           *
-           * Note that we don't need to do this if valueDateParts is an array, since
-           * multiple="true" does not apply to time pickers.
-           */
-          this.setWorkingParts(Object.assign(Object.assign({}, workingParts), { ampm }));
-        }
-      }
-      else {
-        printIonWarning(`Unable to parse date string: ${value}. Please provide a valid ISO 8601 datetime string.`);
-      }
+      this.processValue(value);
     }
     this.emitStyle();
     this.ionValueChange.emit({ value });
@@ -857,8 +889,6 @@ export class Datetime {
         printIonWarning('The highlightedDates property is not supported with preferWheel="true".', el);
       }
     }
-    this.processMinParts();
-    this.processMaxParts();
     const hourValues = (this.parsedHourValues = convertToArrayOfNumbers(this.hourValues));
     const minuteValues = (this.parsedMinuteValues = convertToArrayOfNumbers(this.minuteValues));
     const monthValues = (this.parsedMonthValues = convertToArrayOfNumbers(this.monthValues));
@@ -866,6 +896,8 @@ export class Datetime {
     const dayValues = (this.parsedDayValues = convertToArrayOfNumbers(this.dayValues));
     const todayParts = (this.todayParts = parseDate(getToday()));
     this.defaultParts = getClosestValidDate(todayParts, monthValues, dayValues, yearValues, hourValues, minuteValues);
+    this.processMinParts();
+    this.processMaxParts();
     this.processValue(this.value);
     this.emitStyle();
   }
@@ -901,7 +933,7 @@ export class Datetime {
     return (h("div", { class: "datetime-footer" }, h("div", { class: "datetime-buttons" }, h("div", { class: {
         ['datetime-action-buttons']: true,
         ['has-clear-button']: this.showClearButton,
-      } }, h("slot", { name: "buttons" }, h("ion-buttons", null, showDefaultButtons && (h("ion-button", { id: "cancel-button", color: this.color, onClick: () => this.cancel(true) }, this.cancelText)), h("div", null, showClearButton && (h("ion-button", { id: "clear-button", color: this.color, onClick: () => clearButtonClick() }, this.clearText)), showDefaultButtons && (h("ion-button", { id: "confirm-button", color: this.color, onClick: () => this.confirm(true) }, this.doneText)))))))));
+      } }, h("slot", { name: "buttons" }, h("ion-buttons", null, showDefaultButtons && (h("ion-button", { id: "cancel-button", color: this.color, onClick: () => this.cancel(true) }, this.cancelText)), h("div", { class: "datetime-action-buttons-container" }, showClearButton && (h("ion-button", { id: "clear-button", color: this.color, onClick: () => clearButtonClick() }, this.clearText)), showDefaultButtons && (h("ion-button", { id: "confirm-button", color: this.color, onClick: () => this.confirm(true) }, this.doneText)))))))));
   }
   /**
    * Wheel picker render methods
@@ -1250,7 +1282,7 @@ export class Datetime {
       const { el, highlightedDates, isDateEnabled, multiple } = this;
       const referenceParts = { month, day, year };
       const isCalendarPadding = day === null;
-      const { isActive, isToday, ariaLabel, ariaSelected, disabled, text } = getCalendarDayState(this.locale, referenceParts, this.activePartsClone, this.todayParts, this.minParts, this.maxParts, this.parsedDayValues);
+      const { isActive, isToday, ariaLabel, ariaSelected, disabled, text } = getCalendarDayState(this.locale, referenceParts, this.activeParts, this.todayParts, this.minParts, this.maxParts, this.parsedDayValues);
       const dateIsoString = convertDataToISO(referenceParts);
       let isCalDayDisabled = isCalMonthDisabled || disabled;
       if (!isCalDayDisabled && isDateEnabled !== undefined) {
@@ -1274,14 +1306,30 @@ export class Datetime {
       if (highlightedDates !== undefined && !isActive && day !== null) {
         dateStyle = getHighlightStyles(highlightedDates, dateIsoString, el);
       }
-      return (h("button", { tabindex: "-1", "data-day": day, "data-month": month, "data-year": year, "data-index": index, "data-day-of-week": dayOfWeek, disabled: isCalDayDisabled, class: {
+      let dateParts = undefined;
+      // "Filler days" at the beginning of the grid should not get the calendar day
+      // CSS parts added to them
+      if (!isCalendarPadding) {
+        dateParts = `calendar-day${isActive ? ' active' : ''}${isToday ? ' today' : ''}${isCalDayDisabled ? ' disabled' : ''}`;
+      }
+      return (h("div", { class: "calendar-day-wrapper" }, h("button", {
+        // We need to use !important for the inline styles here because
+        // otherwise the CSS shadow parts will override these styles.
+        // See https://github.com/WICG/webcomponents/issues/847
+        // Both the CSS shadow parts and highlightedDates styles are
+        // provided by the developer, but highlightedDates styles should
+        // always take priority.
+        ref: (el) => {
+          if (el) {
+            el.style.setProperty('color', `${dateStyle ? dateStyle.textColor : ''}`, 'important');
+            el.style.setProperty('background-color', `${dateStyle ? dateStyle.backgroundColor : ''}`, 'important');
+          }
+        }, tabindex: "-1", "data-day": day, "data-month": month, "data-year": year, "data-index": index, "data-day-of-week": dayOfWeek, disabled: isCalDayDisabled, class: {
           'calendar-day-padding': isCalendarPadding,
           'calendar-day': true,
           'calendar-day-active': isActive,
           'calendar-day-today': isToday,
-        }, style: dateStyle && {
-          color: dateStyle.textColor,
-        }, "aria-hidden": isCalendarPadding ? 'true' : null, "aria-selected": ariaSelected, "aria-label": ariaLabel, onClick: () => {
+        }, part: dateParts, "aria-hidden": isCalendarPadding ? 'true' : null, "aria-selected": ariaSelected, "aria-label": ariaLabel, onClick: () => {
           if (isCalendarPadding) {
             return;
           }
@@ -1301,13 +1349,12 @@ export class Datetime {
               day,
               year }));
           }
-        } }, h("div", { class: "calendar-day-highlight", style: {
-          backgroundColor: dateStyle === null || dateStyle === void 0 ? void 0 : dateStyle.backgroundColor,
-        } }), text));
+        }
+      }, text)));
     }))));
   }
   renderCalendarBody() {
-    return (h("div", { class: "calendar-body ion-focusable", ref: (el) => (this.calendarBodyRef = el), tabindex: "0" }, generateMonths(this.workingParts).map(({ month, year }) => {
+    return (h("div", { class: "calendar-body ion-focusable", ref: (el) => (this.calendarBodyRef = el), tabindex: "0" }, generateMonths(this.workingParts, this.forceRenderDate).map(({ month, year }) => {
       return this.renderMonth(month, year);
     })));
   }
@@ -1323,7 +1370,7 @@ export class Datetime {
   }
   renderTimeOverlay() {
     const { hourCycle, isTimePopoverOpen, locale } = this;
-    const use24Hour = is24Hour(locale, hourCycle);
+    const computedHourCycle = getHourCycle(locale, hourCycle);
     const activePart = this.getActivePartsWithFallback();
     return [
       h("div", { class: "time-header" }, this.renderTimeLabel()),
@@ -1342,7 +1389,7 @@ export class Datetime {
             await popoverRef.onWillDismiss();
             this.isTimePopoverOpen = false;
           }
-        } }, getLocalizedTime(locale, activePart, use24Hour)),
+        } }, getLocalizedTime(locale, activePart, computedHourCycle)),
       h("ion-popover", { alignment: "center", translucent: true, overlayIndex: 1, arrow: false, onWillPresent: (ev) => {
           /**
            * Intersection Observers do not consistently fire between Blink and Webkit
@@ -1462,14 +1509,13 @@ export class Datetime {
     }
   }
   render() {
-    const { name, value, disabled, el, color, readonly, showMonthAndYear, preferWheel, presentation, size } = this;
+    const { name, value, disabled, el, color, readonly, showMonthAndYear, preferWheel, presentation, size, isGridStyle, } = this;
     const mode = getIonMode(this);
     const isMonthAndYearPresentation = presentation === 'year' || presentation === 'month' || presentation === 'month-year';
     const shouldShowMonthAndYear = showMonthAndYear || isMonthAndYearPresentation;
     const monthYearPickerOpen = showMonthAndYear && !isMonthAndYearPresentation;
     const hasDatePresentation = presentation === 'date' || presentation === 'date-time' || presentation === 'time-date';
     const hasWheelVariant = hasDatePresentation && preferWheel;
-    const hasGrid = hasDatePresentation && !preferWheel;
     renderHiddenInput(true, el, name, formatValue(value), disabled);
     return (h(Host, { "aria-disabled": disabled ? 'true' : null, onFocus: this.onFocus, onBlur: this.onBlur, class: Object.assign({}, createColorClasses(color, {
         [mode]: true,
@@ -1480,7 +1526,7 @@ export class Datetime {
         [`datetime-presentation-${presentation}`]: true,
         [`datetime-size-${size}`]: true,
         [`datetime-prefer-wheel`]: hasWheelVariant,
-        [`datetime-grid`]: hasGrid,
+        [`datetime-grid`]: isGridStyle,
       })) }, this.renderDatetime(mode)));
   }
   static get is() { return "ion-datetime"; }
@@ -1508,7 +1554,8 @@ export class Datetime {
           "references": {
             "Color": {
               "location": "import",
-              "path": "../../interface"
+              "path": "../../interface",
+              "id": "src/interface.d.ts::Color"
             }
           }
         },
@@ -1634,7 +1681,8 @@ export class Datetime {
           "references": {
             "DatetimePresentation": {
               "location": "import",
-              "path": "./datetime-interface"
+              "path": "./datetime-interface",
+              "id": "src/components/datetime/datetime-interface.ts::DatetimePresentation"
             }
           }
         },
@@ -1832,7 +1880,8 @@ export class Datetime {
           "references": {
             "TitleSelectedDatesFormatter": {
               "location": "import",
-              "path": "./datetime-interface"
+              "path": "./datetime-interface",
+              "id": "src/components/datetime/datetime-interface.ts::TitleSelectedDatesFormatter"
             }
           }
         },
@@ -1870,11 +1919,13 @@ export class Datetime {
           "references": {
             "DatetimeHighlight": {
               "location": "import",
-              "path": "./datetime-interface"
+              "path": "./datetime-interface",
+              "id": "src/components/datetime/datetime-interface.ts::DatetimeHighlight"
             },
             "DatetimeHighlightCallback": {
               "location": "import",
-              "path": "./datetime-interface"
+              "path": "./datetime-interface",
+              "id": "src/components/datetime/datetime-interface.ts::DatetimeHighlightCallback"
             }
           }
         },
@@ -1978,9 +2029,15 @@ export class Datetime {
         "type": "string",
         "mutable": false,
         "complexType": {
-          "original": "'h23' | 'h12'",
-          "resolved": "\"h12\" | \"h23\" | undefined",
-          "references": {}
+          "original": "DatetimeHourCycle",
+          "resolved": "\"h11\" | \"h12\" | \"h23\" | \"h24\" | undefined",
+          "references": {
+            "DatetimeHourCycle": {
+              "location": "import",
+              "path": "./datetime-interface",
+              "id": "src/components/datetime/datetime-interface.ts::DatetimeHourCycle"
+            }
+          }
         },
         "required": false,
         "optional": true,
@@ -2034,7 +2091,8 @@ export class Datetime {
       "showMonthAndYear": {},
       "activeParts": {},
       "workingParts": {},
-      "isTimePopoverOpen": {}
+      "isTimePopoverOpen": {},
+      "forceRenderDate": {}
     };
   }
   static get events() {
@@ -2069,7 +2127,8 @@ export class Datetime {
           "references": {
             "DatetimeChangeEventDetail": {
               "location": "import",
-              "path": "./datetime-interface"
+              "path": "./datetime-interface",
+              "id": "src/components/datetime/datetime-interface.ts::DatetimeChangeEventDetail"
             }
           }
         }
@@ -2092,7 +2151,8 @@ export class Datetime {
           "references": {
             "DatetimeChangeEventDetail": {
               "location": "import",
-              "path": "./datetime-interface"
+              "path": "./datetime-interface",
+              "id": "src/components/datetime/datetime-interface.ts::DatetimeChangeEventDetail"
             }
           }
         }
@@ -2145,7 +2205,8 @@ export class Datetime {
           "references": {
             "StyleEventDetail": {
               "location": "import",
-              "path": "../../interface"
+              "path": "../../interface",
+              "id": "src/interface.d.ts::StyleEventDetail"
             }
           }
         }
@@ -2180,7 +2241,8 @@ export class Datetime {
             }],
           "references": {
             "Promise": {
-              "location": "global"
+              "location": "global",
+              "id": "global::Promise"
             }
           },
           "return": "Promise<void>"
@@ -2199,7 +2261,8 @@ export class Datetime {
             }],
           "references": {
             "Promise": {
-              "location": "global"
+              "location": "global",
+              "id": "global::Promise"
             }
           },
           "return": "Promise<void>"
@@ -2218,7 +2281,8 @@ export class Datetime {
             }],
           "references": {
             "Promise": {
-              "location": "global"
+              "location": "global",
+              "id": "global::Promise"
             }
           },
           "return": "Promise<void>"
@@ -2256,9 +2320,6 @@ export class Datetime {
       }, {
         "propName": "minuteValues",
         "methodName": "minuteValuesChanged"
-      }, {
-        "propName": "activeParts",
-        "methodName": "activePartsChanged"
       }, {
         "propName": "value",
         "methodName": "valueChanged"