@globalpayments/vega 2.70.0 → 2.75.1

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

@@ -1,3 +1,4 @@
+import { Nullable } from '../../types/general';
 export declare type DateCompareResult = {
   isPreviousMonth: boolean;
   isNextMonth: boolean;
@@ -7,6 +8,7 @@ export declare type DateCompareResult = {
  * Calendar date class
  */
 export declare class CalendarDate {
+  private static readonly MONTHS;
   private _year;
   private _month;
   private _date;
@@ -19,6 +21,37 @@ export declare class CalendarDate {
    * @returns {CalendarDate} - Return a CalendarDate object
    */
   static from(currentDate: Date, timezone?: string): CalendarDate;
+  /**
+   * Converts a date string to CalendarDate with optional format and timezone parameters.
+   *
+   * @param {string} dateString - The string date.
+   * @param {string} [format] - The format of string date
+   * @param {string} [lang] - lang
+   * @returns {Nullable<CalendarDate>} - CalendarDate.
+   */
+  static fromString(dateString: string, format?: string, lang?: string): Nullable<CalendarDate>;
+  /**
+   * Get regex pattern by format token.
+   *
+   * @param {string} token - The format token.
+   * @param {string} lang - Language.
+   * @returns {FormatPatternType} - regex pattern.
+   */
+  private static getPatternByFormatToken;
+  /**
+   * Shorts months.
+   *
+   * @param {string} lang - Language
+   * @returns {string[]} - Shorts months.
+   */
+  private static shortMonths;
+  /**
+   * Long months.
+   *
+   * @param {string} lang - Language
+   * @returns {string[]} - Long months.
+   */
+  private static longMonths;
   /**
    * The year of the calendar date
    *
@@ -40,6 +73,14 @@ export declare class CalendarDate {
    */
   get date(): number;
   set date(value: number);
+  /**
+   * Converts CalendarDate to a string with an optional format specifier.
+   *
+   * @param {string} [format] - The format of string date
+   * @param {string} [lang] - Language
+   * @returns {string} The string date.
+   */
+  toString(format?: string, lang?: string): string;
   /**
    * Verify whether the calendar date is today
    *
@@ -63,11 +104,11 @@ export declare class CalendarDate {
   /**
    * The function "equal" compares the year, month, and date of two CalendarDate objects and returns  true if they are equal.
    *
-   * @param {CalendarDate} calendarDate - The `equal` method in the code snippet is a function that compares the year, month, and date of the current `CalendarDate` object with another
+   * @param {Nullable<CalendarDate>} calendarDate - The `equal` method in the code snippet is a function that compares the year, month, and date of the current `CalendarDate` object with another
    * `CalendarDate` object passed as a parameter. The method returns `true` if all three values (year, month, date) are equal
    * @returns {boolean} The date is same day with current
    */
-  equal(calendarDate: CalendarDate): boolean;
+  equal(calendarDate: Nullable<CalendarDate>): boolean;
   /**
    * Get month name.
    *
@@ -75,4 +116,47 @@ export declare class CalendarDate {
    * @returns {string} The name of the month
    */
   getMonthName(isShortName?: boolean): string;
+  /**
+   * To determine if it is larger than a given `CalendarDate`.
+   *
+   * @param {Nullable<CalendarDate>} calendarDate - A `CalendarDate`
+   * @returns {boolean} - Compared result
+   */
+  isAfter(calendarDate: Nullable<CalendarDate>): boolean;
+  /**
+   * To determine if it is less than a given `CalendarDate`.
+   *
+   * @param {Nullable<CalendarDate>} calendarDate - A `CalendarDate`
+   * @returns {boolean} - Compared result
+   */
+  isBefore(calendarDate: Nullable<CalendarDate>): boolean;
+  /**
+   * Get first day of month.
+   *
+   * @returns {CalendarDate} - First day of month.
+   */
+  firstDateOfMonth(): CalendarDate;
+  /**
+   * Get last day of month.
+   *
+   * @returns {CalendarDate} - Last day of month.
+   */
+  lastDateOfMonth(): CalendarDate;
+  /**
+   * Adjusts the calendar date by adding the specified number of years, months, and days.
+   *
+   * @param {number} [years=0] - The number of years to add.
+   * @param {number} [months=0] - The number of months to add.
+   * @param {number} [days=0] - The number of days to add.
+   * @returns {CalendarDate} - A new CalendarDate object with the adjusted date.
+   */
+  add(years?: number, months?: number, days?: number): CalendarDate;
+  /**
+   * Get year, month and day value by format token.
+   *
+   * @param {string} token - The format token.
+   * @param {string} lang - Language.
+   * @returns {string} - year, month and day value.
+   */
+  private getDateItemByFormatToken;
 }

package/dist/types/helpers/calendar/calendar-period/calendar-period.abstract.d.ts

@@ -67,6 +67,13 @@ export declare abstract class CalendarPeriod {
    * @returns {this} - The current period.
    */
   now(): this;
+  /**
+   * Check the give period is equal to current period
+   *
+   * @param {CalendarPeriod} [period] - Give period to compare
+   * @returns {boolean} compare result
+   */
+  equal(period: CalendarPeriod): boolean;
   /**
    * Calculate the period start date and end date.
    *

package/dist/types/helpers/code-format/code-formatter.d.ts

@@ -6,7 +6,20 @@ export declare type CodeFormatOptions = {
  * Class to format HTML code with proper indentation and style cleanup.
  */
 declare class CodeFormatter {
+  /**
+   * Inline/phrasing elements that should be kept on a single line with their content.
+   * These tags are formatted as: <tag>content</tag> on one line.
+   */
   private static readonly INLINE_TAGS;
+  /**
+   * Void/self-closing elements that don't have closing tags.
+   * Used to avoid increasing indentation for these elements.
+   */
+  private static readonly VOID_TAGS;
+  /**
+   * Tags whose content should be preserved as-is without formatting.
+   */
+  private static readonly PRESERVE_CONTENT_TAGS;
   /**
    * Extracts the tag name from an HTML tag string.
    *
@@ -16,6 +29,7 @@ declare class CodeFormatter {
   private static getTagName;
   /**
    * Formats a given HTML source string by applying indentation and cleaning up styles.
+   * Content inside preserve tags (pre) is preserved as-is without formatting.
    *
    * @param {string} source - The HTML source string to format.
    * @param {CodeFormatOptions} options - Formatting options.

package/dist/types/helpers/event-manager/event-id/vega-event-id.d.ts

@@ -93,7 +93,11 @@ export declare const VegaRetry: VegaEventID;
 export declare const VegaPreview: VegaEventID;
 export declare const VegaLabelButtonClick: VegaEventID;
 export declare const VegaReset: VegaEventID;
-export declare const VegaMonthYearChange: VegaEventID;
+export declare const VegaClear: VegaEventID;
 export declare const VegaComplete: VegaEventID;
 export declare const VegaPaste: VegaEventID;
 export declare const HTMLNativeEventIds: VegaEventID[];
+export declare const VegaMonthYearChange: VegaEventID;
+export declare const VegaSelectionChange: VegaEventID;
+export declare const VegaSuggestionItemClick: VegaEventID;
+export declare const VegaNativeInputChange: VegaEventID;

package/dist/types/helpers/event-manager/event-id/vega-internal-event-id.d.ts

@@ -34,7 +34,6 @@ export declare const VegaInternalSidenavLinkClick: VegaInternalEventID;
 export declare const VegaInternalLeftNavGroupExpand: VegaInternalEventID;
 export declare const VegaInternalLeftNavLinkSelected: VegaInternalEventID;
 export declare const VegaInternalInitializeLeftNavLinkSelected: VegaInternalEventID;
-export declare const VegaInternalDropdownUpdateTarget: VegaInternalEventID;
 export declare const VegaInternalRichTextEditorFlushChanges: VegaInternalEventID;
 export declare const VegaInternalRichTextEditorSelectionRangeChange: VegaInternalEventID;
 export declare const VegaInternalRichTextImageClick: VegaInternalEventID;
@@ -54,8 +53,15 @@ export declare const VegaInternalColumnBodyCellRenderInputRIC: VegaInternalEvent
 export declare const VegaInternalCalendarEventPreviewUpdate: VegaInternalEventID;
 export declare const VegaInternalCalendarEventPreviewClear: VegaInternalEventID;
 export declare const VegaInternalUpdateRTECursorPosition: VegaInternalEventID;
-export declare const VegaInternalMonthYearChange: VegaInternalEventID;
 export declare const VegaInternalLeftNavLinkSelectedTopic: VegaInternalEventID;
 export declare const VegaInternalCalendarEventPreviewHide: VegaInternalEventID;
 export declare const VegaInternalFormSubmit: VegaInternalEventID;
 export declare const VegaInternalFormReset: VegaInternalEventID;
+export declare const VegaInternalProgressTrackerStepClick: VegaInternalEventID;
+export declare const VegaInternalDatePickerCalendarSelectionChange: VegaInternalEventID;
+export declare const VegaInternalDatePickerCalendarInputClick: VegaInternalEventID;
+export declare const VegaInternalDatePickerCalendarClear: VegaInternalEventID;
+export declare const VegaInternalDatePickerCalendarUpdatePeriodByUser: VegaInternalEventID;
+export declare const VegaInternalUpdateVegaInputValue: VegaInternalEventID;
+export declare const VegaInternalFocusVegaInput: VegaInternalEventID;
+export declare const VegaInternalSetupVegaInputMaskConfig: VegaInternalEventID;

package/dist/types/helpers/slimmers/element-appender/element-appender-slimmer.d.ts

@@ -2,15 +2,9 @@ import { VegaSlimmer } from '../../../vega-slimmer/vega-slimmer-core';
 import { ElementAppender, ElementAppenderShowConfig } from '../../ui/element-appender';
 import { Nullable } from '../../../types/general';
 import { ElementAppenderHierarchyTreeManager } from './element-appender-hierarchy-tree-manager';
+import { VegaEATriggerType } from '../../../types/ui.type';
 declare type ShowConfigFactoryType = () => ElementAppenderShowConfig;
-/**
- * - click: means the dropdown show/hide by click, it also listen global area click. example: VegaPopover
- * - hover: means the dropdown show/hide by hover, it also listen global area click. example: VegaDropdown VegaAppHeaderButton
- * - none: means element appender not listens any event, you should control the dropdown show/hide in component. example: VegaDatePicker
- * - custom: means element appender only listen the outer area click. when clicked the dropdown will hide. example: VegaTimePicker
- */
-declare type TriggerType = 'click' | 'hover' | 'none' | 'custom';
-declare type GetTriggerType = () => TriggerType;
+declare type GetTriggerType = () => VegaEATriggerType;
 declare type DisableInteractiveGetter = () => boolean;
 export declare class ElementAppenderSlimmer extends VegaSlimmer {
   private static readonly DELAY_HIDE_TIME;
@@ -58,7 +52,6 @@ export declare class ElementAppenderSlimmer extends VegaSlimmer {
   private globalScrollHandler;
   private createDelayHideTimer;
   private clearDelayHideTimer;
-  private shouldListenerWork;
   /**
    * Sets up an observer to handle scroll events in a shadow root element.
    */
@@ -74,5 +67,7 @@ export declare class ElementAppenderSlimmer extends VegaSlimmer {
    * Remove observer for scrolling in a shadow root element.
    */
   private removeShadowRootElementScrolling;
+  private executeTriggerStrategy;
+  private getTriggerStrategy;
 }
 export {};

package/dist/types/helpers/slimmers/element-appender/trigger-strategies/click-outside-only-to-dismiss-strategy.d.ts

@@ -0,0 +1,21 @@
+import { VegaEAEventType } from '../../../../types/ui.type';
+import { VegaEATriggerStrategy, VegaEATriggerContext, VegaEATriggerResult } from './trigger-strategy.interface';
+/**
+ * A trigger strategy that hides the appendable element when a global mouse down event occurs outside the element.
+ */
+export declare class ClickOutsideOnlyToDismissStrategy implements VegaEATriggerStrategy {
+  /**
+   * Determines if the strategy can evaluate the given event type.
+   *
+   * @param {VegaEAEventType} type - The type of the event.
+   * @returns {boolean} True if the event type is 'globalMouseDown', otherwise false.
+   */
+  canEvaluate(type: VegaEAEventType): boolean;
+  /**
+   * Evaluates the trigger context and determines whether to hide the appendable element.
+   *
+   * @param {VegaEATriggerContext} context - The context of the trigger event.
+   * @returns {VegaEATriggerResult} An object indicating whether to hide the appendable element.
+   */
+  evaluate(context: VegaEATriggerContext): VegaEATriggerResult;
+}

package/dist/types/helpers/slimmers/element-appender/trigger-strategies/click-trigger-strategy.d.ts

@@ -0,0 +1,21 @@
+import { VegaEAEventType } from '../../../../types/ui.type';
+import { VegaEATriggerStrategy, VegaEATriggerContext, VegaEATriggerResult } from './trigger-strategy.interface';
+/**
+ * ClickTriggerStrategy handles 'targetClick' and 'globalMouseDown' events to toggle or hide the appendable element.
+ */
+export declare class ClickTriggerStrategy implements VegaEATriggerStrategy {
+  /**
+   * Determines if the strategy can evaluate the given event type.
+   *
+   * @param {VegaEAEventType} type - The type of the event.
+   * @returns {boolean} True if the event type is 'targetClick' or 'globalMouseDown', otherwise false.
+   */
+  canEvaluate(type: VegaEAEventType): boolean;
+  /**
+   * Evaluates the trigger context and determines whether to show, hide, or toggle the appendable element.
+   *
+   * @param {VegaEATriggerContext} context - The context of the trigger event.
+   * @returns {VegaEATriggerResult} An object indicating whether to show, hide, or toggle the appendable element.
+   */
+  evaluate(context: VegaEATriggerContext): VegaEATriggerResult;
+}

package/dist/types/helpers/slimmers/element-appender/trigger-strategies/hover-trigger-strategy.d.ts

@@ -0,0 +1,22 @@
+import { VegaEAEventType } from '../../../../types/ui.type';
+import { VegaEATriggerStrategy, VegaEATriggerContext, VegaEATriggerResult } from './trigger-strategy.interface';
+/**
+ * HoverTriggerStrategy handles mouse enter and leave events on the target and appendable elements,
+ * as well as global mouse down events to show or hide the appendable element.
+ */
+export declare class HoverTriggerStrategy implements VegaEATriggerStrategy {
+  /**
+   * Determines if the strategy can evaluate the given event type.
+   *
+   * @param {VegaEAEventType} type - The type of the event.
+   * @returns {boolean} True if the event type is related to hover actions or global mouse down, otherwise false.
+   */
+  canEvaluate(type: VegaEAEventType): boolean;
+  /**
+   * Evaluates the trigger context and determines whether to show, hide, or toggle the appendable element.
+   *
+   * @param {VegaEATriggerContext} context - The context of the trigger event.
+   * @returns {VegaEATriggerResult} An object indicating whether to show, hide, or toggle the appendable element.
+   */
+  evaluate(context: VegaEATriggerContext): VegaEATriggerResult;
+}

package/dist/types/helpers/slimmers/element-appender/trigger-strategies/none-trigger-strategy.d.ts

@@ -0,0 +1,18 @@
+import { VegaEATriggerResult, VegaEATriggerStrategy } from './trigger-strategy.interface';
+/**
+ * NoneTriggerStrategy does not respond to any events and always indicates no action.
+ */
+export declare class NoneTriggerStrategy implements VegaEATriggerStrategy {
+  /**
+   * Determines if the strategy can evaluate the given event type.
+   *
+   * @returns {boolean} Always false as this strategy does not respond to any events.
+   */
+  canEvaluate(): boolean;
+  /**
+   * Evaluates the trigger context and always indicates no action.
+   *
+   * @returns {VegaEATriggerResult} An object indicating no action (no show, hide, or toggle).
+   */
+  evaluate(): VegaEATriggerResult;
+}

package/dist/types/helpers/slimmers/element-appender/trigger-strategies/trigger-strategy.interface.d.ts

@@ -0,0 +1,37 @@
+import { VegaEAEventType } from '../../../../types/ui.type';
+/**
+ * Context for evaluating trigger strategies.
+ *
+ * @param target - The target HTMLElement that the appendable element is associated with.
+ * @param appendableElement - The HTMLElement that is to be shown or hidden.
+ * @param htmlEvent - The html event that triggered the evaluation.
+ * @param eventType - The trigger type of the event.
+ * @param currentState - The current visibility state of the appendable element.
+ */
+export interface VegaEATriggerContext {
+  target: HTMLElement;
+  appendableElement: HTMLElement;
+  htmlEvent: Event;
+  eventType: VegaEAEventType;
+  currentState: {
+    isVisible: boolean;
+  };
+}
+/**
+ * Interface for trigger strategies that determine when to show, hide, or toggle appendable elements.
+ *
+ * @function canEvaluate - Determines if the strategy can evaluate the given event type.
+ * @function evaluate - Evaluates the trigger context and returns the action to be taken.
+ */
+export interface VegaEATriggerStrategy {
+  canEvaluate(type: VegaEAEventType): boolean;
+  evaluate(context: VegaEATriggerContext): VegaEATriggerResult;
+}
+/**
+ * Result of evaluating a trigger strategy.
+ *
+ * @param nextAction - The next action to be taken: 'show' to display the appendable element, 'hide' to conceal it.
+ */
+export interface VegaEATriggerResult {
+  nextAction?: 'show' | 'hide';
+}

package/dist/types/helpers/ui/element-appender.d.ts

@@ -86,6 +86,20 @@ export declare class ElementAppender {
    * @param {boolean} show remove hidden style if true, otherwise add it
    */
   private toggleShow;
+  /**
+   * Show the appendable element by removing hidden styles
+   * TODO: should directly control display style. https://gethired.atlassian.net/browse/VD-7884
+   *
+   * @param {HTMLElement} appendableElement - Appendable element controlled by ElementAppender
+   */
+  private showElementAppender;
+  /**
+   * Hide the appendable element by adding hidden styles.
+   * TODO: should directly control display style. https://gethired.atlassian.net/browse/VD-7884
+   *
+   * @param {HTMLElement} appendableElement - Appendable element controlled by ElementAppender
+   */
+  private hideElementAppender;
   /**
    * Save visible AppendableElement from the container state
    *

package/dist/types/types/components.type.d.ts

@@ -32,6 +32,7 @@ export {
 	TextAlignType,
 	TranslocationType,
 	VegaComponentInterface,
+	VegaEATriggerType,
 	VegaFlexProps,
 	WidthType,
 } from '../types/ui.type';
@@ -115,10 +116,13 @@ export {
 export { VegaCodeBlockValue } from '../components/vega-code-block/types';
 export { VegaComboBoxSize, VegaDropdownPropsForComboBox } from '../components/vega-combo-box/types';
 export {
+	DatePickerCalendarRepickType,
+	DatePickerCalendarSizeType,
 	DatePickerModeType,
 	DatePickerMonthYearTypes,
 	DatePickerValueType,
 	DropdownConfigForDatePicker,
+	VegaDropdownPropsForDatePickerCalendar,
 } from '../components/vega-date-picker/types';
 export { VegaDialogAction, VegaDialogActionButtonProps } from '../components/vega-dialog/types';
 export { VegaDividerDirectionType, VegaDividerVariantType } from '../components/vega-divider/interface';
@@ -143,12 +147,14 @@ export {
 	InputType,
 	InputValueUpdateTriggeredBy,
 	MaskConfigType,
+	VegaInputSuggestionsDropdownConfig,
 } from '../components/vega-input/types';
 export { FormFieldValidationRule as FormFieldValidationRule1 } from '../types/components.type';
 export { VegaCountryType } from '../components/vega-input-phone-number/types';
 export { InputRangeStackType, InputRangeValueType } from '../components/vega-input-range/types';
 export {
 	SelectedLabelType,
+	SelectedLabelTypeForAllModes,
 	SelectSourceItem,
 	SelectType,
 	SelectValueType,
@@ -177,6 +183,7 @@ export {
 	VegaPaginationLayoutType,
 } from '../components/vega-pagination/types';
 export { PieChartOptions } from '../helpers/chart/pie-chart';
+export { VegaProgressTrackerDirectionType } from '../components/vega-progress-tracker/type';
 export { VegaRTEContent } from '../components/vega-rich-text-editor/dto/content-state';
 export { VegaRTEExtension } from '../components/vega-rich-text-editor/extensions/extension.abstract';
 export {

package/dist/types/types/type-guard.d.ts

@@ -4,6 +4,8 @@ import { SelectSourceItem } from '../components/vega-input-select/types';
 import { DropdownSourceItem } from '../components/vega-dropdown/types';
 import { Nullable } from './general';
 import { VegaTableColumnGroupingModel } from '../components/vega-table/interface';
+import { CalendarDate } from '../helpers/calendar';
+import { VegaEATriggerStrategy } from '../helpers/slimmers/element-appender/trigger-strategies/trigger-strategy.interface';
 /**
  * Returns true if the input is a string that is one of the four directions.
  *
@@ -292,3 +294,17 @@ export declare const isCssStateType: (input: CssStatesType) => input is "default
  * @returns {input is VegaTableColumnGroupingModel} True when input matches the grouping model shape.
  */
 export declare const isVegaTableColumnGroupingModelType: (input: unknown) => input is VegaTableColumnGroupingModel;
+/**
+ * Check is calendar date type
+ *
+ * @param {unknown} input - Value to test.
+ * @returns {input is CalendarDate} True when input matches the calendar date type.
+ */
+export declare const isCalendarDateType: (input: unknown) => input is CalendarDate;
+/**
+ * Type guard to check if the provided instance implements the VegaEATriggerStrategy interface
+ *
+ * @param {unknown} instance - The instance to check.
+ * @returns {instance is VegaEATriggerStrategy} True if the instance implements VegaEATriggerStrategy.
+ */
+export declare const isEATriggerStrategy: (instance: unknown) => instance is VegaEATriggerStrategy;

package/dist/types/types/ui.type.d.ts

@@ -4,6 +4,7 @@ import { Placements, FlexDirections, Alignments, BoxDisplay, VegaNativeEventName
 import { HTMLStencilElement } from '../stencil-public-runtime';
 import { GridColumns, GridRows } from '../constants/tokens/tailwind.extend';
 import { JSX as LocalJSX } from '../components';
+import { VegaEATriggerStrategy } from '../helpers/slimmers/element-appender/trigger-strategies/trigger-strategy.interface';
 export declare type BrowserVisibleArea = {
   top: number;
   bottom: number;
@@ -156,3 +157,11 @@ export declare type IconAlignType = 'left' | 'right';
 export declare type BorderStyleType = 'solid' | 'dashed' | 'dotted' | 'double' | 'none';
 export declare type TextAlignType = 'start' | 'end' | 'left' | 'right' | 'center' | 'justify';
 export declare type VegaFlexProps = Partial<Pick<HTMLVegaFlexElement, 'gap' | 'direction' | 'alignItems' | 'justifyContent' | 'margin'>>;
+/**
+ * - click: means the dropdown show/hide by click, it also listen global area click. example: VegaPopover
+ * - hover: means the dropdown show/hide by hover, it also listen global area click. example: VegaDropdown VegaAppHeaderButton
+ * - none: means element appender not listens any event, you should control the dropdown show/hide in component. example: VegaDatePicker
+ * - VegaEATriggerStrategy: means element appender use custom trigger strategy to control show/hide behavior.
+ */
+export declare type VegaEATriggerType = 'click' | 'hover' | 'none' | VegaEATriggerStrategy;
+export declare type VegaEAEventType = 'target-click' | 'target-mouseenter' | 'target-mouseleave' | 'element-mouseenter' | 'element-mouseleave' | 'click-outside';

package/dist/types/utils/date.d.ts

@@ -1,6 +1,13 @@
 import { Nullable, TimeFormat } from '../types/general';
 /**
- * It returns true if the input is a valid date string, and false otherwise
+ * It returns true if the input is a valid date string, and false otherwise.
+ * Note:
+ *  This is not a strict date validation, it just use Date.parse to check the input string can be parsed to a valid date or not.
+ *  For strict date validation, please use CalendarDate.fromString method in calendar-date.ts
+ *  Example:
+ *      For Chrome: Date.parse('Jan/08/2026') => 1767801600000
+ *      For Safari: Date.parse('Jan/08/2026') => NaN
+ *      Format is DD/MM/YYYY: Date.parse('20/11/2024') => NaN
  *
  * @param {string} input - The string to check.
  * @returns {boolean} is a valid date string or not
@@ -42,9 +49,11 @@ export declare const isTimeStr: (input: string, timeFormat: TimeFormat) => boole
  * It takes a number and returns a string
  *
  * @param {number} number - number - The number to pad
+ * @param {number} [length=2] - The length of the resulting string.
+ * @param {string} [padChar='0'] - The character to pad the number with.
  * @returns {Nullable<string>} A function that takes a number as an argument and returns a nullable string.
  */
-export declare const pad: (number: number) => Nullable<string>;
+export declare const pad: (number: number, length?: number, padChar?: string) => Nullable<string>;
 /**
  * The `convert12HourTo24HourFormat` function takes a time string in 12-hour format and converts it to 24-hour format.
  *

package/dist/types/utils/e2e-utils.d.ts

@@ -4,6 +4,10 @@ import * as axe from 'axe-core';
 import { EventSemanticsConfig } from '../helpers/event-manager/internal-vega-event-manager';
 import { ElementHandle } from 'puppeteer';
 export declare type TestDeviceType = 'iPhone8-Plus' | 'iPad-Air';
+declare type InjectFeatureFlagsConfig = {
+  enabled?: string[];
+  disabled?: string[];
+};
 /**
  * NOTE: This method is only for **E2E** test cases.
  * Clear the input field and type the input
@@ -91,12 +95,14 @@ export declare const getScreenshotDiffResults: (page: E2EPage, desc: string, sel
  * @param {EventSemanticsConfig} config.eventSemanticsConfig - sets the event semantics configuration for the EventManager
  * @param {string} config.date --sets the date want to mock
  * @param {number} config.timeout --sets the content timeout
+ * @param {InjectFeatureFlagsConfig} config.featureFlags -inject feature flags.
  */
 export declare const initVegaE2EPage: (content: string, config?: {
   wrapped?: boolean;
   eventSemanticsConfig?: EventSemanticsConfig;
   date?: string;
   timeout?: number;
+  featureFlags?: InjectFeatureFlagsConfig;
 }) => Promise<E2EPage>;
 /**
  * NOTE: This method is only for **E2E** test cases.
@@ -137,3 +143,4 @@ export declare const getComputedStyle: (page: E2EPage, handler: ElementHandle<El
  * @returns {Promise<void>} -
  */
 export declare const injectE2EFontAwesomeLib: (page: E2EPage) => Promise<void>;
+export {};

package/dist/types/utils/sanitize.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Helper utilities for sanitizing string from harmful tags
+ * This utility is intentionally restrictive of allowed tags depending on expected output.
+ *
+ * - Uses DOM-based parsing (no regex)
+ * - All attributes are stripped
+ * - Disallowed elements are unwrapped (children preserved)
+ */
+export declare class SanitizeUtility {
+  /**
+   * Set of allowed HTML tags for label rendering.
+   * Tags must be uppercase to match DOMParser element.tagName output.
+   */
+  private static readonly LABEL_ALLOWED_TAGS;
+  /**
+   * It cleans up string for labels and allow minor formatting like bold, italic, strong
+   *
+   * @param {string} input - the passed label input string for sanitization
+   * @returns {string} returns sanitized string
+   */
+  static sanitizeHtmlLabel(input: string): string;
+  /**
+   * Sanitizes the provided HTML string by parsing it into a DOM tree and
+   * removing all disallowed elements and attributes.
+   *
+   * @param {string} input - raw HTML string to sanitize
+   * @param {ReadonlySet<string>} allowedTags - set of allowed HTML tag names
+   * @returns {string} sanitized HTML string
+   */
+  private static sanitize;
+  /**
+   * Sanitizes a DOM node recursively.
+   * - Text nodes are preserved
+   * - Element nodes are sanitized based on allowed tags
+   * - Other node types are discarded
+   *
+   * @param {Node} node - DOM node to sanitize
+   * @param {ReadonlySet<string>} allowedTags - set of allowed HTML tag names
+   * @param {Document} doc - document reference
+   * @returns {Nullable<Node>} sanitized node or null if not allowed
+   */
+  private static sanitizeNode;
+  /**
+   * Sanitizes an HTML element.
+   * - If the element tag is not allowed, it is removed but its children are preserved
+   * - If allowed, a clean element is created with no attributes
+   *
+   * @param {HTMLElement} element - element to sanitize
+   * @param {ReadonlySet<string>} allowedTags - set of allowed HTML tag names
+   * @param {Document} doc - document reference
+   * @returns {Node} sanitized node or fragment
+   */
+  private static sanitizeElement;
+  /**
+   * Serializes a DocumentFragment back into an HTML string.
+   *
+   * @param {DocumentFragment} fragment - fragment to serialize
+   * @param {Document} doc - document reference
+   * @returns {string} serialized HTML string
+   */
+  private static serializeFragment;
+}
+/**
+ * Standalone helper (keeps parity with existing utility exports pattern)
+ *
+ * It cleans up string for labels and allow minor formatting like bold, italic, strong
+ *
+ * @param {string} input - the passed label input string for sanitization
+ * @returns {string} returns sanitized string
+ */
+export declare function sanitizeHtmlLabel(input: string): string;

package/dist/types/utils/test/sanitize.test.d.ts

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

package/dist/vega/index.esm.js

@@ -1 +1 @@
-export{g as getCurrentBreakpoint}from"./p-7d9cd9c8.js";export{L as LogUtility,s as setVegaLogLevel}from"./p-6e1ab235.js";export{d as formatAndValidBackgroundColor,e as formatAndValidBorderColor,g as formatAndValidBorderRadius,c as formatAndValidBreakpointSize,a as formatAndValidGap,h as formatAndValidPadding,f as formatAndValidResponsiveToken,b as formatAndValidShadow,i as formatAndValidTextColor}from"./p-1372b984.js";export{c as camelToDashCase}from"./p-02841589.js";export{d as BackgroundColorMap,a as BackgroundColors,e as BorderColorMap,b as BorderColors,B as BorderRadius,C as Colors,F as FillBackgroundColors,g as ShadowMap,f as Shadows,h as Spacing,S as StrokeBackgroundColors,c as TextColorMap,T as TextColors}from"./p-b1faebe0.js";export{B as Breakpoints}from"./p-ed45b3b6.js";export{I as Icons,g as getIconFromToken}from"./p-16493e5b.js";export{b as Typography,a as TypographyKeys,T as TypographyUrls}from"./p-d884c644.js";export{e as BoxDisplay,B as BreakpointKeys,C as CssStates,F as FlexDirections}from"./p-74168615.js";export{F as FrameworkEnum,v as VegaEnvManager}from"./p-5f377954.js";export{A as ActionHandlerInterceptor,I as InsertNodeToNearestRootAction,l as RTETokenNode,m as RTETokenNodeRenderer,R as RTETokenToolbarButtonRenderer,c as VegaDialog,d as VegaEventManager,V as VegaLoader,a as VegaNotify,j as VegaRTEExtension,k as VegaRTEExtensionRenderer,h as VegaRTEFunctionExtension,g as VegaRTETokenExtension,i as VegaRTEToolbarButtonRenderer,f as VegaSkeletonLoader,b as VegaThemeManager,e as VegaZIndexManager}from"./p-b8b9ed2c.js";export{F as FeatureFlag}from"./p-e77a83e4.js";export{B as VegaJQueryDelegatedEventStrategy}from"./p-bccee21e.js";export{V as VegaIconManager}from"./p-8c9ea6f4.js";export{V as ValidCreditCardNumberRule}from"./p-9ce249a9.js";export{w as waitForVega}from"./p-8350506e.js";export{a as VegaTranslation,s as VegaTranslationResourceEN}from"./p-f69f84a7.js";export{B as BlockToRTEBlockStrategyAbstract,b as ElementToDTOStrategy,I as InsertNewParagraphAction,d as RTEImageBlock,f as RTEImageNode,e as RTEListBlock,c as RTEListItemBlock,U as UpdateCursorPositionAction,V as VegaRTEContent,h as htmlElementToAnnotationGenerator}from"./p-4e13a26f.js";export{s as setVegaNonce}from"./p-4866e390.js";export{d as ActionHandleStrategy,h as AppendChildrenAction,Q as CodeLanguage,w as CustomAttributeAnnotation,v as CustomClassAnnotation,C as CustomStyleAnnotation,I as InsertChildrenAfterAction,j as InsertChildrenBeforeAction,M as ModifyContentAction,c as ModifyContentActionType,g as RTEAnnotationStyle,f as RTEBlock,z as RTEDecoratorNode,i as RTENode,e as RTETextBlock,b as RTETextNode,r as RemoveChildrenAction,V as VegaRTEPresetToolbarItems}from"./p-0cdb38d3.js";export{R as RTELanguageToolbarButtonRenderer,V as VegaRTELanguageExtension}from"./p-2f09c6aa.js";export{R as RTERange}from"./p-b9798158.js";export{G as GridColumns,a as GridRows}from"./p-1bb0c934.js";export{C as CheckBoxRequiredRule}from"./p-590fd123.js";export{D as DateRequiredRule}from"./p-8fae8f9e.js";export{I as InputPhoneNumberRequiredRule}from"./p-07c2725a.js";export{I as InputRangeRequiredRule}from"./p-f396c69a.js";export{R as RequiredFieldRule}from"./p-280cbcdb.js";export{R as RichTextEditorRequiredRule}from"./p-4a467973.js";export{T as TimeRangeRequiredRule,a as TimeRequiredRule}from"./p-924b4e24.js";export{T as ToggleSwitchRequiredRule}from"./p-7c0b4c36.js";export{F as FileUploaderRequiredRule}from"./p-0bb860cc.js";import"./p-b75ee3ba.js";import"./p-824a06ba.js";import"./p-a4670e23.js";import"./p-6a334573.js";import"./p-d9671d27.js";import"./p-ef9cbad1.js";import"./p-a528714c.js";import"./p-2d0d575f.js";import"./p-331a62d5.js";import"./p-112455b1.js";import"./p-262ec334.js";import"./p-a7b5f497.js";import"./p-447c7590.js";import"./p-db8cdba6.js";import"./p-abd7aeaa.js";import"./p-5d676a94.js";import"./p-308aa2e3.js";import"./p-bf19682d.js";import"./p-0c667d6a.js";import"./p-d27ae9ff.js";import"./p-08835909.js";const o=["ring-input-focus","dark-ring-input-focus","ring-input-danger-focus","dark-ring-input-danger-focus","ring-action-focus","dark-ring-action-focus","ring-action-danger-focus","dark-ring-action-danger-focus"];export{o as Rings}
+export{g as getCurrentBreakpoint}from"./p-10ac8b57.js";export{L as LogUtility,s as setVegaLogLevel}from"./p-6e1ab235.js";export{d as formatAndValidBackgroundColor,e as formatAndValidBorderColor,g as formatAndValidBorderRadius,c as formatAndValidBreakpointSize,a as formatAndValidGap,h as formatAndValidPadding,f as formatAndValidResponsiveToken,b as formatAndValidShadow,i as formatAndValidTextColor}from"./p-691ba1ae.js";export{c as camelToDashCase}from"./p-02841589.js";export{d as BackgroundColorMap,a as BackgroundColors,e as BorderColorMap,b as BorderColors,B as BorderRadius,C as Colors,F as FillBackgroundColors,g as ShadowMap,f as Shadows,h as Spacing,S as StrokeBackgroundColors,c as TextColorMap,T as TextColors}from"./p-1f83cebf.js";export{B as Breakpoints}from"./p-ed45b3b6.js";export{I as Icons,g as getIconFromToken}from"./p-16493e5b.js";export{b as Typography,a as TypographyKeys,T as TypographyUrls}from"./p-d884c644.js";export{d as BoxDisplay,e as BreakpointKeys,C as CssStates,F as FlexDirections}from"./p-40f39194.js";export{F as FrameworkEnum,v as VegaEnvManager}from"./p-5f377954.js";export{A as ActionHandlerInterceptor,I as InsertNodeToNearestRootAction,l as RTETokenNode,m as RTETokenNodeRenderer,R as RTETokenToolbarButtonRenderer,c as VegaDialog,d as VegaEventManager,V as VegaLoader,a as VegaNotify,j as VegaRTEExtension,k as VegaRTEExtensionRenderer,h as VegaRTEFunctionExtension,g as VegaRTETokenExtension,i as VegaRTEToolbarButtonRenderer,f as VegaSkeletonLoader,b as VegaThemeManager,e as VegaZIndexManager}from"./p-c2488ed6.js";export{F as FeatureFlag}from"./p-e77a83e4.js";export{B as VegaJQueryDelegatedEventStrategy}from"./p-fe12eff6.js";export{V as VegaIconManager}from"./p-8c9ea6f4.js";export{V as ValidCreditCardNumberRule}from"./p-60851f9d.js";export{w as waitForVega}from"./p-aedf7146.js";export{a as VegaTranslation,s as VegaTranslationResourceEN}from"./p-f69f84a7.js";export{B as BlockToRTEBlockStrategyAbstract,b as ElementToDTOStrategy,I as InsertNewParagraphAction,d as RTEImageBlock,f as RTEImageNode,e as RTEListBlock,c as RTEListItemBlock,U as UpdateCursorPositionAction,V as VegaRTEContent,h as htmlElementToAnnotationGenerator}from"./p-b1f869fb.js";export{s as setVegaNonce}from"./p-4866e390.js";export{d as ActionHandleStrategy,h as AppendChildrenAction,Q as CodeLanguage,C as CustomAttributeAnnotation,w as CustomClassAnnotation,v as CustomStyleAnnotation,I as InsertChildrenAfterAction,j as InsertChildrenBeforeAction,M as ModifyContentAction,c as ModifyContentActionType,g as RTEAnnotationStyle,f as RTEBlock,z as RTEDecoratorNode,i as RTENode,e as RTETextBlock,b as RTETextNode,r as RemoveChildrenAction,V as VegaRTEPresetToolbarItems}from"./p-6f8be8ea.js";export{R as RTELanguageToolbarButtonRenderer,V as VegaRTELanguageExtension}from"./p-749f96a4.js";export{R as RTERange}from"./p-1298b126.js";export{G as GridColumns,a as GridRows}from"./p-430be941.js";export{C as CheckBoxRequiredRule}from"./p-590fd123.js";export{D as DateRequiredRule}from"./p-d0e31633.js";export{I as InputPhoneNumberRequiredRule}from"./p-07c2725a.js";export{I as InputRangeRequiredRule}from"./p-f396c69a.js";export{R as RequiredFieldRule}from"./p-280cbcdb.js";export{R as RichTextEditorRequiredRule}from"./p-0575d22e.js";export{T as TimeRangeRequiredRule,a as TimeRequiredRule}from"./p-a2aeb646.js";export{T as ToggleSwitchRequiredRule}from"./p-7c0b4c36.js";export{F as FileUploaderRequiredRule}from"./p-0bb860cc.js";import"./p-b75ee3ba.js";import"./p-a4670e23.js";import"./p-6a334573.js";import"./p-d9671d27.js";import"./p-ef9cbad1.js";import"./p-a528714c.js";import"./p-2d0d575f.js";import"./p-331a62d5.js";import"./p-112455b1.js";import"./p-262ec334.js";import"./p-bf19682d.js";import"./p-a7b5f497.js";import"./p-8d0ca805.js";import"./p-db8cdba6.js";import"./p-abd7aeaa.js";import"./p-5d676a94.js";import"./p-5b71c85e.js";import"./p-0c667d6a.js";import"./p-d27ae9ff.js";const o=["ring-input-focus","dark-ring-input-focus","ring-input-danger-focus","dark-ring-input-danger-focus","ring-action-focus","dark-ring-action-focus","ring-action-danger-focus","dark-ring-action-danger-focus"];export{o as Rings}