@heartlandone/vega 2.79.0 → 2.80.0

package/dist/types/components/vega-calendar/vega-calendar-event-preview/slimmers/renderers/vega-calendar-event-preview-detail-renderer.d.ts

@@ -7,6 +7,11 @@ export declare class VegaCalendarEventPreviewDetailRenderer extends VegaSlimmer
   protected translationSlimmer: VegaCalendarEventPreview['translationSlimmer'];
   private calendarRef;
   componentWillLoad(): void;
+  /**
+   * Notifies the calendar host via ChangeManager that the event preview content has been rendered
+   * and is ready for focus management (e.g., focusing the close button for VoiceOver).
+   */
+  componentDidRender(): void;
   render(): HTMLElement;
   private renderActions;
   private renderBasicFields;

package/dist/types/components/vega-input/slimmers/controllers/vega-input-mask-config-controller.d.ts

@@ -63,6 +63,7 @@ export declare class VegaInputMaskConfigController extends StringInputFormatterS
    * The function `getNumberTypeMaskStrategy` returns a specific formatting strategy based on the provided options for number masking.
    *
    * @param {NumberMaskConfig} options - The `options` parameter is of type `NumberMaskConfig`, which likely contains configuration options for formatting numbers. It seems to have a property `thousandComma` which, if true, indicates that the number should be formatted with thousand commas.
+   * @param {boolean} overrideValue - The `overrideValue` parameter is a boolean that indicates whether the formatted value should override the original value after the blur event.
    * @returns {StringFormatStrategy} an instance of numberMaskStrategy or numberThousandCommaStrategy
    */
   private getNumberTypeMaskStrategy;

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

@@ -2,28 +2,57 @@ import { MaskConfig } from '../../helpers/formatter/string-formatter/string-mask
 import { NumberMaskConfig } from '../../helpers/formatter/string-formatter/number-mask-strategy';
 import { StringFormatStrategy } from '../../helpers/formatter/string-formatter/string-format-strategy.abstract';
 
