@heartlandone/vega 2.78.0 → 2.80.0

package/dist/types/components/vega-calendar/slimmers/common/controllers/vega-calendar-day-view-focus-slimmer.d.ts

@@ -0,0 +1,15 @@
+import { AutoRunWhenReRenderTaskQueueSlimmer } from '../../../../../helpers/slimmers/auto-run-when-re-render-task-queue-slimmer.abstract';
+/**
+ * The `VegaCalendarDayViewFocusSlimmer` class is a slimmer that focuses on the day view title element of a calendar component after the component has been re-rendered. It extends the `AutoRunWhenReRenderTaskQueueSlimmer` class, which allows it to schedule a task to be executed after the component has been updated.
+ */
+export declare class VegaCalendarDayViewFocusSlimmer extends AutoRunWhenReRenderTaskQueueSlimmer {
+  private host;
+  /**
+   * Schedule a task to focus on the day view title element after the component has been re-rendered.
+   */
+  scheduleFocus(): void;
+  /**
+   * The `doTask` method is called after the component has been re-rendered. It focuses on the day view title element in the calendar component's shadow DOM.
+   */
+  protected doTask(): Promise<void>;
+}

package/dist/types/components/vega-calendar/slimmers/month-view/renderers/vega-calendar-month-view-renderer.d.ts

@@ -12,6 +12,8 @@ export declare class VegaCalendarMonthViewRenderer extends VegaCalendarDateBlock
   protected isDateDisabled: VegaCalendar['isDateDisabled'];
   protected showSwitchView: VegaCalendar['showSwitchView'];
   protected timezone: VegaCalendar['timezone'];
+  protected host: VegaCalendar['host'];
+  protected dayViewFocusSlimmer: VegaCalendar['dayViewFocusSlimmer'];
   /**
    * the HTML elements that represent the month view of a calendar component.
    *
@@ -42,6 +44,7 @@ export declare class VegaCalendarMonthViewRenderer extends VegaCalendarDateBlock
    * switch to current date day view
    *
    * @param {CalendarDate} calendarDate the calendar date object
+   * @param {MouseEvent} e the mouse event object
    */
   private goToCurrentDayView;
   /**

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

@@ -4,8 +4,14 @@ export declare class VegaCalendarEventPreviewDetailRenderer extends VegaSlimmer
   protected host: VegaCalendarEventPreview['host'];
   protected previewPayload: VegaCalendarEventPreview['previewPayload'];
   protected currentEvent: VegaCalendarEventPreview['currentEvent'];
+  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-calendar/vega-calendar.d.ts

@@ -30,6 +30,7 @@ import { VegaCalendarTimeMarkerRenderer } from './slimmers/day-view/renderers/ve
 import { VegaCalendarPostOperationDateController } from './slimmers/common/controllers/vega-calendar-post-operation-date-controller';
 import { VegaCalendarEventPreviewPopoverRenderer } from './slimmers/common/renderers/vega-calendar-event-preview-popover-renderer';
 import { VegaCalendarEventPreviewPopoverController } from './slimmers/common/controllers/vega-calendar-event-preivew-popover-controller';
+import { VegaCalendarDayViewFocusSlimmer } from './slimmers/common/controllers/vega-calendar-day-view-focus-slimmer';
 /**
  * @vegaVersion 2.14.0
  */
