@heartlandone/vega 2.67.0 → 2.68.0

package/dist/types/components/vega-rich-text-editor/public-api.d.ts

@@ -1,3 +1,4 @@
+import htmlElementToAnnotationGenerator from './slimmers/controllers/helper/element-to-dto-strategy/annotation-handler/html-element-to-annotation-generator';
 export { VegaRTEContent } from './dto/content-state';
 export { RTENode } from './dto/nodes/node.abstract';
 export { RTEDecoratorNode } from './dto/nodes/decorator-node';
@@ -13,17 +14,23 @@ export { RTETokenNodeRenderer } from './extensions/tokens/token-node-renderer';
 export { VegaRTETokenExtension } from './extensions/tokens/token-extension';
 export { RTELanguageToolbarButtonRenderer } from './extensions/languages/language-toolbar-button-renderer';
 export { VegaRTELanguageExtension } from './extensions/languages/language-extension';
-export { ModifyContentAction } from './dto/actions/modify-content-action.abstract';
+export { VegaRTEFunctionExtension } from './extensions/functions/function-extension';
+export { ModifyContentAction, ModifyContentActionType } from './dto/actions/modify-content-action.abstract';
 export { AppendChildrenAction } from './dto/actions/append-child-nodes-action';
 export { RemoveChildrenAction } from './dto/actions/remove-child-action';
 export { InsertChildrenAfterAction } from './dto/actions/insert-children-after-block';
 export { InsertChildrenBeforeAction } from './dto/actions/insert-children-before-block';
 export { InsertNodeToNearestRootAction } from './dto/actions/insert-node-to-nearest-root-action';
 export { UpdateCursorPositionAction } from './dto/actions/update-cursor-position-action';
+export { InsertNewParagraphAction } from './dto/actions/insert-new-paragraph-action';
 export { CustomAttributeAnnotation } from './dto/annotations/custom-attribute-annotation';
 export { CustomClassAnnotation } from './dto/annotations/custom-class-annotation';
 export { CustomStyleAnnotation } from './dto/annotations/custom-style-annotation';
+export { RTEAnnotationStyle } from './dto/annotations/annotation-style';
 export { ActionHandleStrategy } from './dto/action-handle-strategies/action-handle-strategy.abstract';
+export { ActionHandlerInterceptor, ActionHandlerExecution, } from './dto/action-handle-strategies/action-handle-interceptor.abstract';
 export { RTERange } from './dto/range';
 export { ElementToDTOStrategy } from './slimmers/controllers/helper/element-to-dto-strategy/element-to-dto-strategy.abstract';
+export { BlockToRTEBlockStrategyAbstract } from './slimmers/controllers/helper/element-to-dto-strategy/block-to-rte-block-strategy.abstract';
+export { htmlElementToAnnotationGenerator };
 export { VegaRTEPresetToolbarItems } from './constants/constant';

package/dist/types/components/vega-rich-text-editor/slimmers/controllers/helper/element-to-dto-strategy/element-to-dto-strategy.abstract.d.ts

@@ -1,22 +1,13 @@
 import { Nullable } from '../../../../../../types/general';
-import { RTEContentBlock, VegaRTEAnnotations, VegaRTECustomNode, VegaRTETextAnnotations, VegaRTETransformOptions } from '../../../../interface';
+import { RTEContentBlock, VegaRTECustomNode, VegaRTETextAnnotations, VegaRTETransformOptions } from '../../../../interface';
 import { RTEBlock } from '../../../../dto/blocks/block.abstract';
-import { HtmlElementToAnnotationGenerateOptions } from './annotation-handler/html-element-to-annotation-generator';
 /**
  * Abstract class to define strategies for processing HTML elements
  */
 export declare abstract class ElementToDTOStrategy {
-  /**
-   * Convert element style attributes to text annotations.
-   *
-   * @param {HTMLElement} element - Current html element.
-   * @param {HtmlElementToAnnotationGenerateOptions} options - Options for generating annotations.
-   * @returns {VegaRTEAnnotations} - Generated annotations.
-   */
-  protected generateTextStyleAnnotations(element: HTMLElement, options?: HtmlElementToAnnotationGenerateOptions): VegaRTEAnnotations;
   abstract canHandle(elementsArray: HTMLElement[], currentIndex: number, options: VegaRTETransformOptions): number;
   abstract handle(elementsArray: HTMLElement[], options?: VegaRTETransformOptions, parentTextAnnotations?: VegaRTETextAnnotations): Nullable<RTEBlock | VegaRTECustomNode>;
-  abstract appendChildBlocks(currentBlock: RTEContentBlock, childBlocks: RTEContentBlock[]): void;
+  abstract appendChildBlocks(currentBlock: RTEBlock, childBlocks: RTEBlock[]): void;
   abstract shouldProceedToElementChildren(): boolean;
 }
 /**

package/dist/types/components/vega-rich-text-editor/slimmers/controllers/state-entity-rendering-registry.d.ts

@@ -1,7 +1,7 @@
 import { RTEBlock } from '../../dto/blocks/block.abstract';
 import { RTENode } from '../../dto/nodes/node.abstract';
 import { Nullable } from '../../../../types/general';
-import { VegaRTEContent } from '../../dto/content-state';
+import type { VegaRTEContent } from '../../dto/content-state';
 /**
  * This class is responsible for keeping track of the DOM elements and their corresponding entities.
  */

