@globalpayments/vega 2.67.0 → 2.68.1

package/dist/collection/components/vega-textarea/vega-textarea.js

@@ -14,10 +14,11 @@ import { FormFieldControllerSlimmer } from '../../helpers/slimmers/form-field-co
 import { FORM_ELEMENT_VALUE_CHANGE } from '../../helpers/change-manager/subject/static-subject/static-subject-title';
 import ChangeManager from '../../helpers/change-manager/change-manager';
 import { createEventEmitSlimmer, } from '../../helpers/event-manager/slimmers/event-emit-slimmer';
-import { VegaBlur, VegaChange } from '../../helpers/event-manager/event-id/vega-event-id';
+import { VegaBlur, VegaChange, VegaLabelButtonClick, } from '../../helpers/event-manager/event-id/vega-event-id';
 import { ChildNodesEventPreventSlimmer } from '../../helpers/event-manager/slimmers/child-nodes-event-prevent-slimmer';
 import { VegaComponentUsageRuntimeMetricsSlimmer } from '../../helpers/slimmers/component-usage-runtime-metrics';
 import { VegaTextareaRuntimeMetricsPayloadDefinition } from '../../constants/runtime-metrics-payload-definition/vega-textarea/runtime-metrics-payload-definition';
+import { DomNodeSubjectObserverFactory } from '../../helpers/change-manager/subject/dom-node-subject/dom-node-subject-observer-factory';
 /**
  * @vegaVersion 1.11.0
  */
@@ -47,6 +48,7 @@ export class VegaTextarea {
     });
     this.changeEventEmitter = createEventEmitSlimmer(VegaTextarea, VegaChange);
     this.blurEventEmitter = createEventEmitSlimmer(VegaTextarea, VegaBlur);
+    this.labelButtonClickEventEmitter = createEventEmitSlimmer(VegaTextarea, VegaLabelButtonClick);
     this.textareaEventPrevent = new ChildNodesEventPreventSlimmer([VegaChange], () => this.inputContainerRef);
     this.vegaComponentUsageRuntimeMetricsSlimmer = new VegaComponentUsageRuntimeMetricsSlimmer(VegaTextareaRuntimeMetricsPayloadDefinition);
     this.currentCharCount = 0;
