@heartlandone/vega 2.77.1 → 2.79.0

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

@@ -30,127 +30,192 @@ export declare class VegaInputPhoneNumber {
   host: HTMLVegaInputPhoneNumberElement;
   phoneNumberInputValue: string;
   /**
-   * Specifies the label or title for the phone number input field.
-   *
-   * It provides descriptive text that helps identify the
-   *    purpose or content expected in the input field.
+   * Specifies the visible label text rendered above the phone number input.
+   * The label identifies the purpose of the field and serves as the
+   * accessible name for screen readers.
    *
+   * @default ''
    * @vegaVersion 2.18.0
    */
   label: string;
   /**
-   * Specifies the size of the phone number input field.
+   * Controls the visual size of the phone number input field.
+   *
+   * - `'default'` — Standard height, suitable for most form layouts.
+   * - `'small'` — Compact height, useful for dense UIs.
    *
+   * @default 'default'
    * @vegaVersion 2.18.0
    */
   size: 'default' | 'small';
   /**
-   * Determines whether the phone number input field is required.
+   * Determines whether the phone number input field must have a value before
+   * the form can be submitted. When `true`, the built-in
+   * `InputPhoneNumberRequiredRule` is applied during validation and a
+   * required indicator is shown on the label.
    *
+   * @default false
    * @vegaVersion 2.18.0
    */
   required: boolean;
   /**
-   * Determines whether the phone number input field is disabled.
+   * Specifies whether the phone number input field is disabled. When `true`,
+   * both the country selector and the phone number text field become
+   * non-interactive — the user cannot type, select a country, or focus
+   * any part of the component.
    *
+   * @default false
    * @vegaVersion 2.18.0
    */
   disabled: boolean;
   /**
-   * Specifies the default country calling code using the two-letter uppercase country code.
+   * Specifies the currently selected country using a two-letter uppercase
+   * ISO 3166-1 alpha-2 code (e.g., `'US'`, `'GB'`, `'CN'`). The country
+   * code determines the flag icon and calling code prefix displayed in the
+   * country selector. Changing this value updates the phone number prefix
+   * accordingly.
    *
+   * @default 'US'
    * @vegaVersion 2.18.0
-   * @defaultValue US
    */
   countryCode: VegaCountryCode;
   watchCountryCode(newCountryCode: VegaCountryCode, oldCountryCode: VegaCountryCode): void;
   /**
-   * Specifies the countries available for selection.
+   * An array of country codes available for selection in the country
+   * dropdown. Each entry must be a two-letter uppercase ISO 3166-1 alpha-2
+   * code.
    *
-   * Note: By default, 245 codes are provided, but loading all of them may take time. To improve performance, it is recommended to include only the necessary codes.
+   * By default all 245 supported codes are loaded, but providing a smaller
+   * subset improves initial render performance.
    *
+   * @default VegaCountryCode[] (all 245 codes)
    * @vegaVersion 2.18.0
-   * @defaultValue ['US', 'CN', ...]{@link VegaCountryCode}
    */
   allowedCountryCodes: VegaCountryCode[];
   /**
-   * Specifies whether the phone number input field can be set to an empty value.
-   * - `true`:
-   *      The value property is cleared when the input field is empty.
-   * - `false`:
-   *      The value property is `+1` when no phone number is entered.
+   * Controls whether the `value` property can be an empty string.
    *
+   * - `true` — The `value` property is cleared to `''` when the user
+   *   deletes all digits from the input field.
+   * - `false` — The `value` property always retains at least the country
+   *   calling code prefix (e.g., `'+1'` for US) even when no phone number
+   *   digits have been entered.
+   *
+   * @default false
    * @vegaVersion 2.35.0
    */
   emptyValueEnabled: boolean;
   watchEmptyValueEnabled(): void;
   /**
-   * Specifies the value of the phone number input in [E.164]{@link https://en.wikipedia.org/wiki/E.164} format.
+   * The current value of the phone number input in
+   * [E.164](https://en.wikipedia.org/wiki/E.164) format (e.g., `'+14155552671'`).
+   *
+   * This property is mutable and reflected to the host element attribute.
+   * It updates as the user types and can be set externally to pre-populate
+   * or reset the field. When `emptyValueEnabled` is `false` and no digits
+   * have been entered, the value defaults to the country calling code
+   * prefix (e.g., `'+1'` for US).
    *
-   * @VegaWarning - Note: The input phone number field will always have a value. If no phone number is entered, the default format is `+{default_country_code}`.
-   *              - For example, if the default country code is US, the default value will be `+1`.
+   * @default '+1'
    * @vegaVersion 2.18.0
-   * @defaultValue +1
    */
   value: string;
   watchValue(newValue: string, oldValue: string): void;
   /**
-   * Specifies custom validation rules for the phone number input field.
+   * An array of custom validation rules applied to the phone number input in
+   * addition to the built-in rules (`InputPhoneNumberRequiredRule`,
+   * `ValidPhoneNumberRule`). Each rule must implement the
+   * `FormFieldValidationRule` interface.
    *
+   * Rules are evaluated in order when `autoValidation` is enabled or when
+   * validation is triggered programmatically.
+   *
+   * @default []
    * @vegaVersion 2.18.0
    */
   validationRules: FormFieldValidationRule<unknown>[];
   watchValidationRules(): void;
   /**
-   * Indicates whether the current value in the field is considered valid
-   *    based on the defined validation rules.
+   * Reflects the current validation status of the phone number input.
+   *
+   * - `true` — the field value passes all validation rules.
+   * - `false` — one or more validation rules have failed.
+   * - `null` — the field has not been validated yet (initial state).
    *
+   * This property is mutable: it is updated automatically when
+   * `autoValidation` is enabled, but can also be set manually to override
+   * the validation state.
+   *
+   * @default null
    * @vegaVersion 2.18.0
    */
   isValid: boolean;
   /**
-   * Determines whether the phone number input field should undergo automatic validation
-   *    during the user's input.
+   * Determines whether the phone number input should be validated
+   * automatically as the user interacts with it. When `true`, validation
+   * rules (including `required`, `ValidPhoneNumberRule`, and custom
+   * `validationRules`) are evaluated and the `isValid` property is updated
+   * accordingly.
+   *
+   * Set to `false` to handle validation manually.
    *
+   * @default true
    * @vegaVersion 2.18.0
    */
   autoValidation: boolean;
   /**
-   * Specifies a placeholder string that displays as a temporary hint
-   *    or example inside the input field.
+   * Specifies placeholder text displayed inside the phone number text field
+   * when it is empty. The placeholder disappears once the user begins typing
+   * and is typically used to indicate the expected format
+   * (e.g., `'(555) 555-5555'`).
    *
+   * @default undefined
    * @vegaVersion 2.18.0
    */
   placeholder: string;
   /**
-   * Provides a supplementary prompt message that assists users in
-   *    understanding the expected value for the input field.
+   * Supplementary helper message displayed below the phone number input that
+   * assists users in understanding the expected value or provides additional
+   * context (e.g., `'We will send a verification code to this number'`).
    *
+   * @default ''
    * @vegaVersion 2.18.0
    */
   hint: string;
   /**
-   * An event emitter notifying a value change.
+   * Fires whenever the phone number value changes — including typing,
+   * pasting, or programmatic updates. The event detail contains the full
+   * phone number in E.164 format (e.g., `'+14155552671'`).
    *
+   * @eventDetail string
    * @vegaVersion 2.18.0
    */
   vegaChange: EventEmitter<string>;
   /**
-   * An event emitter notifying a value change.
+   * Native-equivalent mirror of `vegaChange`. Fires with the same payload
+   * and at the same time, allowing consumers to listen using the standard
+   * `change` event name.
    *
+   * @eventDetail string
    * @eventSemantics namespace:native
    * @vegaVersion 2.18.0
    */
   change: EventEmitter<string>;
   /**
-   * An event emitter notifying a country change.
+   * Fires whenever the selected country changes via the country dropdown.
+   * The event detail contains a `VegaCountryType` object with the country
+   * code, calling code, and display name of the newly selected country.
    *
+   * @eventDetail VegaCountryType
    * @vegaVersion 2.18.0
    */
   vegaCountryChange: EventEmitter<VegaCountryType>;
   /**
-   * An event emitter notifying a country change.
+   * Native-equivalent mirror of `vegaCountryChange`. Fires with the same
+   * payload and at the same time, allowing consumers to listen using the
+   * standard `countryChange` event name.
    *
+   * @eventDetail VegaCountryType
    * @eventSemantics namespace:native
    * @vegaVersion 2.18.0
    */

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

@@ -10,6 +10,7 @@ export declare class VegaInputRangeInputRenderer extends VegaSlimmer {
   protected max: VegaInputRange['max'];
   protected size: VegaInputRange['size'];
   protected placeholder: VegaInputRange['placeholder'];
+  protected label: VegaInputRange['label'];
   protected showClearIcon: VegaInputRange['showClearIcon'];
   protected valueController: VegaInputRange['valueController'];
   protected clearIconRenderer: VegaInputRange['clearIconRenderer'];
@@ -54,6 +55,13 @@ export declare class VegaInputRangeInputRenderer extends VegaSlimmer {
    * @returns {string} the input placeholder text
    */
   private getPlaceholderByIndex;
+  /**
+   * Get the data aria label for the input range input by the input range index
+   *
+   * @param {number} index the range index 0|1
+   * @returns {string} the data aria label for the input range input
+   */
+  private getDataAriaLabel;
   /**
    * get the input value by the input range index
    *

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

@@ -80,11 +80,11 @@ export declare class VegaInputSelect {
    * Allows customization of the text displayed within the
    *    select field when single or multiple items are selected.
    *    The default format for the selected label is
-   *    `${number of selected items} Selected` for multiple mode only.
+   *    `{0} Selected` for multiple mode only.
    *
    *	To enable all modes, use the `SelectedLabelTypeForAllModes` type.
    * 		For single mode, the default format is the `displayName` of the selected item if not set
-   * 		For multiple mode, the default format is `${number of selected items} Selected` if not set
+   * 		For multiple mode, the default format is `{0} Selected` if not set
    *
    * @vegaVersion 1.35.0
    */

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

@@ -32,6 +32,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/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/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[];
+}

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

@@ -0,0 +1,25 @@
+import { Nullable } from '../../../../types/general';
+export declare type RTEFilterStyles = Record<string, string>;
+/**
+ * Abstract strategy class for filtering default styles in the rich text editor.
+ * Concrete strategies define which styles to strip via `stylesToBeFiltered`.
+ *
+ * This base is shared by two kinds of concrete strategies:
+ *   1. Block/node output strategies – filter inline styles when converting DTO → HTML.
+ *   2. Annotation parsing strategies – strip redundant defaults when converting HTML → DTO.
+ */
+export declare abstract class RTEFilterStylesStrategy {
+  /**
+   * The styles that the strategy is responsible for filtering.
+   * Must be defined in each concrete implementation.
+   */
+  protected abstract stylesToBeFiltered: RTEFilterStyles;
+  /**
+   * Removes configured default style properties from the target styles object.
+   * Only properties whose value matches the configured default exactly are deleted.
+   *
+   * @param {Nullable<RTEFilterStyles>} styles - The styles object to mutate.
+   * @returns {boolean} `true` if at least one style was extracted.
+   */
+  protected extractAndDeleteMatchedStyles(styles: Nullable<RTEFilterStyles>): boolean;
+}

package/dist/types/components/vega-rich-text-editor/dto/renderers/nodes/text-node-renderer.d.ts

@@ -1,9 +1,7 @@
 import { RTENodeRenderer } from './node-renderer.abstract';
 import { RTETextNode } from '../../nodes/text-node';
-import { Nullable } from '../../../../../types/general';
 declare class RTETextNodeRenderer extends RTENodeRenderer {
   render(node: RTETextNode): HTMLElement;
-  protected registerRef(ref: Nullable<HTMLElement>, node: RTETextNode): void;
   private renderWithWrapper;
   private renderText;
 }

package/dist/types/components/vega-rich-text-editor/extensions/extension.abstract.d.ts

@@ -10,6 +10,8 @@ import { ActionHandleStrategy } from '../dto/action-handle-strategies/action-han
 import { ModifyContentAction } from '../dto/actions/modify-content-action.abstract';
 import type { VegaRTEContent } from '../dto/content-state';
 import { ActionHandlerInterceptor } from '../dto/action-handle-strategies/action-handle-interceptor.abstract';
+import { AnnotationGeneratorStrategyAbstract } from '../slimmers/controllers/helper/element-to-dto-strategy/annotation-handler/annotation-generator-strategy.abstract';
+import { AnnotationAction } from '../dto/actions/annotation-action.abstract';
 /**
  * Abstract class for Vega Rich Text Editor extensions.
  */
@@ -24,9 +26,9 @@ export declare abstract class VegaRTEExtension {
    *
    * @param {string} nodeOrBlockClassName - The name of the node or block class.
    * @param {string} actionType - The type of the action.
-   * @param {ActionHandleStrategy<ModifyContentAction, RTENode | RTEBlock | VegaRTEContent>} strategy - The strategy to register.
+   * @param {ActionHandleStrategy<ModifyContentAction | AnnotationAction, RTENode | RTEBlock | VegaRTEContent>} strategy - The strategy to register.
    */
-  static registerActionHandleStrategy(nodeOrBlockClassName: string, actionType: string, strategy: ActionHandleStrategy<ModifyContentAction, RTENode | RTEBlock | VegaRTEContent>): void;
+  static registerActionHandleStrategy(nodeOrBlockClassName: string, actionType: string, strategy: ActionHandleStrategy<ModifyContentAction | AnnotationAction, RTENode | RTEBlock | VegaRTEContent>): void;
   /**
    * Registers an action handler interceptor for a specific node or block class.
    *
@@ -41,6 +43,11 @@ export declare abstract class VegaRTEExtension {
    * @param {RTEExtensionContext} context - The context of the RTE extension.
    */
   initialExtension(context: RTEExtensionContext): void;
+  /**
+   * Callback method invoked when the extension is destroyed.
+   * Override this method to perform any necessary cleanup.
+   */
+  destroyExtension(): void;
   /**
    * Collect custom styles for the extension renderers.
    * If custom nodes have special styles, override this method to provide the styles.
@@ -112,4 +119,10 @@ export declare abstract class VegaRTEExtension {
    * @returns {ElementToDTOStrategy[]} - The registered element to node DTO class strategies.
    */
   protected getElementToNodeDTOClassStrategies(): ElementToDTOStrategy[];
+  /**
+   * Register a custom annotation handler for HTML to DTO conversion.
+   *
+   * @param {AnnotationGeneratorStrategyAbstract} handler - The annotation handler to register.
+   */
+  protected registerAnnotationHandler(handler: AnnotationGeneratorStrategyAbstract): void;
 }

package/dist/types/components/vega-rich-text-editor/extensions/table/action-handler-interceptors/prevent-cell-children-remove-interceptor.d.ts

@@ -0,0 +1,25 @@
+import { ActionHandlerExecution, ActionHandlerInterceptor } from '../../../dto/action-handle-strategies/action-handle-interceptor.abstract';
+import { RemoveChildrenAction } from '../../../dto/actions/remove-child-action';
+import type { RTETableCellBlock } from '../dto/table-cell-block';
+import type { RTETableHeadCellBlock } from '../dto/table-head-cell-block';
+/**
+ * Interceptor to prevent removal of all children from a cell, ensuring at least one child remains.
+ */
+export declare class PreventCellChildrenRemoveInterceptor extends ActionHandlerInterceptor<RemoveChildrenAction, RTETableCellBlock | RTETableHeadCellBlock> {
+  /**
+   * Prevent removal if the target cell would be left empty after the action.
+   *
+   * @param {RemoveChildrenAction} action - the action to be intercepted
+   * @param {RTETableCellBlock | RTETableHeadCellBlock} target - the target cell block
+   * @returns {boolean} - true if the removal should be intercepted, false otherwise
+   */
+  canIntercept(action: RemoveChildrenAction, target: RTETableCellBlock | RTETableHeadCellBlock): boolean;
+  /**
+   * Add a new empty text node to the cell to prevent it from removal.
+   *
+   * @param {ActionHandlerExecution} _execution - the original execution function
+   * @param {RemoveChildrenAction} action - the action to be intercepted
+   * @param {RTETableCellBlock | RTETableHeadCellBlock} target - the target cell block
+   */
+  intercept(_execution: ActionHandlerExecution, action: RemoveChildrenAction, target: RTETableCellBlock | RTETableHeadCellBlock): void;
+}

package/dist/types/components/vega-rich-text-editor/extensions/table/action-handler-interceptors/prevent-cell-content-delete-interceptor.d.ts

@@ -0,0 +1,20 @@
+import { ActionHandlerInterceptor } from '../../../dto/action-handle-strategies/action-handle-interceptor.abstract';
+import { DeleteBlockContentAction } from '../../../dto/actions/delete-block-content-action';
+import type { RTETextBlock } from '../../../dto/blocks/text-block';
+/**
+ * Interceptor to prevent deletion of a table cell if it is the cell with empty content.
+ */
+export declare class PreventCellContentDeleteInterceptor extends ActionHandlerInterceptor<DeleteBlockContentAction, RTETextBlock> {
+  /**
+   * Prevent deletion if the target block is the only child of a table cell and is empty.
+   *
+   * @param {DeleteBlockContentAction} action - the action to be intercepted
+   * @param {RTETextBlock} target - the target block
+   * @returns {boolean} - true if the deletion should be intercepted, false otherwise
+   */
+  canIntercept(action: DeleteBlockContentAction, target: RTETextBlock): boolean;
+  /**
+   * @inheritDoc
+   */
+  intercept(): void;
+}

package/dist/types/components/vega-rich-text-editor/extensions/table/action-handler-interceptors/prevent-row-insert-interceptor.d.ts

@@ -0,0 +1,19 @@
+import type { InsertChildrenBeforeAction } from '../../../dto/actions/insert-children-before-block';
+import type { RTETableRowBlock } from '../dto/table-row-block';
+import { ActionHandlerInterceptor } from '../../../dto/action-handle-strategies/action-handle-interceptor.abstract';
+/**
+ * Interceptor to prevent insertion of non-cell blocks into a table row.
+ */
+export declare class PreventRowInsertInterceptor extends ActionHandlerInterceptor<InsertChildrenBeforeAction, RTETableRowBlock> {
+  /**
+   * Prevent insertion if any of the children to be inserted is not a table cell block.
+   *
+   * @param {InsertChildrenBeforeAction} action - the action to be intercepted
+   * @returns {boolean} - true if the insertion should be intercepted, false otherwise
+   */
+  canIntercept(action: InsertChildrenBeforeAction): boolean;
+  /**
+   * @inheritDoc
+   */
+  intercept(): void;
+}