package/dist/types/components/vega-rich-text-editor/slimmers/renderers/tools/bullets-numbers/bullets-numbers-toolbar-button-slimmer.d.ts

@@ -14,4 +14,19 @@ export declare class BulletsNumbersToolbarButtonSlimmer extends VisualModeToolba
   protected renderContent(): HTMLElement;
   protected isSelected(): boolean;
   protected isDisabled(): boolean;
+  private shouldDisabledListToolbar;
+  /**
+   * Check if unable to insert blocks before or after the given block.
+   *
+   * @param {RTEBlock | VegaRTEContent} block - The block to check.
+   * @returns {boolean} - Boolean result.
+   */
+  private unableToInsertBlock;
+  /**
+   * Check if unable to convert the block to list or paragraph.
+   *
+   * @param {RTEBlock} block - The block to check.
+   * @returns {boolean} - Boolean result.
+   */
+  private unableToConvertListOrParagraph;
 }

package/dist/types/components/vega-rich-text-editor/slimmers/renderers/tools/code-block-toolbar-button-slimmer.d.ts

@@ -19,4 +19,5 @@ export declare class CodeBlockToolbarButtonSlimmer extends VisualModeToolbarButt
    */
   protected isSelected(): boolean;
   protected isDisabled(): boolean;
+  private shouldDisabledCodeBlockToolbar;
 }

package/dist/types/components/vega-rich-text-editor/slimmers/renderers/tools/visual-mode-toolbar-button-slimmer.abstract.d.ts

@@ -1,6 +1,9 @@
 import { ToolbarButtonSlimmer } from './toolbar-button-slimmer.abstract';
 import { ToolbarButtonConfig } from '../../../interface';
 import { VegaRichTextEditor } from '../../../vega-rich-text-editor';
+import { Nullable } from '../../../../../types/general';
+import { RTENode } from '../../../dto/nodes/node.abstract';
+import { RTEBlock } from '../../../dto/blocks/block.abstract';
 /**
  * Abstract class for visual mode toolbar buttons, except for the source edit button.
  */
@@ -21,4 +24,12 @@ export declare abstract class VisualModeToolbarButtonSlimmer extends ToolbarButt
    * @returns {boolean} - True if the button is disabled, false otherwise.
    */
   protected isDisabled(): boolean;
+  /**
+   * Check if the node support text annotation
+   *
+   * @param {Nullable< RTENode| RTEBlock>} node - The RTE node to check
+   * @param {string} annotationActionName - The annotation name to check
+   * @returns {boolean} - True if the node support text annotation, false otherwise
+   */
+  protected shouldDisabledToolbar(node: Nullable<RTENode | RTEBlock>, annotationActionName: string): boolean;
 }

package/dist/types/components/vega-rich-text-editor/slimmers/renderers/vega-rich-text-editor-renderer.d.ts