@@ -39,6 +40,7 @@ export declare class VegaCalendar {
   protected vegaComponentUsageRuntimeMetricsSlimmer: VegaComponentUsageRuntimeMetricsSlimmer<HTMLVegaCalendarElement>;
   protected renderer: VegaCalendarRenderer;
   protected switchPanelRenderer: VegaCalendarSwitchPanelRenderer;
+  protected dayViewFocusSlimmer: VegaCalendarDayViewFocusSlimmer;
   protected viewRenderer: VegaCalendarViewRenderer;
   protected monthViewRenderer: VegaCalendarMonthViewRenderer;
   protected viewWithTimeRenderer: VegaCalendarViewWithTimeRenderer;

package/dist/types/components/vega-date-picker/slimmers/controllers/vega-date-picker-calendar-open-state-controller.d.ts

@@ -1,5 +1,6 @@
 import { VegaDatePicker } from '../../vega-date-picker';
 import { ElementAppenderSlimmer } from '../../../../helpers/slimmers/element-appender/element-appender-slimmer';
+import { AriaDialogFocusableTrapSlimmer } from '../../../../helpers/slimmers/aria-dialog-focusable-trap-slimmer';
 /** The date picker element appender controller slimmer */
 export declare class VegaDatePickerCalendarOpenStateController extends ElementAppenderSlimmer {
   dropdownConfig: VegaDatePicker['dropdownConfig'];
@@ -10,6 +11,7 @@ export declare class VegaDatePickerCalendarOpenStateController extends ElementAp
   mode: VegaDatePicker['mode'];
   isCalendarShow: VegaDatePicker['isCalendarShow'];
   isMobileDevice: VegaDatePicker['isMobileDevice'];
+  protected readonly ariaDialogFocusableTrapSlimmer: AriaDialogFocusableTrapSlimmer;
   private clearCalendarStateTaskQueue;
   /**
    * Since connectedCallback will init element appender again, and it will add `vega-force-hidden` class to calendar,

package/dist/types/components/vega-date-picker/slimmers/renderers/vega-date-picker-calendar-renderer.d.ts

@@ -18,15 +18,20 @@ export declare class VegaDatePickerCalendarRenderer extends VegaSlimmer {
   isCalendarShow: VegaDatePicker['isCalendarShow'];
   isDateDisabled: VegaDatePicker['isDateDisabled'];
   allowRepick: VegaDatePicker['allowRepick'];
+  disabled: VegaDatePicker['disabled'];
+  label: VegaDatePicker['label'];
   monthYearChangeEventEmitter: VegaDatePicker['monthYearChangeEventEmitter'];
+  translationSlimmer: VegaDatePicker['translationSlimmer'];
   vegaDatePickerValueController: VegaDatePicker['vegaDatePickerValueController'];
   calendarOpenStateController: VegaDatePicker['calendarOpenStateController'];
+  private readonly calendarId;
   private calendarContentBoxRef;
   private calendarRef;
   private mobileModalRef;
   componentDidLoad(): void;
   getCalendarContentBoxRef(): HTMLVegaBoxElement;
   getCalendarRef(): HTMLVegaDatePickerCalendarElement;
+  getCalendarId(): string;
   getMobileModalRef(): HTMLVegaModalElement;
   triggerRepick(type: DatePickerCalendarRepickType): Promise<void>;
   render(): HTMLElement;

package/dist/types/components/vega-date-picker/slimmers/renderers/vega-date-picker-input-renderer-base.abstract.d.ts

@@ -7,6 +7,7 @@ export declare abstract class VegaDatePickerInputRendererBase extends VegaSlimme
   disabled: VegaDatePicker['disabled'];
   showClearIcon: VegaDatePicker['showClearIcon'];
   mode: VegaDatePicker['mode'];
+  isCalendarShow: VegaDatePicker['isCalendarShow'];
   vegaDatePickerValueController: VegaDatePicker['vegaDatePickerValueController'];
   calendarOpenStateController: VegaDatePicker['calendarOpenStateController'];
   /**
@@ -15,4 +16,5 @@ export declare abstract class VegaDatePickerInputRendererBase extends VegaSlimme
   protected renderClearIcon(): HTMLElement;
   private onClickClearIcon;
   private isClearIconVisible;
+  abstract focusInput(): void;
 }

package/dist/types/components/vega-date-picker/slimmers/renderers/vega-date-picker-range-input-renderer.d.ts

@@ -2,6 +2,8 @@ import { VegaDatePicker } from '../../vega-date-picker';
 import { VegaDatePickerInputRendererBase } from './vega-date-picker-input-renderer-base.abstract';
 export declare class VegaDatePickerRangeInputRenderer extends VegaDatePickerInputRendererBase {
   placeholder: VegaDatePicker['placeholder'];
+  label: VegaDatePicker['label'];
+  isCalendarShow: VegaDatePicker['isCalendarShow'];
   vegaDatePickerFormatController: VegaDatePicker['vegaDatePickerFormatController'];
   vegaDatePickerRenderer: VegaDatePicker['vegaDatePickerRenderer'];
   calendarOpenStateController: VegaDatePicker['calendarOpenStateController'];
@@ -13,6 +15,7 @@ export declare class VegaDatePickerRangeInputRenderer extends VegaDatePickerInpu
   private endDateInputRef;
   getStartDateInputRef(): HTMLInputElement;
   getEndDateInputRef(): HTMLInputElement;
+  focusInput(): void;
   render: () => HTMLElement;
   private getRangePlaceholder;
   /**

package/dist/types/components/vega-date-picker/slimmers/renderers/vega-date-picker-single-input-renderer.d.ts

@@ -3,11 +3,16 @@ import { VegaDatePickerInputRendererBase } from './vega-date-picker-input-render
 export declare class VegaDatePickerSingleInputRenderer extends VegaDatePickerInputRendererBase {
   placeholder: VegaDatePicker['placeholder'];
   format: VegaDatePicker['format'];
+  label: VegaDatePicker['label'];
+  isCalendarShow: VegaDatePicker['isCalendarShow'];
   vegaDatePickerFormatController: VegaDatePicker['vegaDatePickerFormatController'];
   vegaDatePickerRenderer: VegaDatePicker['vegaDatePickerRenderer'];
   calendarOpenStateController: VegaDatePicker['calendarOpenStateController'];
+  vegaDatePickerCalendarRenderer: VegaDatePicker['vegaDatePickerCalendarRenderer'];
+  translationSlimmer: VegaDatePicker['translationSlimmer'];
   private singleDateInputRef;
   getSingleDateInputRef(): HTMLInputElement;
+  focusInput(): void;
   render: () => HTMLElement;
   private getSinglePlaceholder;
   /**

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

@@ -1,4 +1,4 @@
-import { ResponsiveType, GridRowsType, GridColumnsType, GapType } from '../../types/ui.type';
+import { ResponsiveType, GridRowsType, GridColumnsType, GapType, GridJustifyItemsType } from '../../types/ui.type';
 import { GlobalSlimmers } from '../../vega-slimmer/vega-slimmer-core';
 import { VegaComponentUsageRuntimeMetricsSlimmer } from '../../helpers/slimmers/component-usage-runtime-metrics';
 /**
@@ -62,5 +62,17 @@ export declare class VegaGrid {
    * @vegaVersion 1.3.0
    */
   gap: ResponsiveType<GapType>;
+  /**
+   * Specifies how grid items are aligned along the inline (row) axis.
+   *
+   * It can be provided as one of: `start`, `center`, `end`, or `stretch`.
+   *
+   * Alternatively, you can use a responsive map to define different values for
+   *    various breakpoints. The keys in the map should represent the breakpoints,
+   *    such as `default` or `L`.
+   *
+   * @vegaVersion 2.79.0
+   */
+  justifyItems: ResponsiveType<GridJustifyItemsType>;
   render(): VegaGrid;
 }

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/slimmers/renderers/vega-input-input-renderer.d.ts

@@ -8,6 +8,7 @@ export declare class VegaInputInputRenderer extends VegaSlimmer {
   private name;
   private autocomplete;
   private inputmode;
+  private readOnly;
   private placeholder;
   private minLength;
   private maxLength;

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-input/vega-input.d.ts

@@ -192,6 +192,16 @@ export declare class VegaInput {
    * @vegaVersion 2.71.0
    */
   inputmode: 'text' | 'numeric';
+  /**
+   * Sets the input field as read-only, preventing direct keyboard input.
+   *
+   * When set to `true`, prevents manual keyboard text entry in the input field on
+   *    all platforms. On touch devices, this typically suppresses the virtual keyboard.
+   *
+   * @default false
+   * @vegaVersion 2.79.0
+   */
+  readOnly: boolean;
   /**
    * Displays a Vega icon at the leading (left) side of the input field,
    * providing visual context about the expected input.

package/dist/types/components/vega-modal/slimmers/controllers/vega-modal-open-state-controller.d.ts

@@ -2,6 +2,7 @@ import { VegaSlimmer } from '../../../../vega-slimmer/vega-slimmer-core';
 import { VegaModal } from '../../vega-modal';
 import type { VegaModalOpenStateChangeTrigger } from '../../types';
 import { VegaModalOpenState } from '../models/vega-modal-open-state';
+import { AriaDialogFocusableTrapSlimmer } from '../../../../helpers/slimmers/aria-dialog-focusable-trap-slimmer';
 /**
  * Modal open state controller
  */
@@ -17,6 +18,8 @@ export declare class VegaModalOpenStateController extends VegaSlimmer {
   backdropController: VegaModal['backdropController'];
   openedModalStackController: VegaModal['openedModalStackController'];
   zIndexController: VegaModal['zIndexController'];
+  renderer: VegaModal['renderer'];
+  protected readonly ariaDialogFocusableTrapSlimmer: AriaDialogFocusableTrapSlimmer;
   private backdropMouseDownOnHost;
   private backdropMouseUpOnHost;
   /**
@@ -27,6 +30,10 @@ export declare class VegaModalOpenStateController extends VegaSlimmer {
    * Component lifecycle - [componentDidLoad]
    */
   componentDidLoad(): void;
+  /**
+   * Component lifecycle - [componentDidRender]
+   */
+  componentDidRender(): void;
   /**
    * Toggle modal while openState changed.
    *
@@ -76,6 +83,12 @@ export declare class VegaModalOpenStateController extends VegaSlimmer {
    * @param {VegaModalOpenStateChangeTrigger} trigger - Indicates what initiated the close.
    */
   close(trigger: VegaModalOpenStateChangeTrigger): void;
+  /**
+   * Toggles the aria-dialog attribute based on the open state.
+   *
+   * @param {boolean} isOpen - Indicates whether the modal is open.
+   */
+  ariaDialogToggle(isOpen: boolean): void;
   /**
    * Updates the internal open state snapshot so watchers can react to the new value.
    *

package/dist/types/components/vega-modal/slimmers/renderers/vega-modal-renderer.d.ts

@@ -15,6 +15,7 @@ export declare class VegaModalRenderer extends VegaSlimmer {
   handleClose: VegaModal['handleClose'];
   deprecatedPropertySlimmer: VegaModal['deprecatedPropertySlimmer'];
   openStateController: VegaModal['openStateController'];
+  private readonly titleId;
   private modalContent;
   private modalFooter;
   private modalContainer;

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.
    */
@@ -32,6 +38,7 @@ export declare class VegaPopoverAppenderController extends ElementAppenderSlimme
   private generateShowConfigFactory;
   /**
    * Register a remote method to update the target element of the popover.
+   * TODO: refactor to using Change Manager
    */
   private registerRemoteMethod;
 }

package/dist/types/components/vega-rich-text-content/vega-rich-text-content.d.ts

@@ -5,6 +5,7 @@ import { VegaRTEContent } from '../vega-rich-text-editor/dto/content-state';
 import { VegaRichTextContentStateController } from './slimmers/controllers/vega-rich-text-content-state-controller';
 import { VegaRTEExtension } from '../vega-rich-text-editor/extensions/extension.abstract';
 import { RTEExtensionStylesController } from './slimmers/controllers/vega-rich-text-content-extensions-styles-controller';
+import { DarkModeStateControllerSlimmer } from '../../helpers/slimmers/dark-mode-state-controller-slimmer';
 /**
  * @vegaVersion 2.34.0
  */
@@ -14,6 +15,7 @@ export declare class VegaRichTextContent {
   protected readonly vegaRichTextContentRenderer: VegaRichTextContentRenderer;
   protected readonly vegaRichTextContentStateController: VegaRichTextContentStateController;
   protected readonly vegaRichTextContentExtensionsStylesController: RTEExtensionStylesController;
+  protected readonly darkModeStateControllerSlimmer: DarkModeStateControllerSlimmer;
   host: HTMLVegaRichTextContentElement;
   /**
    * Specifies a placeholder string that displays as a
@@ -35,6 +37,7 @@ export declare class VegaRichTextContent {
    * Holds the custom styles generated by extensions.
    */
   extensionStyles: string;
+  isInDarkMode: boolean;
   /**
    * Specifies the text or formatted information displayed by the rich text content, which can be either VegaRTEContent or VegaRTEContentBlock.
    * It is recommended to use the VegaRTEContent type.

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

@@ -58,6 +58,13 @@ export declare abstract class ActionHandleStrategy<T extends ModifyContentAction
    * @returns {boolean} - Whether the caret is at the end of the block.
    */
   protected isCaretPositionAtBlockEnd(block: RTEBlock, node: RTENode, offset: number): boolean;
+  /**
+   * Get the registered DOM element by the RTE entity.
+   *
+   * @param {RTEBlock | RTENode} instance - The RTE block or node instance.
+   * @returns {Nullable<HTMLElement>} The registered DOM element.
+   */
+  protected getDOMByEntity(instance: RTEBlock | RTENode): Nullable<HTMLElement>;
   /**
    * Checks if the caret position is at the end of a specified RTETextNode.
    *

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

@@ -1,6 +1,3 @@
-import { NodeAnnotationTypeEnum } from './node-annotation.abstract';
-import { BlockAnnotationTypeEnum } from './block-annotation.abstract';
-import { CommonAnnotationTypeEnum } from './common-annotation.abstract';
 export declare enum InternalAnnotationTypeEnum {
   SELECTION_RANGE = "SELECTION_RANGE",
   CLEAR_FORMATTING = "CLEAR_FORMATTING",
@@ -9,6 +6,6 @@ export declare enum InternalAnnotationTypeEnum {
 /**
  * Abstract class for all annotations
  */
-export declare abstract class Annotation {
-  abstract readonly type: BlockAnnotationTypeEnum | NodeAnnotationTypeEnum | InternalAnnotationTypeEnum | CommonAnnotationTypeEnum;
+export declare abstract class Annotation<T = string> {
+  abstract readonly type: T;
 }

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

@@ -11,8 +11,8 @@ export declare enum BlockAnnotationTypeEnum {
 /**
  * BlockAnnotation is an abstract class that represents a block annotation.
  */
-export declare abstract class BlockAnnotation extends Annotation {
-  abstract readonly type: BlockAnnotationTypeEnum;
+export declare abstract class BlockAnnotation<T = BlockAnnotationTypeEnum> extends Annotation<T> {
+  abstract readonly type: T;
   /**
    * Generate the style for the annotation.
    *
@@ -33,5 +33,5 @@ export declare abstract class BlockAnnotation extends Annotation {
    * @returns {Nullable<Record<string, unknown>>} JSON item of the annotation
    */
   abstract toJSON(): Nullable<Record<string, unknown>>;
-  abstract clone(): BlockAnnotation;
+  abstract clone(): BlockAnnotation<T>;
 }

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/custom-attribute-annotation.d.ts

@@ -5,7 +5,7 @@ import { CommonAnnotation, CommonAnnotationTypeEnum } from './common-annotation.
  */
 export declare class CustomAttributeAnnotation extends CommonAnnotation {
   readonly type: CommonAnnotationTypeEnum.CUSTOM_ATTRIBUTE;
-  private customAttribute;
+  customAttribute: Record<string, string>;
   private readonly BOOLEAN_ATTRS;
   constructor(customAttribute: Record<string, string>);
   /**

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/blocks/block.abstract.d.ts

@@ -1,16 +1,14 @@
 import { AnnotationStyle, RTEBlockAnnotationMapKey, RTEBlockAnnotationMapValue, RTERenderContext, VegaRTEBlockAnnotations, VegaRTEBlockBase, VegaRTEContentBlock, VegaRTETransformOptions } from '../../interface';
-import { BlockAnnotation, BlockAnnotationTypeEnum } from '../annotations/block-annotation.abstract';
 import { AnnotationAction } from '../actions/annotation-action.abstract';
 import { Nullable } from '../../../../types/general';
 import { ModifyContentAction } from '../actions/modify-content-action.abstract';
 import type { VegaRTEContent } from '../content-state';
-import { InternalAnnotationTypeEnum } from '../annotations/annotation.abstract';
-import { LinkGroupAnnotation } from '../annotations/link-group-annotation';
+import { Annotation } from '../annotations/annotation.abstract';
 import type { RTENode } from '../nodes/node.abstract';
 import type { RTEListItemBlock } from './list-item-block';
 import { CustomAttributeAnnotation } from '../annotations/custom-attribute-annotation';
 import { ClassType } from '../../../../types/class.type';
-export declare type BlockAnnotations = Map<RTEBlockAnnotationMapKey, RTEBlockAnnotationMapValue>;
+export declare type BlockAnnotations = Map<string, Annotation>;
 export declare type BlockAnnotationsEntity = [RTEBlockAnnotationMapKey, RTEBlockAnnotationMapValue];
 export declare type RTEBlockParentType = VegaRTEContent | RTEBlock;
 export declare type RTEBlockChildrenType = RTEBlock | RTENode;
@@ -76,16 +74,22 @@ export declare abstract class RTEBlock<P = RTEBlockParentType, C = RTEBlockChild
    * Get annotation by type
    *
    * @typedef T generic type
-   * @param {keyof typeof BlockAnnotationTypeEnum} type - Annotation type
+   * @param {string} type - Annotation type
    * @returns {Nullable<T>} - Annotation
    */
-  getAnnotationByType<T extends BlockAnnotation | LinkGroupAnnotation>(type: keyof typeof BlockAnnotationTypeEnum | InternalAnnotationTypeEnum.LINK_GROUP): Nullable<T>;
+  getAnnotationByType<T extends Annotation>(type: string): Nullable<T>;
   /**
    * Apply action to block
    *
    * @param {AnnotationAction} action - Annotation action
    */
   apply(action: AnnotationAction | ModifyContentAction): void;
+  /**
+   * Get the first node of the block
+   *
+   * @returns {Nullable<RTENode>} The first RTENode or null if no children exist.
+   */
+  getFirstNode(): Nullable<RTENode>;
   /**
    * Check if the block is a list item block
    *

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

@@ -0,0 +1,28 @@
+import { RTEFilterStylesStrategy } from './filter-styles-strategy.abstract';
+/**
+ * Registry for managing filter styles strategies keyed by DTO class name.
+ *
+ * Provides common `register` / `getStrategies` primitives that both output-
+ * filtering strategies (DTO → HTML) and annotation-parsing strategies
+ * (HTML → DTO) build upon.
+ *
+ * TODO: Currently, the filter styles strategies are applied for all rich text editors. We need to apply the strategies with a specific rich text editor instance when we have multiple rich text editors in the future.
+ */
+export declare class RTEFilterStylesStrategyRegistry {
+  protected static readonly registry: Map<string, Set<RTEFilterStylesStrategy>>;
+  /**
+   * Registers a filter styles strategy for a specific DTO class name.
+   * Duplicate strategy instances are ignored.
+   *
+   * @param {string} dtoClassName - The DTO class name (e.g. `RTEListBlock.name`).
+   * @param {RTEFilterStylesStrategy} strategy - The strategy instance to register.
+   */
+  static register(dtoClassName: string, strategy: RTEFilterStylesStrategy): void;
+  /**
+   * Retrieves all strategies registered for a given DTO class name.
+   *
+   * @param {string} dtoClassName - The DTO class name to look up.
+   * @returns {RTEFilterStylesStrategy[]} Registered strategies (empty array if none).
+   */
+  static getStrategies(dtoClassName: string): RTEFilterStylesStrategy[];
+}