+/**
+ * TODO: Need depercated this type instead of format strategy to handle user deference requirement. More info refer to https://gethired.atlassian.net/browse/VD-8523
+ */
 /**
  * Configuration for input masking strategies.
  */
 export type MaskConfigType = {
 	/**
 	 * Masking strategy identifier.
+	 *
+	 * - 'phone': Formats input as a phone number.
+	 * - 'zipcode': Formats input as a postal code.
+	 * - 'taxId': Formats input as a tax identification number.
+	 * - 'custom': Uses a custom formatter function provided via the `formatter` property.
+	 * - 'thousand-comma': Formats numbers with thousand separators.
+	 * - 'number': Formats input as a number, allowing for decimal points and negative signs.
+	 * - 'custom-formatter': Uses a custom strategy provided via the `strategy` property, which should return an instance of `StringFormatStrategy`.
 	 */
 	type: 'phone' | 'zipcode' | 'taxId' | 'custom' | 'thousand-comma' | 'number' | 'custom-formatter';
 	/**
 	 * Options used by the selected mask strategy.
+	 * It only work while type is 'custom' or 'number',
+	 * 	for 'custom' type, options should be MaskConfig,
+	 *  for 'number' type, options should be NumberMaskConfig,
+	 *  for other types, options will be ignored even if it's provided.
 	 */
 	options?: MaskConfig | NumberMaskConfig;
+
+	/**
+	 * Whether to override the component value on blur when using 'blur' trigger.
+	 * If set to true, the component value will be updated with the formatted value on blur.
+	 * If false or not set, the component value will not be updated on blur, but the formatted value will still be applied to the native input.
+	 */
+	overrideValue?: boolean;
+
 	/**
-	 * Event that triggers the mask update.
+	 * Trigger types for maskConfig, indicating when the mask should be applied to the input field.
+	 *
+	 * - 'blur': The mask is applied when the input field blurs (loses focus), and it just apply the formatted value to the native input, but the component value is not updated,
+	 *    if you also want to update the component value on blur, you can set `overrideValue` in options to true, then the component value will also be updated on blur.
+	 * - 'input': The mask is applied on every input event (as the user types), and the value of vega-input is updated accordingly.
 	 */
 	trigger?: 'blur' | 'input';
 	/**
 	 * Optional value formatter callback.
+	 * It only works when the `type` is set to 'custom-formatter'. The formatter function takes the input value as a string and returns the formatted value as a string.
 	 */
 	formatter?: (value: string) => string;
 	/**
 	 * Whether to reset the caret position after formatting.
+	 * It only works when the `type` is set to 'custom-formatter'. If set to true, the caret position will be reset to the end of the input after formatting. If false or not set, the caret position will be calculated based on the changes made by the formatter function.
 	 */
 	resetCaretPosition?: boolean;
 	/**

package/dist/types/components/vega-popover/slimmers/controllers/vega-popover-appender-controller.d.ts

@@ -1,5 +1,6 @@
 import { ElementAppenderSlimmer } from '../../../../helpers/slimmers/element-appender/element-appender-slimmer';
 import { VegaPopover } from '../../vega-popover';
+import { AriaDialogFocusableTrapSlimmer } from '../../../../helpers/slimmers/aria-dialog-focusable-trap-slimmer';
 /** The `VegaPopoverAppenderController` class extends `ElementAppenderSlimmer` and defines properties and methods for appending a popover element to a target element based on specified configurations. */
 export declare class VegaPopoverAppenderController extends ElementAppenderSlimmer {
   host: VegaPopover['host'];
@@ -11,6 +12,7 @@ export declare class VegaPopoverAppenderController extends ElementAppenderSlimme
   isScreenPosition: VegaPopover['isScreenPosition'];
   isPopoverShow: VegaPopover['isPopoverShow'];
   appenderRenderer: VegaPopover['appenderRenderer'];
+  protected readonly ariaDialogFocusableTrapSlimmer: AriaDialogFocusableTrapSlimmer;
   private target;
   /**
    * Component lifecycle - [componentDidLoad]{@link VegaPopover.connectedCallback}
@@ -20,6 +22,10 @@ export declare class VegaPopoverAppenderController extends ElementAppenderSlimme
    * Component lifecycle - [componentDidLoad]{@link VegaPopover.disconnectedCallback}
    */
   disconnectedCallback(): void;
+  /**
+   * Component lifecycle - [componentDidRender]{@link VegaPopover.componentDidRender}
+   */
+  componentDidRender(): void;
   /**
    * The constructor initializes a popover with specific configuration options.
    */

package/dist/types/components/vega-rich-text-editor/dto/annotations/code-annotation.d.ts

@@ -17,6 +17,12 @@ export declare class CodeAnnotation extends NodeAnnotation {
    * @returns {[NodeAnnotationTypeEnum.CODE, CodeAnnotation]} Map item for the annotation
    */
   static from(code: boolean, useInternalStyle?: boolean): [NodeAnnotationTypeEnum.CODE, CodeAnnotation];
+  /**
+   * Get the default standalone styles for an inline code annotation.
+   *
+   * @returns {AnnotationStyle} The default styles.
+   */
+  static getDefaultStyles(): AnnotationStyle;
   /**
    * Generate the JSON representation of the annotation
    *

package/dist/types/components/vega-rich-text-editor/dto/annotations/horizontal-alignment-annotation.d.ts

@@ -15,6 +15,13 @@ export declare class HorizontalAlignmentAnnotation extends BlockAnnotation {
    * @returns {[BlockAnnotationTypeEnum.ALIGNMENT, HorizontalAlignmentAnnotation]} Map item for the annotation
    */
   static from(textAlign: VegaRTEBlockAlignment): [BlockAnnotationTypeEnum.ALIGNMENT, HorizontalAlignmentAnnotation];
+  /**
+   * Get the default standalone styles for a given alignment value.
+   *
+   * @param {VegaRTEBlockAlignment} textAlign - The alignment value.
+   * @returns {AnnotationStyle} The default standalone styles.
+   */
+  static getDefaultStyles(textAlign: VegaRTEBlockAlignment): AnnotationStyle;
   /**
    * Generate the JSON item of the annotation
    *

package/dist/types/components/vega-rich-text-editor/dto/annotations/image-annotation.d.ts

@@ -18,6 +18,12 @@ export declare class ImageAnnotation extends NodeAnnotation {
    * @returns {[NodeAnnotationTypeEnum.IMAGE, ImageAnnotation]} Map item for the annotation
    */
   static from(size: Nullable<VegaRichTextImageEditorSizeType>, alt: string): [NodeAnnotationTypeEnum.IMAGE, ImageAnnotation];
+  /**
+   * Get the default standalone base styles for an image node.
+   *
+   * @returns {AnnotationStyle} The default styles.
+   */
+  static getDefaultStyles(): AnnotationStyle;
   /**
    * Generate the JSON representation of the annotation
    *

package/dist/types/components/vega-rich-text-editor/dto/annotations/link-group-annotation.d.ts

@@ -9,6 +9,13 @@ export declare class LinkGroupAnnotation extends Annotation {
   readonly type: InternalAnnotationTypeEnum;
   linkGroups: Map<string, RTETextNode[]>;
   constructor(groupKey: string);
+  /**
+   * Get the default standalone styles applied to a link by Vega's internal style.
+   * These are redundant when parsed back from standalone HTML and should be stripped.
+   *
+   * @returns {AnnotationStyle} The default styles.
+   */
+  static getDefaultStyles(): AnnotationStyle;
   clone(): LinkGroupAnnotation;
   /**
    * Convert the custom style, class and attribute to string which html can used

package/dist/types/components/vega-rich-text-editor/dto/annotations/list-annotation.d.ts

@@ -6,6 +6,12 @@ import { Nullable } from '../../../../types/general';
  */
 export declare class ListAnnotation extends BlockAnnotation {
   readonly type: BlockAnnotationTypeEnum;
+  /**
+   * Get the default standalone styles for a list block.
+   *
+   * @returns {AnnotationStyle} The default styles.
+   */
+  static getDefaultStyles(): AnnotationStyle;
   /**
    * @inheritDoc
    */

package/dist/types/components/vega-rich-text-editor/dto/annotations/text-format-default-styles.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Default CSS style values produced by inline text-formatting annotations.
+ *
+ * These constants are the single source of truth for the CSS values that
+ * bold, italic, underline and strikethrough semantic annotations render as
+ * (in standalone mode) and that annotation handlers / filter strategies use
+ * to detect or remove redundant inline styles.
+ */
+/** CSS `font-weight` value rendered by the bold annotation. */
+export declare const BOLD_FONT_WEIGHT: string;
+/** Alternative `font-weight` keyword that browsers report for bold elements. */
+export declare const BOLD_FONT_WEIGHT_KEYWORD: string;
+/** CSS `font-style` value rendered by the italic annotation. */
+export declare const ITALIC_FONT_STYLE: string;
+/** CSS `text-decoration` token rendered by the underline annotation. */
+export declare const UNDERLINE_TEXT_DECORATION: string;
+/** CSS `text-decoration` token rendered by the strikethrough annotation. */
+export declare const STRIKETHROUGH_TEXT_DECORATION: string;
+/** CSS `font-family` value rendered by the code annotation. */
+export declare const CODE_FONT_FAMILY: string;
+/** CSS `white-space` value rendered by the code annotation. */
+export declare const CODE_WHITE_SPACE: string;

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

@@ -22,6 +22,13 @@ export declare class TextStyleAnnotation extends BlockAnnotation {
    * @returns {[BlockAnnotationTypeEnum.TEXT_STYLE, TextStyleAnnotation]} Map item for the annotation
    */
   static from(textStyle: VegaRTETextStyleType): [BlockAnnotationTypeEnum.TEXT_STYLE, TextStyleAnnotation];
+  /**
+   * Get the default styles for a given text style type.
+   *
+   * @param {VegaRTETextStyleType} textStyle - The text style type.
+   * @returns {Nullable<AnnotationStyle>} The default styles for the given text style type.
+   */
+  static getDefaultStyles(textStyle: Nullable<VegaRTETextStyleType>): Nullable<AnnotationStyle>;
   /**
    * Generate the JSON representation of the annotation
    *

package/dist/types/components/vega-rich-text-editor/dto/filter-styles-strategies/filter-styles-strategy.abstract.d.ts

@@ -1,3 +1,4 @@
+import { VegaRTEAnnotations } from '../../interface';
 import { Nullable } from '../../../../types/general';
 export declare type RTEFilterStyles = Record<string, string>;
 /**
@@ -14,6 +15,25 @@ export declare abstract class RTEFilterStylesStrategy {
    * Must be defined in each concrete implementation.
    */
   protected abstract stylesToBeFiltered: RTEFilterStyles;
+  /**
+   * Whether this strategy should always filter, regardless of `autoMatchFormat`.
+   * Override to `true` when the filtered styles are always emitted as inline
+   * styles by the DTO (e.g. image `vertical-align`), so stripping them from
+   * `customStyle` is always safe.
+   *
+   * Defaults to `false` – the strategy only runs when `autoMatchFormat` is enabled.
+   *
+   * @returns {boolean} Whether filtering should always apply.
+   */
+  get alwaysFilter(): boolean;
+  /**
+   * Removes matched default styles from the `customStyle` property of the given annotations object.
+   * If all custom styles are defaults, the `customStyle` key is deleted entirely.
+   *
+   * @param {VegaRTEAnnotations} annotations - The annotations object (mutated in place).
+   * @returns {VegaRTEAnnotations} The same annotations reference.
+   */
+  filterAnnotations(annotations: VegaRTEAnnotations): VegaRTEAnnotations;
   /**
    * Removes configured default style properties from the target styles object.
    * Only properties whose value matches the configured default exactly are deleted.

package/dist/types/components/vega-rich-text-editor/dto/filter-styles-strategies/image-node/image-filter-styles-strategy.d.ts

@@ -0,0 +1,10 @@
+import { RTEFilterStyles, RTEFilterStylesStrategy } from '../filter-styles-strategy.abstract';
+/**
+ * Filters the default ImageAnnotation base styles (verticalAlign) from
+ * customStyle when parsing an RTEImageNode.
+ */
+export declare class ImageFilterStylesStrategy extends RTEFilterStylesStrategy {
+  protected stylesToBeFiltered: RTEFilterStyles;
+  /** @returns {boolean} Always `true` — image defaults are emitted as inline styles. */
+  get alwaysFilter(): boolean;
+}

package/dist/types/components/vega-rich-text-editor/dto/filter-styles-strategies/list-block/list-block-filter-styles-strategy.d.ts

@@ -0,0 +1,8 @@
+import { RTEFilterStyles, RTEFilterStylesStrategy } from '../filter-styles-strategy.abstract';
+/**
+ * Filters the default ListAnnotation styles (paddingLeft, marginLeft) from
+ * customStyle when parsing an RTEListBlock.
+ */
+export declare class ListBlockFilterStylesStrategy extends RTEFilterStylesStrategy {
+  protected stylesToBeFiltered: RTEFilterStyles;
+}

package/dist/types/components/vega-rich-text-editor/dto/filter-styles-strategies/list-block/list-item-block-filter-styles-strategy.d.ts

@@ -0,0 +1,9 @@
+import { RTEFilterStyles, RTEFilterStylesStrategy } from '../filter-styles-strategy.abstract';
+/**
+ * Filters the default paragraph styles from customStyle when parsing an
+ * RTEListItemBlock.  List-item blocks implicitly use paragraph styling,
+ * so these inline defaults are redundant and should not be persisted.
+ */
+export declare class ListItemBlockFilterStylesStrategy extends RTEFilterStylesStrategy {
+  protected stylesToBeFiltered: RTEFilterStyles;
+}

package/dist/types/components/vega-rich-text-editor/dto/filter-styles-strategies/text-block/alignment-filter-styles-strategy.d.ts

@@ -0,0 +1,27 @@
+import { VegaRTEAnnotations } from '../../../interface';
+import { RTEFilterStyles, RTEFilterStylesStrategy } from '../filter-styles-strategy.abstract';
+/**
+ * Filters redundant `textAlign` from `customStyle` when parsing blocks that carry
+ * a semantic `textAlign` annotation (RTETextBlock, RTEListBlock, RTEListItemBlock).
+ *
+ * During source-to-normal round-trips the `HorizontalAlignmentAnnotation` emits
+ * `text-align` as an inline style (standalone mode), and `CustomStyleAnnotationHandler`
+ * captures it into `customStyle`.  This strategy removes the duplicate so the
+ * semantic annotation is the single source of truth.
+ */
+export declare class AlignmentFilterStylesStrategy extends RTEFilterStylesStrategy {
+  protected stylesToBeFiltered: RTEFilterStyles;
+  /**
+   * @returns {boolean} Always `true` — alignment inline styles are always emitted
+   * in standalone/source-edit mode, so the duplicate is always safe to remove.
+   */
+  get alwaysFilter(): boolean;
+  /**
+   * Removes `textAlign` from `customStyle` when it duplicates the value returned
+   * by `HorizontalAlignmentAnnotation.getDefaultStyles(textAlign)`.
+   *
+   * @param {VegaRTEAnnotations} annotations - The annotations object (mutated in place).
+   * @returns {VegaRTEAnnotations} The same annotations reference.
+   */
+  filterAnnotations(annotations: VegaRTEAnnotations): VegaRTEAnnotations;
+}

package/dist/types/components/vega-rich-text-editor/dto/filter-styles-strategies/text-node/code-filter-styles-strategy.d.ts

@@ -0,0 +1,17 @@
+import { VegaRTEAnnotations } from '../../../interface';
+import { RTEFilterStyles, RTEFilterStylesStrategy } from '../filter-styles-strategy.abstract';
+/**
+ * Filters the default CodeAnnotation styles (fontFamily, whiteSpace) from
+ * customStyle when parsing an RTETextNode that has a `code` annotation.
+ */
+export declare class CodeFilterStylesStrategy extends RTEFilterStylesStrategy {
+  protected stylesToBeFiltered: RTEFilterStyles;
+  /**
+   * Only strips code-default styles when the `code` annotation is present,
+   * so that a user-applied `fontFamily: 'Roboto Mono'` without code is preserved.
+   *
+   * @param {VegaRTEAnnotations} annotations - The annotations object (mutated in place).
+   * @returns {VegaRTEAnnotations} The same annotations reference.
+   */
+  filterAnnotations(annotations: VegaRTEAnnotations): VegaRTEAnnotations;
+}

package/dist/types/components/vega-rich-text-editor/dto/filter-styles-strategies/text-node/link-filter-styles-strategy.d.ts

@@ -0,0 +1,17 @@
+import { VegaRTEAnnotations } from '../../../interface';
+import { RTEFilterStyles, RTEFilterStylesStrategy } from '../filter-styles-strategy.abstract';
+/**
+ * Filters the default internal link styles (color) from `link.customStyle` when
+ * parsing an RTETextNode. Vega applies these styles during standalone rendering;
+ * they are redundant when parsed back and must not be persisted as custom overrides.
+ */
+export declare class LinkFilterStylesStrategy extends RTEFilterStylesStrategy {
+  protected stylesToBeFiltered: RTEFilterStyles;
+  /**
+   * Filter default link styles from `link.customStyle` in annotations.
+   *
+   * @param {VegaRTEAnnotations} annotations - The annotations to filter.
+   * @returns {VegaRTEAnnotations} The same annotations reference with link.customStyle cleaned up.
+   */
+  filterAnnotations(annotations: VegaRTEAnnotations): VegaRTEAnnotations;
+}

package/dist/types/components/vega-rich-text-editor/dto/filter-styles-strategies/text-node/text-format-filter-styles-strategy.d.ts

@@ -0,0 +1,41 @@
+import { VegaRTEAnnotations } from '../../../interface';
+import { RTEFilterStyles, RTEFilterStylesStrategy } from '../filter-styles-strategy.abstract';
+/**
+ * Filters redundant inline text formatting styles from `customStyle` when
+ * parsing an RTETextNode. These styles are already represented by semantic
+ * annotations and should not be persisted as custom overrides after source
+ * edit round-trips.
+ */
+export declare class TextFormatFilterStylesStrategy extends RTEFilterStylesStrategy {
+  protected stylesToBeFiltered: RTEFilterStyles;
+  /**
+   * @returns {boolean} Always `true` — this strategy runs regardless of `autoMatchFormat`.
+   */
+  get alwaysFilter(): boolean;
+  /**
+   * Filter redundant text format styles from `customStyle`.
+   *
+   * @param {VegaRTEAnnotations} annotations - The annotations to filter.
+   * @returns {VegaRTEAnnotations} The same annotations reference with customStyle cleaned up.
+   */
+  filterAnnotations(annotations: VegaRTEAnnotations): VegaRTEAnnotations;
+  /**
+   * Normalizes a `text-decoration` CSS value to a sorted, unique token string of
+   * toolbar-only tokens (`underline`, `line-through`). Returns `undefined` if the
+   * value contains any non-toolbar token (e.g. `wavy`, a color).
+   *
+   * @param {string | undefined} value - The raw `textDecoration` CSS value.
+   * @returns {string | undefined} Normalized token string, or `undefined` if the value cannot be safely removed.
+   */
+  private normalizeTextDecoration;
+  /**
+   * Determines whether the `textDecoration` custom style should be removed based on the
+   * semantic annotations present. Removal happens only when the normalized value exactly
+   * matches the set of `{underline, strikethrough}` annotations.
+   *
+   * @param {string} normalizedTextDecoration - The normalized `textDecoration` token string.
+   * @param {VegaRTETextAnnotations} annotations - The text annotations to check against.
+   * @returns {boolean} `true` if the `textDecoration` style is redundant and should be removed.
+   */
+  private shouldRemoveTextDecoration;
+}

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

@@ -30,6 +30,16 @@ declare class HtmlElementToAnnotationGenerator {
    * @returns {V} Generated annotations.
    */
   generate<T extends RTEDtoClassPrototype, V extends VegaRTEAnnotations>(targetDto: T, element: HTMLElement, options?: HtmlElementToAnnotationGenerateOptions): V;
+  /**
+   * Remove default text-style properties from customStyle.
+   * This prevents repeated styling when switching between source edit and normal mode.
+   *
+   * Note: This method mutates the customStyle object inside `annotations` in place and returns the same reference.
+   *
+   * @param {V} annotations - The generated annotations.
+   * @returns {V} The same annotations reference with customStyle cleaned up.
+   */
+  private removeTextStyleDefaultsFromCustomStyle;
 }
 declare const _default: HtmlElementToAnnotationGenerator;
 export default _default;

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

@@ -4,6 +4,7 @@ export declare type DateCompareResult = {
   isNextMonth: boolean;
   inMonth: boolean;
 };
+export declare const WEEKDAYS_SHORT: string[];
 /**
  * Calendar date class
  */
@@ -151,6 +152,12 @@ export declare class CalendarDate {
    * @returns {CalendarDate} - A new CalendarDate object with the adjusted date.
    */
   add(years?: number, months?: number, days?: number): CalendarDate;
+  /**
+   * Get the short name of the week day for the calendar date.
+   *
+   * @returns {string} - The short name of the week day.
+   */
+  getWeekDayShortName(): string;
   /**
    * Get year, month and day value by format token.
    *

package/dist/types/helpers/calendar/calendar-view-generator/calendar-view-generator.abstract.d.ts

@@ -5,7 +5,6 @@ import { CalendarView } from '../calendar-view';
  */
 export declare abstract class CalendarViewGenerator {
   protected weekdays: number[];
-  private readonly WEEKDAYS_SHORT;
   constructor();
   /**
    * Get weekday names.

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

@@ -55,6 +55,7 @@ export declare const VegaInternalCalendarEventPreviewClear: VegaInternalEventID;
 export declare const VegaInternalUpdateRTECursorPosition: VegaInternalEventID;
 export declare const VegaInternalLeftNavLinkSelectedTopic: VegaInternalEventID;
 export declare const VegaInternalCalendarEventPreviewHide: VegaInternalEventID;
+export declare const VegaInternalDialogContentReady: VegaInternalEventID;
 export declare const VegaInternalFormSubmit: VegaInternalEventID;
 export declare const VegaInternalFormReset: VegaInternalEventID;
 export declare const VegaInternalProgressTrackerStepClick: VegaInternalEventID;

package/dist/types/helpers/formatter/string-formatter/custom-formatter-strategy.d.ts

@@ -16,8 +16,9 @@ export declare class CustomFormatterStrategy extends StringFormatStrategy {
    * formatter class likely contains methods or properties related to formatting strings in a specific
    * way according to your requirements.
    * @param {boolean} resetCaretPosition - The caret position should update to the last or keep the current position after format
+   * @param {boolean} overrideValue - Whether to override the value after blur, default is false
    */
-  constructor(formatter: CustomStringFormatter, resetCaretPosition?: boolean);
+  constructor(formatter: CustomStringFormatter, resetCaretPosition?: boolean, overrideValue?: boolean);
   /**
    * The format function in TypeScript takes a string input and returns the formatted output using a
    * formatter method.

package/dist/types/helpers/formatter/string-formatter/number-mask-strategy.d.ts

@@ -24,8 +24,9 @@ export declare class NumberMaskStrategy extends StringFormatStrategy {
    * It creates a new instance of the Mask class.
    *
    * @param {NumberMaskConfig} maskConfig - MaskConfig
+   * @param {boolean} overrideValue - Whether to override the value after blur, default is false
    */
-  constructor(maskConfig?: NumberMaskConfig);
+  constructor(maskConfig?: NumberMaskConfig, overrideValue?: boolean);
   /**
    * Given a number string, it replaces the mask with the matched input value
    *

package/dist/types/helpers/formatter/string-formatter/number-thousand-comma-strategy.d.ts

@@ -7,8 +7,9 @@ export declare class NumberThousandCommaStrategy extends NumberMaskStrategy {
    * It creates a new instance of the Mask class.
    *
    * @param {NumberMaskConfig} maskConfig - MaskConfig
+   * @param {boolean} overrideValue - Whether to override the value after blur, default is false
    */
-  constructor(maskConfig: NumberMaskConfig);
+  constructor(maskConfig: NumberMaskConfig, overrideValue?: boolean);
   /**
    * If the input is a number, format it as a thousand comma string
    *

package/dist/types/helpers/formatter/string-formatter/string-format-strategy.abstract.d.ts

@@ -9,6 +9,7 @@ export declare type InputStatus = {
  * String format strategy abstract class
  */
 export declare abstract class StringFormatStrategy {
+  protected overrideValue: boolean;
   /**
    * Check if the {@link format} should be applied
    *

package/dist/types/helpers/formatter/string-formatter/string-mask-strategy.d.ts

@@ -5,6 +5,12 @@ export declare type MaskConfig = {
   slot: string | RegExp;
   accept: RegExp;
   insertMode?: boolean;
+  /**
+   * Whether to override the component value on blur when using 'blur' trigger.
+   *
+   * @deprecated This property is deprecated since we have overrideValue in MaskConfigType which has the same function but more flexible to use.
+   *   Please use overrideValue in MaskConfigType instead of this one. If both of them exist, the overrideValue in MaskConfigType will be used and this property will be ignored.
+   */
   overrideValue?: boolean;
   triggerAtInit?: boolean;
 };
@@ -14,9 +20,9 @@ export declare type MaskConfig = {
  * @augments StringFormatStrategy
  */
 export declare class StringMaskStrategy extends StringFormatStrategy {
-  static PHONE_MASK: StringMaskStrategy;
-  static ZIPCODE_MASK: StringMaskStrategy;
-  static TAX_ID_MASK: StringMaskStrategy;
+  private static readonly DEFAULT_PHONE_MASK_CONFIG;
+  private static readonly DEFAULT_ZIPCODE_MASK_CONFIG;
+  private static readonly DEFAULT_TAX_ID_MASK_CONFIG;
   private maskConfig;
   private slotRegex;
   private acceptRegex;
@@ -36,8 +42,30 @@ export declare class StringMaskStrategy extends StringFormatStrategy {
    * It creates a new instance of the Mask class.
    *
    * @param {MaskConfig} maskConfig - MaskConfig
+   * @param {boolean} overrideValue - Whether to override the value after blur, default is false
+   */
+  constructor(maskConfig: MaskConfig, overrideValue?: boolean);
+  /**
+   * A static method that generates a phone mask strategy based on the provided mask configuration.
+   *
+   * @param {boolean} overrideValue - The `overrideValue` parameter determines whether the component value should be overridden on blur.
+   * @returns {StringMaskStrategy} Returns an instance of the `StringMaskStrategy` class.
+   */
+  static getPhoneMaskStrategy(overrideValue?: boolean): StringMaskStrategy;
+  /**
+   * A static method that generates a zipcode mask strategy based on the provided mask configuration.
+   *
+   * @param {boolean} overrideValue - The `overrideValue` parameter determines whether the component value should be overridden on blur.
+   * @returns {StringMaskStrategy} Returns an instance of the `StringMaskStrategy` class.
+   */
+  static getZipcodeMaskStrategy(overrideValue?: boolean): StringMaskStrategy;
+  /**
+   * A static method that generates a tax ID mask strategy based on the provided mask configuration.
+   *
+   * @param {boolean} overrideValue - The `overrideValue` parameter determines whether the component value should be overridden on blur.
+   * @returns {StringMaskStrategy} Returns an instance of the `StringMaskStrategy` class.
    */
-  constructor(maskConfig: MaskConfig);
+  static getTaxIdMaskStrategy(overrideValue?: boolean): StringMaskStrategy;
   /**
    * Set the mask config
    *

package/dist/types/helpers/formatter/string-formatter/thousand-comma-strategy.d.ts

@@ -5,6 +5,7 @@ import { StringFormatStrategy } from './string-format-strategy.abstract';
  * @augments StringFormatStrategy
  */
 export declare class ThousandCommaStrategy extends StringFormatStrategy {
+  constructor(overrideValue?: boolean);
   /**
    * If the input is a number, format it as a string
    *

package/dist/types/helpers/keyboard/keyboard-manager.d.ts

@@ -8,6 +8,7 @@ export declare type KeyboardEventListener = {
   callback: (event: KeyboardEvent) => void;
   modifierPressed?: Nullable<boolean>;
   shiftKey?: Nullable<boolean>;
+  preventDefault?: boolean;
 };
 /**
  * It listens to the keyup event on the window and calls the appropriate method on the registered elements

package/dist/types/helpers/slimmers/aria-dialog-focusable-trap-slimmer.d.ts

@@ -21,6 +21,9 @@ export declare class AriaDialogFocusableTrapSlimmer extends VegaSlimmer {
   private isVoiceOverClick;
   private focusTriggerElement;
   private focusDialogTaskQueue;
+  private dialogContentReadyObserver;
+  private dialogContentReadySubject;
+  private isChildFocused;
   /**
    * Ensures that the event listener for click events is set up when the component is connected to the DOM. This is important for cases where the component might be added to the DOM after it has been initialized, ensuring that the click events are properly handled to manage focus behavior for dialog elements.
    */
@@ -67,6 +70,16 @@ export declare class AriaDialogFocusableTrapSlimmer extends VegaSlimmer {
    * Removes the event listener for click events from the trigger element or the window.
    */
   private eventListenerRemover;
+  /**
+   * Subscribes to the dialog content ready ChangeManager subject if configured.
+   * When the external component notifies that dialog content is rendered,
+   * the observer retries focusing the first focusable element in the dialog.
+   */
+  private subscribeDialogContentReady;
+  /**
+   * Unsubscribes from the dialog content ready ChangeManager subject.
+   */
+  private unsubscribeDialogContentReady;
   /**
    * Handles the click event and determines if it is likely triggered by VoiceOver.
    *  If it is a VoiceOver click, it sets the `isVoiceOverClick` flag to true and stores the currently focused element as the trigger element.
@@ -90,4 +103,10 @@ export declare class AriaDialogFocusableTrapSlimmer extends VegaSlimmer {
    * @returns {boolean} True if the element is focusable, false otherwise.
    */
   private isFocusableElement;
+  /**
+   * Focuses on the first focusable element within the dialog when the dialog content is ready and the last interaction was detected as a VoiceOver click. This method is called in response to the dialog content ready notification, ensuring that focus is set appropriately when the dialog is shown after being triggered by VoiceOver.
+   * It retrieves the currently active element, stores it as the trigger element, and then focuses on the first focusable element within the dialog content.
+   *
+   */
+  private focusOnFirstFocusableElement;
 }

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

@@ -114,9 +114,11 @@ export declare function getElementComputedStyle(element: HTMLElement, styleName:
  * Get the deep active element in shadow component
  *
  * @param {Document | ShadowRoot} root the root element
+ * @param {boolean} fallbackToHost whether to fallback to host when active element is null, default is false.
+ * In some cases, web component is used in a11y scenario, assistive technology may trigger click event on the host element but the active element is null, setting fallbackToHost to true can help to get the host element in this case.
  * @returns {Nullable<HTMLElement>} active element
  */
-export declare function getDeepActiveElementInShadow(root?: Document | ShadowRoot): Nullable<HTMLElement>;
+export declare function getDeepActiveElementInShadow(root?: Document | ShadowRoot, fallbackToHost?: boolean): Nullable<HTMLElement>;
 /**
  * Check if a node is an HTML element.
  *