@@ -15,6 +15,7 @@ export declare class VegaRichTextEditorRenderer extends VegaSlimmer {
   toolbarItems: VegaRichTextEditor['toolbarItems'];
   sourceEditConfig: VegaRichTextEditor['sourceEditConfig'];
   allowSourceEdit: VegaRichTextEditor['allowSourceEdit'];
+  extensions: VegaRichTextEditor['extensions'];
   private richTextContainerRef;
   private richTextContentRef;
   private richTextWrapperRef;

package/dist/types/components/vega-rich-text-editor/test/dto/action-handle-strategies/block-delete-node-content-strategy.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/components/vega-rich-text-editor/test/dto/annotation-style.test.d.ts

@@ -0,0 +1 @@
+import '../../dto/setup';

package/dist/types/components/vega-textarea/vega-textarea.d.ts

@@ -5,6 +5,8 @@ import { FormFieldControllerSlimmer } from '../../helpers/slimmers/form-field-co
 import { EventEmitSlimmerBase } from '../../helpers/event-manager/slimmers/event-emit-slimmer';
 import { ChildNodesEventPreventSlimmer } from '../../helpers/event-manager/slimmers/child-nodes-event-prevent-slimmer';
 import { VegaComponentUsageRuntimeMetricsSlimmer } from '../../helpers/slimmers/component-usage-runtime-metrics';
+import { LabelSuffixButtonConfig } from '../vega-field-label/types';
+import { Nullable } from '../../types/general';
 /**
  * @vegaVersion 1.11.0
  */
@@ -13,6 +15,7 @@ export declare class VegaTextarea {
   protected readonly formFieldController: FormFieldControllerSlimmer<string>;
   protected changeEventEmitter: EventEmitSlimmerBase;
   protected blurEventEmitter: EventEmitSlimmerBase;
+  protected labelButtonClickEventEmitter: EventEmitSlimmerBase;
   protected textareaEventPrevent: ChildNodesEventPreventSlimmer;
   protected vegaComponentUsageRuntimeMetricsSlimmer: VegaComponentUsageRuntimeMetricsSlimmer<HTMLVegaTextareaElement>;
   private textareaRef;
@@ -51,6 +54,15 @@ export declare class VegaTextarea {
    * @vegaVersion 1.11.0
    */
   label: string;
+  /**
+   * 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__
+   */
+  labelSuffixButtonConfig: Nullable<LabelSuffixButtonConfig>;
   /**
    * Determines whether to display a character counter
    *    for the textarea.
@@ -150,6 +162,19 @@ export declare class VegaTextarea {
    * @vegaVersion 2.0.0
    */
   blur: EventEmitter<undefined>;
+  /**
+   * An event emitter notifying that the suffix button associated with the field label has been clicked.
+   *
+   * @vegaVersion 2.68.0
+   */
+  vegaLabelButtonClick: EventEmitter;
+  /**
+   * An event emitter notifying that the suffix button associated with the field label has been clicked.
+   *
+   * @eventSemantics namespace:native
+   * @vegaVersion 2.68.0
+   */
+  labelButtonClick: EventEmitter;
   componentWillLoad(): void;
   /**
    * The below method is e2e-test covered in
@@ -170,4 +195,5 @@ export declare class VegaTextarea {
   private inputFocus;
   private handleTextareaBlur;
   private isExceedMaxLength;
+  private handleLabelButtonClick;
 }

package/dist/types/components.d.ts

@@ -29,7 +29,7 @@ import { DatePickerModeType, DatePickerMonthYearTypes, DatePickerValueType, Drop
 import { VegaDialogAction, VegaDialogActionButtonProps } from "./components/vega-dialog/types";
 import { VegaDividerDirectionType, VegaDividerVariantType } from "./components/vega-divider/interface";
 import { VegaDropdownItemClickEvent } from "./components/vega-dropdown/vega-dropdown-item/types";
-import { LabelSuffixButtonProps } from "./components/vega-field-label/types";
+import { LabelSuffixButtonConfig, LabelSuffixButtonProps } from "./components/vega-field-label/types";
 import { VegaFileUploaderFile, VegaFileUploaderFiles, VegaFileUploaderType } from "./components/vega-file-uploader/types";
 import { VegaCountryCode } from "./types/flag.type";
 import { VegaFontAs } from "./components/vega-font/types";
@@ -1557,6 +1557,11 @@ export namespace Components {
         "label": string;
         /**
           * 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 2.68.0
+         */
+        "suffixButtonConfig": Nullable<LabelSuffixButtonConfig>;
+        /**
+          * @deprecated Please use `suffixButtonConfig` instead  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 2.25.0
          */
         "suffixButtonProps": LabelSuffixButtonProps;
@@ -1975,9 +1980,14 @@ export namespace Components {
         "label": string;
         /**
           * 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 2.68.0
+         */
+        "labelSuffixButtonConfig": Nullable<LabelSuffixButtonConfig>;
+        /**
+          * @deprecated Please use `LabelSuffixButtonConfig` instead  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 2.25.0
          */
-        "labelSuffixButtonProps": LabelSuffixButtonProps;
+        "labelSuffixButtonProps": Nullable<LabelSuffixButtonProps>;
         /**
           * Specifies the configuration for applying a mask to the input field.  It provides a way to define a specific format or pattern for the input value,    restricting and guiding the user's input accordingly.
           * @vegaVersion 1.3.0
@@ -2459,6 +2469,11 @@ export namespace Components {
           * @vegaVersion 1.3.0
          */
         "label": string;
+        /**
+          * 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 2.68.0
+         */
+        "labelSuffixButtonConfig": Nullable<LabelSuffixButtonConfig>;
         /**
           * Specifies a placeholder string that displays as a temporary hint or    example inside the input select field.  It indicates the expected format or pattern of the input.
           * @vegaVersion 1.0.7
@@ -4107,6 +4122,11 @@ export namespace Components {
           * @vegaVersion 1.11.0
          */
         "label": string;
+        /**
+          * 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__
+         */
+        "labelSuffixButtonConfig": Nullable<LabelSuffixButtonConfig>;
         /**
           * Specifies the maximum number of characters (UTF-16 code units)    that the user can enter in the text area.
           * @vegaVersion 1.11.0
@@ -7221,6 +7241,11 @@ declare namespace LocalJSX {
         "onVegaLabelButtonClick"?: (event: VegaFieldLabelCustomEvent<any>) => void;
         /**
           * 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 2.68.0
+         */
+        "suffixButtonConfig"?: Nullable<LabelSuffixButtonConfig>;
+        /**
+          * @deprecated Please use `suffixButtonConfig` instead  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 2.25.0
          */
         "suffixButtonProps"?: LabelSuffixButtonProps;
@@ -7711,9 +7736,14 @@ declare namespace LocalJSX {
         "label"?: string;
         /**
           * 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 2.68.0
+         */
+        "labelSuffixButtonConfig"?: Nullable<LabelSuffixButtonConfig>;
+        /**
+          * @deprecated Please use `LabelSuffixButtonConfig` instead  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 2.25.0
          */
-        "labelSuffixButtonProps"?: LabelSuffixButtonProps;
+        "labelSuffixButtonProps"?: Nullable<LabelSuffixButtonProps>;
         /**
           * Specifies the configuration for applying a mask to the input field.  It provides a way to define a specific format or pattern for the input value,    restricting and guiding the user's input accordingly.
           * @vegaVersion 1.3.0
@@ -8334,12 +8364,23 @@ declare namespace LocalJSX {
           * @vegaVersion 1.3.0
          */
         "label"?: string;
+        /**
+          * 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 2.68.0
+         */
+        "labelSuffixButtonConfig"?: Nullable<LabelSuffixButtonConfig>;
         /**
           * An event emitter notifying the change of the select value.
           * @eventSemantics namespace:native
           * @vegaVersion 2.0.0
          */
         "onChange"?: (event: VegaInputSelectCustomEvent<SelectValueType<SelectType>>) => void;
+        /**
+          * An event emitter notifying that the suffix button associated with the field label has been clicked.
+          * @eventSemantics namespace:native
+          * @vegaVersion 2.68.0
+         */
+        "onLabelButtonClick"?: (event: VegaInputSelectCustomEvent<any>) => void;
         /**
           * An event emitter notifying the search of the dropdown.
           * @eventSemantics namespace:native
@@ -8362,6 +8403,11 @@ declare namespace LocalJSX {
           * @vegaVersion 2.32.0
          */
         "onVegaHide"?: (event: VegaInputSelectCustomEvent<string>) => void;
+        /**
+          * An event emitter notifying that the suffix button associated with the field label has been clicked.
+          * @vegaVersion 2.68.0
+         */
+        "onVegaLabelButtonClick"?: (event: VegaInputSelectCustomEvent<any>) => void;
         /**
           * An event emitter notifying the search of the dropdown.
           * @vegaVersion 1.50.0
@@ -10289,6 +10335,11 @@ declare namespace LocalJSX {
           * @vegaVersion 1.11.0
          */
         "label"?: string;
+        /**
+          * 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__
+         */
+        "labelSuffixButtonConfig"?: Nullable<LabelSuffixButtonConfig>;
         /**
           * Specifies the maximum number of characters (UTF-16 code units)    that the user can enter in the text area.
           * @vegaVersion 1.11.0
@@ -10311,6 +10362,12 @@ declare namespace LocalJSX {
           * @vegaVersion 2.0.0
          */
         "onChange"?: (event: VegaTextareaCustomEvent<string>) => void;
+        /**
+          * An event emitter notifying that the suffix button associated with the field label has been clicked.
+          * @eventSemantics namespace:native
+          * @vegaVersion 2.68.0
+         */
+        "onLabelButtonClick"?: (event: VegaTextareaCustomEvent<any>) => void;
         /**
           * An event emitter notifying the blur event of the inner    textarea element within the text area.
           * @vegaVersion 1.11.0
@@ -10321,6 +10378,11 @@ declare namespace LocalJSX {
           * @vegaVersion 1.11.0
          */
         "onVegaChange"?: (event: VegaTextareaCustomEvent<string>) => void;
+        /**
+          * An event emitter notifying that the suffix button associated with the field label has been clicked.
+          * @vegaVersion 2.68.0
+         */
+        "onVegaLabelButtonClick"?: (event: VegaTextareaCustomEvent<any>) => void;
         /**
           * Specifies a placeholder string that displays as a    temporary hint or example within the text area.  It indicates the expected format or pattern of    the input within the text area.
           * @vegaVersion 1.11.0

package/dist/types/helpers/calendar/calendar-date-time.d.ts

@@ -0,0 +1,76 @@
+import { CalendarTime } from './calendar-time';
+import { CalendarDate } from './calendar-date';
+export declare type CalendarDateTimeOptions = {
+  timezone: string;
+  time?: string;
+  endTimeMissing?: boolean;
+};
+/**
+ * CalendarDateTime centralizes timezone-aware conversions between native Date instances and calendar helpers.
+ */
+export declare class CalendarDateTime {
+  private originalDate;
+  private timezone;
+  private date;
+  private time;
+  private constructor();
+  /**
+   * 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: Date, timezone: string): CalendarDateTime;
+  /**
+   * 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: string | Date, options: CalendarDateTimeOptions): CalendarDateTime;
+  /**
+   * Get the CalendarDate instance representing the date portion.
+   *
+   * @returns {CalendarDate} The CalendarDate object.
+   */
+  get calendarDate(): CalendarDate;
+  /**
+   * Get the CalendarTime instance representing the time portion.
+   *
+   * @returns {CalendarTime} The CalendarTime object.
+   */
+  get calendarTime(): CalendarTime;
+  /**
+   * Get a native Date object representing this CalendarDateTime.
+   *
+   * @returns {Date} The native Date object.
+   */
+  toDate(): Date;
+  /**
+   * Set a new timezone and update CalendarDate/CalendarTime accordingly.
+   *
+   * @param {string} newTimezone - The new timezone to set.
+   */
+  setTimezone(newTimezone: string): void;
+  /**
+   * Sync CalendarDate and CalendarTime with the current originalDate and timezone.
+   */
+  private syncDateTime;
+  /**
+   * Convert a Date to the specific timezone.
+   *
+   * @param {Date} date - The date to convert.
+   * @returns {Date} The date adjusted to the specific timezone.
+   */
+  private convertDateToTimezone;
+  /**
+   * 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.
+   */
+  private findDateTimeFormatPart;
+}

package/dist/types/helpers/calendar/calendar-event.d.ts

@@ -2,17 +2,16 @@ import { VegaCalendarEventVariantType, VegaCalendarRawEvent } from '../../compon
 import { Nullable, TimeFormat } from '../../types/general';
 import { CalendarDate } from './calendar-date';
 import { CalendarPeriod } from './calendar-period/calendar-period.abstract';
+import { CalendarTime } from './calendar-time';
 /** 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. */
 export declare class CalendarEvent {
   private _event;
   private _eventKey;
-  private _startDate;
-  private _endDate;
-  private _startTime;
-  private _endTime;
+  private _startDateTime;
+  private _endDateTime;
   private _eventSpansDays;
   private repeatPattern;
-  private _timezone?;
+  private _timezone;
   /**
    * The constructor initializes a VegaCalendarRawEvent object and performs validation checks on required fields.
    *
@@ -86,17 +85,17 @@ export declare class CalendarEvent {
    */
   get endDate(): Date;
   /**
-   * 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(): string;
+  get startTime(): 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(): string;
+  get endTime(): CalendarTime;
   /**
    * This function returns the number of days that an event spans.
    *
@@ -148,7 +147,7 @@ export declare class CalendarEvent {
    *
    * @returns {number} the minutes
    */
-  getEventDuration(): number;
+  getEventMinutes(): number;
   /**
    * This function returns an array of repeat series based on a given calendar period.
    *
@@ -165,18 +164,6 @@ export declare class CalendarEvent {
    * @param {string} timezone - The new timezone to apply to the event
    */
   updateTimezone(timezone: string): void;
-  /**
-   * 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
-   */
-  private convertTimeTo24Hour;
   /**
    * The function `checkEventRequireField` validates the required fields of a calendar event item in TypeScript.
    *
@@ -194,46 +181,20 @@ export declare class CalendarEvent {
    */
   private initDate;
   /**
-   * 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.
    */
   private processStartDate;
   /**
-   * Process end date
+   * Parse the supplied end date/time, normalize into calendar wrappers.
    *
-   * @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
+   * @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.
    */
   private processEndDate;
-  /**
-   * Format time for display
-   *
-   * @param {Date} date - Date object
-   * @param {string} originalTime - Original time string
-   * @returns {string} Formatted time string
-   */
-  private formatTimeForDisplay;
-  /**
-   * 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
-   */
-  private getCurrentHourAndMinutes;
-  /**
-   * Converts a Date object to the target timezone
-   *
-   * @param {Date} date - The Date object to convert
-   * @returns {Date} A Date object representing the date/time in the target timezone
-   */
-  private convertDateToTimezone;
   /**
    * The function initializes a repeat pattern controller for a calendar event with specified start and end dates and repeat options.
    */

package/dist/types/helpers/calendar/calendar-time.d.ts

@@ -0,0 +1,64 @@
+export declare type TimeStringFormat = 'hh:mm' | 'hh:m' | 'h:m' | 'h:mm' | '12-hour' | '24-hour';
+/**
+ * CalendarTime represents hours/minutes in 24-hour format and centralizes parsing/formatting logic.
+ */
+export declare class CalendarTime {
+  private readonly _hours;
+  private readonly _minutes;
+  constructor(hours: number, minutes: number);
+  /**
+   * Parse a raw time string into a CalendarTime instance.
+   *
+   * @param {string} rawTime - Source time value such as "9:00" or "9am".
+   * @returns {CalendarTime} Parsed time.
+   */
+  static fromString(rawTime: string): CalendarTime;
+  /**
+   * Build a CalendarTime from a Date instance while preserving hours/minutes.
+   *
+   * @param {Date} date - The source date.
+   * @returns {CalendarTime} Time representation extracted from the date.
+   */
+  static fromDate(date: Date): CalendarTime;
+  /**
+   * Calculate the duration in the requested precision between two CalendarTime values, accounting for overnight spans.
+   *
+   * @param {CalendarTime} start - Start time of the interval.
+   * @param {CalendarTime} end - End time of the interval.
+   * @param {'minutes' | 'hours'} precision - Desired unit of measure for the result (defaults to minutes).
+   * @returns {number} Duration expressed in the requested precision.
+   */
+  static calculateDuration(start: CalendarTime, end: CalendarTime, precision?: 'minutes' | 'hours'): number;
+  /**
+   * Normalize various time inputs (e.g. 9am, 9:30 PM) to a 24-hour HH:mm string.
+   *
+   * @param {string} timeString - User supplied time value.
+   * @returns {string} 24-hour formatted string.
+   */
+  private static convertTimeTo24Hour;
+  /**
+   * Hour component in 24-hour clock.
+   *
+   * @returns {number} Hours between 0-23.
+   */
+  get hours(): number;
+  /**
+   * Minute component.
+   *
+   * @returns {number} Minutes between 0-59.
+   */
+  get minutes(): number;
+  /**
+   * Total minutes elapsed since midnight for this time value.
+   *
+   * @returns {number} Minutes from 00:00.
+   */
+  get totalMinutes(): number;
+  /**
+   * Format the time into a string using a simple formatter.
+   *
+   * @param {TimeStringFormat} format - time string Format. Defaults to 'hh:mm'.
+   * @returns {string} Formatted time string.
+   */
+  toString(format?: TimeStringFormat): string;
+}

package/dist/types/helpers/calendar/index.d.ts

@@ -7,4 +7,6 @@ export { DayPeriod } from './calendar-period/day-period';
 export { WeekPeriod } from './calendar-period/week-period';
 export { MonthPeriod } from './calendar-period/month-period';
 export { CalendarDate } from './calendar-date';
+export { CalendarDateTime } from './calendar-date-time';
+export { CalendarTime } from './calendar-time';
 export { CalendarView } from './calendar-view';

package/dist/types/helpers/calendar/test/calendar-date-time.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/helpers/calendar/test/calendar-time.test.d.ts

@@ -0,0 +1 @@
+export {};