@@ -82,6 +84,15 @@ export class VegaTextarea {
      * @vegaVersion 1.11.0
      */
     this.label = '';
+    /**
+     * Specifies the properties for the suffix button associated with the input.
+     *
+     * It provides essential information and functionality
+     *  related to the suffix button's role and behavior.
+     *
+     * @vegaVersion __VERSION__
+     */
+    this.labelSuffixButtonConfig = null;
     /**
      * Determines whether to display a character counter
      *    for the textarea.
@@ -192,6 +203,9 @@ export class VegaTextarea {
     this.isExceedMaxLength = (value, maxLength) => {
       return maxLength != null ? value.length > maxLength : false;
     };
+    this.handleLabelButtonClick = () => {
+      this.labelButtonClickEventEmitter.emit();
+    };
   }
   watchValue(value) {
     this.changeEventEmitter.emit(value);
@@ -230,7 +244,9 @@ export class VegaTextarea {
       this.hint && this.renderHintMessage()), this.host);
   }
   renderLabelDom() {
-    return (h("vega-field-label", { onClick: this.inputFocus, "is-field-required": this.required, disabled: this.disabled, label: this.label }));
+    return (h("vega-field-label", { onClick: this.inputFocus, "is-field-required": this.required, disabled: this.disabled, label: this.label, suffixButtonConfig: this.labelSuffixButtonConfig, ref: (node) => {
+        DomNodeSubjectObserverFactory.addUniqueObserverToNode(node, VegaLabelButtonClick, this.handleLabelButtonClick);
+      } }));
   }
   static get is() { return "vega-textarea"; }
   static get encapsulation() { return "shadow"; }
@@ -325,6 +341,34 @@ export class VegaTextarea {
       "reflect": false,
       "defaultValue": "''"
     },
+    "labelSuffixButtonConfig": {
+      "type": "unknown",
+      "mutable": false,
+      "complexType": {
+        "original": "Nullable<LabelSuffixButtonConfig>",
+        "resolved": "{ icon: string; } & Partial<Pick<HTMLVegaTooltipElement, \"size\" | \"trigger\" | \"minWidth\" | \"maxWidth\" | \"text\" | \"placement\" | \"alignment\">>",
+        "references": {
+          "Nullable": {
+            "location": "import",
+            "path": "../../types/general"
+          },
+          "LabelSuffixButtonConfig": {
+            "location": "import",
+            "path": "../vega-field-label/types"
+          }
+        }
+      },
+      "required": false,
+      "optional": false,
+      "docs": {
+        "tags": [{
+            "name": "vegaVersion",
+            "text": "__VERSION__"
+          }],
+        "text": "Specifies the properties for the suffix button associated with the input.\n\nIt provides essential information and functionality\n related to the suffix button's role and behavior."
+      },
+      "defaultValue": "null"
+    },
     "showCounter": {
       "type": "boolean",
       "mutable": false,
@@ -620,6 +664,45 @@ export class VegaTextarea {
         "resolved": "undefined",
         "references": {}
       }
+    }, {
+      "method": "vegaLabelButtonClick",
+      "name": "vegaLabelButtonClick",
+      "bubbles": true,
+      "cancelable": true,
+      "composed": true,
+      "docs": {
+        "tags": [{
+            "name": "vegaVersion",
+            "text": "2.68.0"
+          }],
+        "text": "An event emitter notifying that the suffix button associated with the field label has been clicked."
+      },
+      "complexType": {
+        "original": "any",
+        "resolved": "any",
+        "references": {}
+      }
+    }, {
+      "method": "labelButtonClick",
+      "name": "labelButtonClick",
+      "bubbles": true,
+      "cancelable": true,
+      "composed": true,
+      "docs": {
+        "tags": [{
+            "name": "eventSemantics",
+            "text": "namespace:native"
+          }, {
+            "name": "vegaVersion",
+            "text": "2.68.0"
+          }],
+        "text": "An event emitter notifying that the suffix button associated with the field label has been clicked."
+      },
+      "complexType": {
+        "original": "any",
+        "resolved": "any",
+        "references": {}
+      }
     }]; }
   static get elementRef() { return "host"; }
   static get watchers() { return [{
@@ -649,6 +732,9 @@ __decorate([
 __decorate([
   InjectVegaSlimmer()
 ], VegaTextarea.prototype, "blurEventEmitter", void 0);
+__decorate([
+  InjectVegaSlimmer()
+], VegaTextarea.prototype, "labelButtonClickEventEmitter", void 0);
 __decorate([
   InjectVegaSlimmer()
 ], VegaTextarea.prototype, "textareaEventPrevent", void 0);

package/dist/collection/global/scripts/before-vega-load.js

@@ -22,6 +22,7 @@ import { VegaNonceInjectorSlimmer } from '../../helpers/slimmers/global/vega-non
 import { VegaRTETokenExtension } from '../../components/vega-rich-text-editor/extensions/tokens/token-extension';
 import { VegaRTELanguageExtension } from '../../components/vega-rich-text-editor/extensions/languages/language-extension';
 import { VegaRTEPresetToolbarItems } from '../../components/vega-rich-text-editor/constants/constant';
+import { VegaRTEFunctionExtension } from '../../components/vega-rich-text-editor/extensions/functions/function-extension';
 /**
  * Default export function that will be used by stencil global script,
  * which will be invoked before library loaded.
@@ -193,6 +194,7 @@ function injectVegaRichTextEditorClassIntoGlobal() {
   globalThis.VegaRTETokenExtension = VegaRTETokenExtension;
   globalThis.VegaRTELanguageExtension = VegaRTELanguageExtension;
   globalThis.VegaRTEPresetToolbarItems = VegaRTEPresetToolbarItems;
+  globalThis.VegaRTEFunctionExtension = VegaRTEFunctionExtension;
 }
 /**
  * Inject VegaPublicValidationRules to global as a public api

package/dist/collection/helpers/calendar/calendar-date-time.js

@@ -0,0 +1,136 @@
+import { LogUtility } from '../../utils/log';
+import { CalendarTime } from './calendar-time';
+import { CalendarDate } from './calendar-date';
+import { getSystemTimezone } from './utils';
+/**
+ * CalendarDateTime centralizes timezone-aware conversions between native Date instances and calendar helpers.
+ */
+export class CalendarDateTime {
+  constructor(date, timezone) {
+    this.originalDate = date;
+    this.timezone = timezone;
+    this.syncDateTime();
+  }
+  /**
+   * Build a CalendarDateTime from a native Date while the specific timezone.
+   *
+   * @param {Date} date - The native Date object to convert.
+   * @param {string} timezone - The timezone to apply.
+   * @returns {CalendarDateTime} A timezone-aware CalendarDateTime instance.
+   */
+  static fromDate(date, timezone) {
+    return new CalendarDateTime(date, timezone);
+  }
+  /**
+   * Build a CalendarDateTime from a date input (Date or string) and optional time metadata.
+   *
+   * @param {string | Date} date - The input date value (string or Date).
+   * @param {CalendarDateTimeOptions} options - Additional options for time, timezone, seconds, etc.
+   * @returns {CalendarDateTime} A timezone-aware CalendarDateTime instance.
+   */
+  static fromInitDataSource(date, options) {
+    const baseDate = new Date(date);
+    if (options.time) {
+      const calendarTime = CalendarTime.fromString(options.time);
+      baseDate.setHours(calendarTime.hours, calendarTime.minutes, 0, 0);
+    }
+    else if (options.endTimeMissing) {
+      baseDate.setHours(23, 59, 59, 0);
+    }
+    return CalendarDateTime.fromDate(baseDate, options.timezone);
+  }
+  /**
+   * Get the CalendarDate instance representing the date portion.
+   *
+   * @returns {CalendarDate} The CalendarDate object.
+   */
+  get calendarDate() {
+    return this.date;
+  }
+  /**
+   * Get the CalendarTime instance representing the time portion.
+   *
+   * @returns {CalendarTime} The CalendarTime object.
+   */
+  get calendarTime() {
+    return this.time;
+  }
+  /**
+   * Get a native Date object representing this CalendarDateTime.
+   *
+   * @returns {Date} The native Date object.
+   */
+  toDate() {
+    return this.date.toDate();
+  }
+  /**
+   * Set a new timezone and update CalendarDate/CalendarTime accordingly.
+   *
+   * @param {string} newTimezone - The new timezone to set.
+   */
+  setTimezone(newTimezone) {
+    this.timezone = newTimezone;
+    this.syncDateTime();
+  }
+  /**
+   * Sync CalendarDate and CalendarTime with the current originalDate and timezone.
+   */
+  syncDateTime() {
+    const normalized = this.convertDateToTimezone(this.originalDate);
+    this.date = new CalendarDate(normalized.getFullYear(), normalized.getMonth() + 1, normalized.getDate());
+    this.time = CalendarTime.fromDate(normalized);
+  }
+  /**
+   * Convert a Date to the specific timezone.
+   *
+   * @param {Date} date - The date to convert.
+   * @returns {Date} The date adjusted to the specific timezone.
+   */
+  convertDateToTimezone(date) {
+    if (this.timezone === getSystemTimezone()) {
+      return date;
+    }
+    try {
+      const formatter = new Intl.DateTimeFormat([], {
+        timeZone: this.timezone,
+        year: 'numeric',
+        month: '2-digit',
+        day: '2-digit',
+        hour: '2-digit',
+        minute: '2-digit',
+        second: '2-digit',
+        hour12: false,
+      });
+      const parts = formatter.formatToParts(date);
+      const yearPart = this.findDateTimeFormatPart(parts, 'year');
+      const monthPart = this.findDateTimeFormatPart(parts, 'month');
+      const dayPart = this.findDateTimeFormatPart(parts, 'day');
+      const hourPart = this.findDateTimeFormatPart(parts, 'hour');
+      const minutePart = this.findDateTimeFormatPart(parts, 'minute');
+      const secondPart = this.findDateTimeFormatPart(parts, 'second');
+      if (yearPart && monthPart && dayPart && hourPart && minutePart && secondPart) {
+        const year = parseInt(yearPart.value, 10);
+        const month = parseInt(monthPart.value, 10);
+        const day = parseInt(dayPart.value, 10);
+        const hour = parseInt(hourPart.value, 10);
+        const minute = parseInt(minutePart.value, 10);
+        const second = parseInt(secondPart.value, 10);
+        return new Date(year, month - 1, day, hour, minute, second);
+      }
+    }
+    catch (_a) {
+      LogUtility.warn('Invalid timezone:', this.timezone);
+    }
+    return date;
+  }
+  /**
+   * Find a specific part in the Intl.DateTimeFormatPart array.
+   *
+   * @param {Intl.DateTimeFormatPart[]} parts - The array of date/time format parts.
+   * @param {DateTimeFormatPartType} type - The type of part to find (e.g., 'year', 'month').
+   * @returns {Intl.DateTimeFormatPart | undefined} The matching part, if found.
+   */
+  findDateTimeFormatPart(parts, type) {
+    return parts.find((part) => part.type === type);
+  }
+}

package/dist/collection/helpers/calendar/calendar-date.js

@@ -1,5 +1,6 @@
 import { VegaInternalTranslation } from '../translation';
-import { getCurrentDatePartsInTimezone, getSystemTimezone } from './utils';
+import { CalendarDateTime } from './calendar-date-time';
+import { getSystemTimezone } from './utils';
 /**
  * Calendar date class
  */
@@ -17,8 +18,7 @@ export class CalendarDate {
    * @returns {CalendarDate} - Return a CalendarDate object
    */
   static from(currentDate, timezone = getSystemTimezone()) {
-    const { year, month, date } = getCurrentDatePartsInTimezone(timezone, currentDate);
-    return new CalendarDate(year, month, date);
+    return CalendarDateTime.fromDate(currentDate, timezone).calendarDate;
   }
   /**
    * The year of the calendar date
@@ -60,7 +60,13 @@ export class CalendarDate {
    * @returns {boolean} - Return true if the calendar date is today. Otherwise, return false.
    */
   isToday(timezone = getSystemTimezone()) {
-    const { year, month, date } = getCurrentDatePartsInTimezone(timezone, new Date());
+    if (timezone === getSystemTimezone()) {
+      const today = new Date();
+      return (today.getFullYear() === this.year &&
+        today.getMonth() + 1 === this.month &&
+        today.getDate() === this.date);
+    }
+    const { year, month, date } = CalendarDateTime.fromDate(new Date(), timezone).calendarDate;
     return year === this.year && month === this.month && date === this.date;
   }
   /**

package/dist/collection/helpers/calendar/calendar-event.js

@@ -2,8 +2,9 @@ import calendarEventRepeatPatternFactory from '../../components/vega-calendar/sl
 import { generateUUID } from '../../utils/misc';
 import { VegaInternalTranslation } from '../translation';
 import { CalendarDate } from './calendar-date';
-import { formatDisplayTime, getSystemTimezone, WeekdayLongNames } from './utils';
-import { LogUtility } from '../../utils/log';
+import { CalendarTime } from './calendar-time';
+import { CalendarDateTime } from './calendar-date-time';
+import { getSystemTimezone, WeekdayLongNames } from './utils';
 const CalendarDateFormatReg = /^\d{1,2}\/\d{1,2}\/\d{4}/;
 const CalendarTimeFormatReg = /^\d{1,2}:\d{1,2}/;
 /** The `CalendarEvent` class in TypeScript represents a calendar event with methods to validate required fields, initialize dates and times, and determine if it is a group event. */
@@ -101,7 +102,7 @@ export class CalendarEvent {
    * @returns {Date} The `startDate` property of type `Date` is being returned.
    */
   get startDate() {
-    return this._startDate;
+    return this._startDateTime.toDate();
   }
   /**
    * The function returns the end date property of an object.
@@ -109,23 +110,23 @@ export class CalendarEvent {
    * @returns {Date} The `endDate` property of type `Date` is being returned.
    */
   get endDate() {
-    return this._endDate;
+    return this._endDateTime.toDate();
   }
   /**
-   * This function returns the start time as a string.
+   * This function returns the start time as a CalendarTime.
    *
-   * @returns {string} The `_startTime` property, which is a string, is being returned.
+   * @returns {CalendarTime} The event start time.
    */
   get startTime() {
-    return this._startTime;
+    return this._startDateTime.calendarTime;
   }
   /**
-   * This function returns the end time as a string.
+   * This function returns the end time as a CalendarTime.
    *
-   * @returns {string} The `_endTime` property, which is a string, is being returned.
+   * @returns {CalendarTime} The event end time.
    */
   get endTime() {
-    return this._endTime;
+    return this._endDateTime.calendarTime;
   }
   /**
    * This function returns the number of days that an event spans.
@@ -150,7 +151,7 @@ export class CalendarEvent {
     const endDate = this._eventSpansDays > 1
       ? new Date(startDate.year, startDate.month - 1, startDate.date + (this._eventSpansDays - 1))
       : startDate.toDate();
-    const result = new CalendarEvent(Object.assign(Object.assign({}, this._event), { startDate: startDate.toDate(), endDate: endDate, startTime: this.startTime, endTime: this.endTime }), eventKey);
+    const result = new CalendarEvent(Object.assign(Object.assign({}, this._event), { startDate: startDate.toDate(), endDate: endDate, startTime: this.startTime.toString(), endTime: this.endTime.toString() }), eventKey);
     return result;
   }
   /**
@@ -193,8 +194,8 @@ export class CalendarEvent {
    */
   generateDateTimeString(viewDate, timeFormat) {
     const weekDay = VegaInternalTranslation.t(Object.values(WeekdayLongNames)[viewDate.toDate().getDay()]);
-    const startTime = formatDisplayTime(timeFormat, this.startTime);
-    const endTime = formatDisplayTime(timeFormat, this.endTime);
+    const startTime = this.startTime.toString(timeFormat);
+    const endTime = this.endTime.toString(timeFormat);
     return `${weekDay}, ${viewDate.date} ${viewDate.getMonthName(true)} ${viewDate.year} ${startTime} - ${endTime}`;
   }
   /**
@@ -202,13 +203,8 @@ export class CalendarEvent {
    *
    * @returns {number} the minutes
    */
-  getEventDuration() {
-    const [startHour, startMinutes] = this.startTime.split(':');
-    const [endHour, endMinutes] = this.endTime.split(':');
-    const now = CalendarDate.from(new Date(), this._timezone);
-    const startDate = new Date(now.year, now.month, now.date, Number(startHour), Number(startMinutes));
-    const endDate = new Date(now.year, now.month, now.date, Number(endHour) === 0 && Number(startHour) !== 0 ? 24 : Number(endHour), Number(endMinutes));
-    return (endDate.valueOf() - startDate.valueOf()) / (60 * 1000);
+  getEventMinutes() {
+    return CalendarTime.calculateDuration(this.startTime, this.endTime, 'minutes');
   }
   /**
    * This function returns an array of repeat series based on a given calendar period.
@@ -232,36 +228,8 @@ export class CalendarEvent {
    */
   updateTimezone(timezone) {
     this._timezone = timezone;
-    this.initDate(this._event);
-    this.initEventSpansDays();
-    this.initRepeatPattern();
-  }
-  /**
-   * The function `convertTimeTo24Hour` converts a time string from 12-hour format to 24-hour format in TypeScript.
-   *
-   * @param {string} timeString - The `convertTimeTo24Hour` function you provided is used to convert a
-   * time string from 12-hour format to 24-hour format. The function checks if the input time string is
-   * in 12-hour format and contains either 'am' or 'pm'.
-   * @returns {string} The `convertTimeTo24Hour` function returns a string representing the input time string
-   * converted to 24-hour format. If the input time string is in 12-hour format and contains 'am' or
-   * 'pm', it converts it to 24-hour format. If the input time string is not in 12-hour format or does
-   * not contain 'am' or 'pm', it returns the original input
-   */
-  convertTimeTo24Hour(timeString) {
-    timeString = timeString.toLocaleLowerCase();
-    if (timeString.indexOf('am') > 0 || timeString.indexOf('pm') > 0) {
-      if (timeString.indexOf('am') > 0) {
-        timeString = timeString.replace('am', '').trim();
-        const [hour, minutes] = timeString.split(':');
-        return `${hour === '12' ? '00' : hour}:${minutes}`;
-      }
-      else {
-        timeString = timeString.replace('pm', '').trim();
-        const [hour, minutes] = timeString.split(':');
-        return `${hour === '12' ? '12' : Number(hour) + 12}:${minutes}`;
-      }
-    }
-    return timeString;
+    this._startDateTime.setTimezone(timezone);
+    this._endDateTime.setTimezone(timezone);
   }
   /**
    * The function `checkEventRequireField` validates the required fields of a calendar event item in TypeScript.
@@ -293,164 +261,41 @@ export class CalendarEvent {
    */
   initDate(eventOptions) {
     const { startDate, startTime, endDate, endTime } = eventOptions;
-    const originalDateParts = this.processStartDate(startDate, startTime || '');
-    this._startTime = this.formatTimeForDisplay(this._startDate, startTime || '');
-    this.processEndDate(endDate || '', endTime || '', originalDateParts);
-    this._endTime = this.formatTimeForDisplay(this._endDate, endTime || '');
+    this.processStartDate(startDate, startTime);
+    this.processEndDate(endDate, endTime, startDate);
   }
   /**
-   * Process start date
+   * Parse the supplied start date/time, normalize into calendar wrappers.
    *
-   * @param {string | Date} startDate - Start date (string or Date object)
-   * @param {string} startTime - Start time string
-   * @returns {DateParts | undefined} originalDateParts information
+   * @param {string | Date} startDate - Raw start date value from the event payload.
+   * @param {string} startTime - Optional textual time component to parse.
    */
   processStartDate(startDate, startTime) {
-    let originalDateParts;
-    let tempDate;
-    if (startDate && typeof startDate === 'object') {
-      originalDateParts = {
-        year: startDate.getFullYear(),
-        month: startDate.getMonth(),
-        date: startDate.getDate(),
-      };
-      tempDate = startDate;
-    }
-    else if (startDate && typeof startDate === 'string') {
-      const [month, day, year] = startDate.split('/');
-      originalDateParts = {
-        year: Number(year),
-        month: Number(month) - 1,
-        date: Number(day),
-      };
-      tempDate = new Date(originalDateParts.year, originalDateParts.month, originalDateParts.date);
-    }
-    if (startTime && originalDateParts && tempDate) {
-      const { timeHours, timeMinutes } = this.getCurrentHourAndMinutes(startTime);
-      tempDate = new Date(originalDateParts.year, originalDateParts.month, originalDateParts.date, timeHours, timeMinutes, 0);
-    }
-    if (tempDate) {
-      this._startDate = this.convertDateToTimezone(tempDate);
-    }
-    return originalDateParts;
-  }
-  /**
-   * Process end date
-   *
-   * @param {string | Date} endDate - End date (string or Date object)
-   * @param {string} endTime - End time string
-   * @param {DateParts | undefined} fallbackDateParts - Default date parts to use when endDate is empty
-   */
-  processEndDate(endDate, endTime, fallbackDateParts) {
-    let tempDate;
-    if (endDate && typeof endDate === 'object') {
-      tempDate = endDate;
-    }
-    else if (endDate && typeof endDate === 'string') {
-      const [month, day, year] = endDate.split('/');
-      tempDate = new Date(Number(year), Number(month) - 1, Number(day), 23, 59, 59);
-    }
-    else {
-      if (fallbackDateParts) {
-        tempDate = new Date(fallbackDateParts.year, fallbackDateParts.month, fallbackDateParts.date, 23, 59, 59);
-      }
-    }
-    if (endTime && tempDate) {
-      const { timeHours, timeMinutes } = this.getCurrentHourAndMinutes(endTime, 23, 59);
-      tempDate = new Date(tempDate.getFullYear(), tempDate.getMonth(), tempDate.getDate(), timeHours, timeMinutes, 59);
-    }
-    if (tempDate) {
-      this._endDate = this.convertDateToTimezone(tempDate);
-    }
-  }
-  /**
-   * Format time for display
-   *
-   * @param {Date} date - Date object
-   * @param {string} originalTime - Original time string
-   * @returns {string} Formatted time string
-   */
-  formatTimeForDisplay(date, originalTime) {
-    const shouldUseOriginalTime = Boolean(originalTime) && this._timezone === getSystemTimezone();
-    if (shouldUseOriginalTime) {
-      const convertedTime = this.convertTimeTo24Hour(originalTime);
-      const [hour, minutes] = convertedTime.split(':');
-      return `${date.getHours().toString().padStart(hour.length, '0')}:${date
-        .getMinutes()
-        .toString()
-        .padStart(minutes.length, '0')}`;
-    }
-    else {
-      return `${date.getHours()}:${date.getMinutes()}`;
-    }
-  }
-  /**
-   * Parses a time string and extracts hour and minute values.
-   * If the time string is empty or invalid, returns the provided default values.
-   *
-   * @param {string} time - The time string to parse (e.g., "14:30", "2:30 PM")
-   * @param {number} defaultHours - Default hour value to use when time is empty (default: 0)
-   * @param {number} defaultMinutes - Default minute value to use when time is empty (default: 0)
-   * @returns {CalendarTimeHourMinutes} An object containing timeHours and timeMinutes as numbers
-   */
-  getCurrentHourAndMinutes(time, defaultHours = 0, defaultMinutes = 0) {
-    let timeHours = defaultHours;
-    let timeMinutes = defaultMinutes;
-    if (time) {
-      const timeString = this.convertTimeTo24Hour(time).split(':');
-      timeHours = Number(timeString[0]);
-      timeMinutes = Number(timeString[1]);
-    }
-    return { timeHours, timeMinutes };
+    this._startDateTime = CalendarDateTime.fromInitDataSource(startDate, {
+      timezone: this._timezone,
+      time: startTime,
+    });
   }
   /**
-   * Converts a Date object to the target timezone
+   * Parse the supplied end date/time, normalize into calendar wrappers.
    *
-   * @param {Date} date - The Date object to convert
-   * @returns {Date} A Date object representing the date/time in the target timezone
+   * @param {string | Date | undefined} endDate - The raw end date value from the event payload.
+   * @param {string | undefined} endTime - The optional textual end time component to parse.
+   * @param {string | Date} originStartDate - The start date value to use as fallback if endDate is missing.
    */
-  convertDateToTimezone(date) {
-    if (this._timezone && this._timezone !== getSystemTimezone()) {
-      try {
-        const targetFormatter = new Intl.DateTimeFormat([], {
-          timeZone: this._timezone,
-          year: 'numeric',
-          month: '2-digit',
-          day: '2-digit',
-          hour: '2-digit',
-          minute: '2-digit',
-          second: '2-digit',
-          hour12: false,
-        });
-        const targetParts = targetFormatter.formatToParts(date);
-        const getYear = targetParts.find((part) => part.type === 'year');
-        const getMonth = targetParts.find((part) => part.type === 'month');
-        const getDay = targetParts.find((part) => part.type === 'day');
-        const getHour = targetParts.find((part) => part.type === 'hour');
-        const getMinute = targetParts.find((part) => part.type === 'minute');
-        const getSecond = targetParts.find((part) => part.type === 'second');
-        if (getYear && getMonth && getDay && getHour && getMinute && getSecond) {
-          const year = parseInt(getYear.value, 10);
-          const month = parseInt(getMonth.value, 10);
-          const day = parseInt(getDay.value, 10);
-          const hour = parseInt(getHour.value, 10);
-          const minute = parseInt(getMinute.value, 10);
-          const second = parseInt(getSecond.value, 10);
-          return new Date(year, month - 1, day, hour, minute, second);
-        }
-      }
-      catch (error) {
-        LogUtility.warn('Invalid timezone:', this._timezone);
-      }
-    }
-    return date;
+  processEndDate(endDate, endTime, originStartDate) {
+    this._endDateTime = CalendarDateTime.fromInitDataSource(endDate || originStartDate, {
+      timezone: this._timezone,
+      time: endTime,
+      endTimeMissing: !endTime && !endDate,
+    });
   }
   /**
    * The function initializes a repeat pattern controller for a calendar event with specified start and end dates and repeat options.
    */
   initRepeatPattern() {
     if (this._event.repeatOptions && this._event.repeatOptions.frequency) {
-      this.repeatPattern = calendarEventRepeatPatternFactory.getPattern(this._startDate, this._event.repeatOptions, this._timezone);
+      this.repeatPattern = calendarEventRepeatPatternFactory.getPattern(this.startDate, this._event.repeatOptions, this._timezone);
     }
   }
   /**