@heartlandone/vega 2.67.0 → 2.68.0

package/dist/types/components/vega-field-label/slimmers/renderers/vega-field-label-suffix-element-renderer.d.ts

@@ -4,6 +4,7 @@ import { Nullable } from '../../../../types/general';
 /** Render the suffix button in a field label component. */
 export declare class VegaFieldLabelSuffixElementRenderer extends VegaSlimmer {
   protected suffixButtonProps: VegaFieldLabel['suffixButtonProps'];
+  protected suffixButtonConfig: VegaFieldLabel['suffixButtonConfig'];
   protected suffixButtonClickEventEmitter: VegaFieldLabel['suffixButtonClickEventEmitter'];
   /**
    * Render a suffix button if the property is not empty.

package/dist/types/components/vega-field-label/types.d.ts

@@ -1,5 +1,17 @@
+/**
+ * @deprecated Please use `LabelSuffixButtonConfig` instead
+ */
 export type LabelSuffixButtonProps = {
 	icon: string;
 	tooltipText?: string;
 	trigger?: 'hover' | 'click';
 };
+
+export type LabelSuffixButtonConfig = {
+	icon: string;
+} & Partial<
+	Pick<
+		HTMLVegaTooltipElement,
+		'trigger' | 'size' | 'minWidth' | 'maxWidth' | 'text' | 'placement' | 'alignment'
+	>
+>;

package/dist/types/components/vega-field-label/vega-field-label.d.ts

@@ -2,8 +2,9 @@ import { EventEmitter } from '../../stencil-public-runtime';
 import { GlobalSlimmers } from '../../vega-slimmer/vega-slimmer-core';
 import { EventEmitSlimmerBase } from '../../helpers/event-manager/slimmers/event-emit-slimmer';
 import { VegaComponentUsageRuntimeMetricsSlimmer } from '../../helpers/slimmers/component-usage-runtime-metrics';
-import { LabelSuffixButtonProps } from './types';
+import { LabelSuffixButtonConfig, LabelSuffixButtonProps } from './types';
 import { VegaFieldLabelSuffixElementRenderer } from './slimmers/renderers/vega-field-label-suffix-element-renderer';
+import { Nullable } from '../../types/general';
 /**
  * @vegaVersion 1.10.0
  */
@@ -15,6 +16,8 @@ export declare class VegaFieldLabel {
   protected suffixElementRenderer: VegaFieldLabelSuffixElementRenderer;
   host: HTMLVegaFieldLabelElement;
   /**
+   * @deprecated Please use `suffixButtonConfig` instead
+   *
    * Specifies the properties for the suffix button associated with the input.
    *
    * It provides essential information and functionality related to
@@ -23,6 +26,15 @@ export declare class VegaFieldLabel {
    * @vegaVersion 2.25.0
    */
   suffixButtonProps: LabelSuffixButtonProps;
+  /**
+   * Specifies the properties for the suffix button associated with the input.
+   *
+   * It provides essential information and functionality related to
+   *    the suffix button's role and behavior.
+   *
+   * @vegaVersion 2.68.0
+   */
+  suffixButtonConfig: Nullable<LabelSuffixButtonConfig>;
   /**
    * Specifies the label or title for the field.
    *

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

@@ -8,10 +8,11 @@ import { VegaInputCopyPasteController } from './slimmers/controllers/vega-input-
 import { VegaInputPrefixSlotRenderer } from './slimmers/renderers/vega-input-prefix-slot-renderer';
 import { VegaInputMaskConfigController } from './slimmers/controllers/vega-input-mask-config-controller';
 import { VegaComponentUsageRuntimeMetricsSlimmer } from '../../helpers/slimmers/component-usage-runtime-metrics';
-import { LabelSuffixButtonProps } from '../vega-field-label/types';
+import { LabelSuffixButtonConfig, LabelSuffixButtonProps } from '../vega-field-label/types';
 import { VegaInputCompactWidthController } from './slimmers/controllers/vega-input-compact-width-controller';
 import { PageResizeObserverSlimmer } from '../../helpers/slimmers/page-resize-observer-slimmer';
 import { VegaInputStateController } from './slimmers/controllers/vega-input-state-controller';
+import { Nullable } from '../../types/general';
 /**
  * @vegaVersion 1.0.5
  */
@@ -47,6 +48,8 @@ export declare class VegaInput {
    */
   label: string;
   /**
+   * @deprecated Please use `LabelSuffixButtonConfig` instead
+   *
    * Specifies the properties for the suffix button associated with the input.
    *
    * It provides essential information and functionality
@@ -54,7 +57,16 @@ export declare class VegaInput {
    *
    * @vegaVersion 2.25.0
    */
-  labelSuffixButtonProps: LabelSuffixButtonProps;
+  labelSuffixButtonProps: Nullable<LabelSuffixButtonProps>;
+  /**
+   * Specifies the properties for the suffix button associated with the input.
+   *
+   * It provides essential information and functionality
+   *  related to the suffix button's role and behavior.
+   *
+   * @vegaVersion 2.68.0
+   */
+  labelSuffixButtonConfig: Nullable<LabelSuffixButtonConfig>;
   /**
    * Represents a pre-set or default value for the input field.
    *

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

@@ -7,9 +7,12 @@ export declare class VegaInputSelectRenderer extends VegaSlimmer {
   private hint;
   private label;
   private required;
+  private labelSuffixButtonConfig;
+  private labelButtonClickEventEmitter;
   private dropdownRenderer;
   render(): VegaInputSelect;
   private renderLabel;
   private renderErrorMessage;
   private renderHelpMessage;
+  private handleLabelButtonClick;
 }

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

@@ -19,6 +19,8 @@ import { VegaInputSelectItemsSlotController } from './slimmers/controllers/vega-
 import { TranslationSlimmer } from '../../helpers/slimmers/translation';
 import { VegaDropdownSearchTriggerEventDetail } from '../vega-dropdown/types';
 import { VegaInputSelectPrefixIconRenderer } from './slimmers/renderers/vega-input-select-prefix-icon-renderer';
+import { LabelSuffixButtonConfig } from '../vega-field-label/types';
+import { Nullable } from '../../types/general';
 /**
  * @vegaVersion 1.0.7
  */
@@ -40,6 +42,7 @@ export declare class VegaInputSelect {
   protected searchTriggerEventEmitter: EventEmitSlimmerBase;
   protected showEventEmitter: EventEmitSlimmerBase;
   protected hideEventEmitter: EventEmitSlimmerBase;
+  protected labelButtonClickEventEmitter: EventEmitSlimmerBase;
   protected eventPrevent: ChildNodesEventPreventSlimmer;
   protected vegaComponentUsageRuntimeMetricsSlimmer: VegaComponentUsageRuntimeMetricsSlimmer<HTMLVegaInputSelectElement>;
   host: HTMLVegaInputSelectElement;
@@ -55,6 +58,15 @@ export declare class VegaInputSelect {
    * @vegaVersion 1.3.0
    */
   label: string;
+  /**
+   * Specifies the properties for the suffix button associated with the input.
+   *
+   * It provides essential information and functionality
+   *  related to the suffix button's role and behavior.
+   *
+   * @vegaVersion 2.68.0
+   */
+  labelSuffixButtonConfig: Nullable<LabelSuffixButtonConfig>;
   /**
    * Determines whether the input select field is required.
    *
@@ -231,6 +243,19 @@ export declare class VegaInputSelect {
    * @vegaVersion 2.32.0
    */
   vegaHide: EventEmitter<string>;
+  /**
+   * An event emitter notifying that the suffix button associated with the field label has been clicked.
+   *
+   * @vegaVersion 2.68.0
+   */
+  vegaLabelButtonClick: EventEmitter;
+  /**
+   * An event emitter notifying that the suffix button associated with the field label has been clicked.
+   *
+   * @eventSemantics namespace:native
+   * @vegaVersion 2.68.0
+   */
+  labelButtonClick: EventEmitter;
   componentWillLoad(): void;
   /**
    * Invoke this method to close the select dropdown and clear

package/dist/types/components/vega-rich-text-content/slimmers/controllers/vega-rich-text-content-extensions-styles-controller.d.ts

@@ -0,0 +1,26 @@
+import { VegaSlimmer } from '../../../../vega-slimmer/vega-slimmer-core';
+import { VegaRichTextContent } from '../../vega-rich-text-content';
+import { VegaRTEExtension } from '../../../vega-rich-text-editor/extensions/extension.abstract';
+/**
+ * attach the extension styles to the host.
+ */
+export declare class RTEExtensionStylesController extends VegaSlimmer {
+  protected extensions: VegaRichTextContent['extensions'];
+  protected host: HTMLVegaRichTextContentElement;
+  protected extensionStyles: VegaRichTextContent['extensionStyles'];
+  /**
+   * Attach extension styles to the host after load.
+   */
+  protected attachExtensionStyles(): void;
+  /**
+   * Update extension context when extensions property changes.
+   *
+   * @param {VegaRTEExtension[]} newValue - New extensions array.
+   * @param {VegaRTEExtension[]} oldValue - Old extensions array.
+   */
+  protected handleExtensionsChange(newValue: VegaRTEExtension[], oldValue: VegaRTEExtension[]): void;
+  /**
+   * Collects and attaches custom styles from all extensions to the host component.
+   */
+  private attachStylesToHost;
+}

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

@@ -5,6 +5,7 @@ export declare class VegaRichTextContentRenderer extends VegaSlimmer {
   placeholder: VegaRichTextContent['placeholder'];
   contentEditable: VegaRichTextContent['contentEditable'];
   content: VegaRichTextContent['content'];
+  extensionStyles: VegaRichTextContent['extensionStyles'];
   private richTextContentRef;
   componentWillLoad(): void;
   constructor();

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

@@ -4,6 +4,7 @@ import { VegaRichTextContentRenderer } from './slimmers/renderers/vega-rich-text
 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';
 /**
  * @vegaVersion 2.34.0
  */
@@ -12,6 +13,7 @@ export declare class VegaRichTextContent {
   protected vegaComponentUsageRuntimeMetricsSlimmer: VegaComponentUsageRuntimeMetricsSlimmer<HTMLVegaRichTextContentElement>;
   protected readonly vegaRichTextContentRenderer: VegaRichTextContentRenderer;
   protected readonly vegaRichTextContentStateController: VegaRichTextContentStateController;
+  protected readonly vegaRichTextContentExtensionsStylesController: RTEExtensionStylesController;
   host: HTMLVegaRichTextContentElement;
   /**
    * Specifies a placeholder string that displays as a
@@ -29,6 +31,10 @@ export declare class VegaRichTextContent {
    * @vegaVersion 2.34.0
    */
   contentEditable: boolean;
+  /**
+   * Holds the custom styles generated by extensions.
+   */
+  extensionStyles: string;
   /**
    * 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.
@@ -45,6 +51,7 @@ export declare class VegaRichTextContent {
    * @vegaVersion 2.62.0
    */
   extensions: VegaRTEExtension[];
+  watchExtensions(newValue: VegaRTEExtension[], oldValue: VegaRTEExtension[]): void;
   /**
    * Invoke this method to focus on rich text content editable div
    *

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

@@ -0,0 +1,42 @@
+import { Nullable } from '../../../../types/general';
+import { AnnotationAction } from '../actions/annotation-action.abstract';
+import { ModifyContentAction } from '../actions/modify-content-action.abstract';
+import { RTEBlock } from '../blocks/block.abstract';
+import { VegaRTEContent } from '../content-state';
+import { RTENode } from '../nodes/node.abstract';
+import { ActionHandlerInterceptor } from './action-handle-interceptor.abstract';
+declare type RTEActionType = ModifyContentAction | AnnotationAction;
+declare type RTEDTOClass = RTENode | RTEBlock | VegaRTEContent;
+/**
+ * Registry for action handler interceptors, which can register and retrieve interceptors for specific actions and targets.
+ */
+export declare class ActionHandlerInterceptorRegistry {
+  private static readonly registry;
+  /**
+   * Bind a specific strategy to a special action type of the rich text node.
+   *
+   * @param {string} actionType - The special action type or the action class name.
+   * @param {string} targetClass - The rich text node class name.
+   * @param {ActionHandlerInterceptor} strategy - The action handle strategy instance.
+   */
+  static register<T extends RTEActionType, target extends RTEDTOClass>(actionType: string, targetClass: string, strategy: ActionHandlerInterceptor<T, target>): void;
+  /**
+   * Unregister the strategy for the specific action type and target class.
+   *
+   * @param {string} actionType - The special action type or the action class name.
+   * @param {string} targetClass - The rich text node class name.
+   * @param {ActionHandlerInterceptor} strategy - The action handler interceptor instance.
+   */
+  static unregister(actionType: string, targetClass: string, strategy: ActionHandlerInterceptor<RTEActionType, RTEDTOClass>): void;
+  /**
+   * Get the special interceptor strategy that before handle the action logic.
+   *
+   * @typedef T generic type
+   * @typedef target generic type
+   * @param {RTEActionType} action - The special action .
+   * @param {string} targetClass - The rich text node class name.
+   * @returns {Nullable<ActionHandlerInterceptor<T, target>>} - The action handler interceptor instance or null if not found.
+   */
+  static get<T extends RTEActionType, target extends RTEDTOClass>(action: RTEActionType, targetClass: target): Nullable<ActionHandlerInterceptor<T, target>>;
+}
+export {};

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

@@ -0,0 +1,26 @@
+import { AnnotationAction } from '../actions/annotation-action.abstract';
+import { ModifyContentAction } from '../actions/modify-content-action.abstract';
+import type { RTEBlock } from '../blocks/block.abstract';
+import type { VegaRTEContent } from '../content-state';
+import type { RTENode } from '../nodes/node.abstract';
+export declare type ActionHandlerExecution = () => unknown;
+/**
+ * Abstract class for action handler interceptors, which can intercept actions before they are handled.
+ */
+export declare abstract class ActionHandlerInterceptor<T extends ModifyContentAction | AnnotationAction, TargetElement extends RTENode | RTEBlock | VegaRTEContent> {
+  /**
+   * Checks whether the interceptor can intercept the given action and target.
+   *
+   * @param {ModifyContentAction | AnnotationAction} action - the action to be intercepted
+   * @param {RTENode | RTEBlock | VegaRTEContent} target - the target of the action
+   * @returns {boolean} - true if the interceptor can intercept, false otherwise
+   */
+  abstract canIntercept(action: T, target: TargetElement): boolean;
+  /**
+   * Called before handling the given action and target.
+   *
+   * @param {ModifyContentAction | AnnotationAction} action - the action to be handled
+   * @param {RTENode | RTEBlock | VegaRTEContent} target - the target of the action
+   */
+  abstract intercept(execution: ActionHandlerExecution, action: T, target: TargetElement): unknown;
+}

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

@@ -18,6 +18,13 @@ export declare class ActionHandleStrategyRegistry {
    * @param {ActionHandleStrategy} strategy - The action handle strategy instance.
    */
   static register<T extends ModifyContentAction | AnnotationAction, target extends RTENode | RTEBlock | VegaRTEContent, R = void>(actionType: string, targetClass: string, strategy: ActionHandleStrategy<T, target, R>): void;
+  /**
+   * Unregister the strategy for the specific action type and target class.
+   *
+   * @param {string} actionType - The special action type or the action class name.
+   * @param {string} targetClass - The rich text node class name.
+   */
+  static unregister(actionType: string, targetClass: string): void;
   /**
    * Get the special strategy that handle the action logic.
    *
@@ -42,8 +49,8 @@ export declare class ActionHandleStrategyRegistry {
    * Check if the action type can be handled by strategy for the specific RTE instance.
    *
    * @param {string} actionType - The special action type or the action class name.
-   * @param {RTENode | RTEBlock} RTEInstance - The rich text editor node.
+   * @param {RTENode | RTEBlock | VegaRTEContent} RTEInstance - The rich text editor node.
    * @returns {boolean} - Whether the action type can be handled by the strategy.
    */
-  static canHandle(actionType: string, RTEInstance: RTENode | RTEBlock): boolean;
+  static canHandle(actionType: string, RTEInstance: RTENode | RTEBlock | VegaRTEContent): boolean;
 }

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

@@ -58,4 +58,11 @@ export declare abstract class BlockDeleteNodeContentStrategy<T extends RTEBlock>
    * @returns {Nullable<RTEBlock>} The next block if existing
    */
   private getNextBlock;
+  /**
+   * Checks if the given instance is not the root content block.
+   *
+   * @param {RTEBlock | VegaRTEContent} block - The instance to check.
+   * @returns {boolean} True if the block is not the root content block, false otherwise.
+   */
+  private isRTEBlock;
 }

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

@@ -0,0 +1,12 @@
+import { PasteContentAction } from '../../actions/paste-content-action';
+import { RTEBlock } from '../../blocks/block.abstract';
+import { ActionHandleStrategy } from '../action-handle-strategy.abstract';
+/**
+ * Strategy to handle the paste content into function block.
+ */
+export declare class PasteContentStrategy extends ActionHandleStrategy<PasteContentAction, RTEBlock> {
+  /**
+   * @inheritDoc
+   */
+  protected handleAction(action: PasteContentAction, target: RTEBlock): void;
+}

package/dist/types/components/vega-rich-text-editor/dto/actions/modify-content-action.abstract.d.ts

@@ -27,7 +27,8 @@ export declare enum ModifyContentActionType {
   'DELETE_LINK_GROUP' = "DELETE_LINK_GROUP",
   'UPDATE_CURSOR_POSITION' = "UPDATE_CURSOR_POSITION",
   'INSERT_TEXT_TO_DECORATOR_NODE' = "INSERT_TEXT_TO_DECORATOR_NODE",
-  'INSERT_NODE_TO_NEAREST_ROOT' = "INSERT_NODE_TO_NEAREST_ROOT"
+  'INSERT_NODE_TO_NEAREST_ROOT' = "INSERT_NODE_TO_NEAREST_ROOT",
+  'PASTE_CONTENT' = "PASTE_CONTENT"
 }
 /**
  * Abstract class for update node content, delete node, insert node

package/dist/types/components/vega-rich-text-editor/dto/actions/paste-content-action.d.ts

@@ -0,0 +1,20 @@
+import { ModifyContentAction, ModifyContentActionType } from './modify-content-action.abstract';
+import { RTENode } from '../nodes/node.abstract';
+import { RTEBlock } from '../blocks/block.abstract';
+import { RTERange } from '../range';
+import { Nullable } from '../../../../types/general';
+/**
+ * Action to paste new content into current block.
+ *
+ * @example functionBlock.apply(new PasteContentAction(blocksToBeInserted, startNode, startOffset))
+ * @example host.value.apply(new PasteContentAction(blocksToBeInserted, startNode, startOffset))
+ */
+export declare class PasteContentAction extends ModifyContentAction {
+  type: ModifyContentActionType;
+  blocksToBeInserted: RTEBlock[];
+  startNode: RTENode;
+  startOffset: number;
+  rteRange: Nullable<RTERange>;
+  futureFocusBlock: RTEBlock;
+  constructor(blocksToBeInserted: RTEBlock[], startNode: RTENode, startOffset: number, rteRange?: RTERange);
+}

package/dist/types/components/vega-rich-text-editor/dto/actions/update-cursor-position-action.d.ts

@@ -7,6 +7,7 @@ import { ModifyContentAction } from './modify-content-action.abstract';
  * @example richEditorRef.value.apply(new UpdateCursorPositionAction(nextFocusNode, [offset], [immediatelyRun]))
  */
 export declare class UpdateCursorPositionAction extends ModifyContentAction {
+  isFlushable: boolean;
   type: string;
   nextFocusNode: RTENode;
   offset: Nullable<number>;

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

@@ -0,0 +1,46 @@
+import { AnnotationStyle, RTERenderContext } from '../../interface';
+import { RTEBlock } from '../blocks/block.abstract';
+import { RTENode } from '../nodes/node.abstract';
+/**
+ * Class to handle the style representation of annotations for RTE blocks and nodes.
+ */
+export declare class RTEAnnotationStyle<T extends RTEBlock | RTENode> {
+  private dtoType;
+  private annotationMap;
+  constructor(dto: T);
+  /**
+   * Convert an AnnotationStyle object to a CSS text string.
+   *
+   * @param {RTERenderContext} options - Rendering context options.
+   * @param {string[]} canMergeKeyList - List of style keys that can be merged by concatenation.
+   * @param {Nullable<AnnotationStyle>} annotationStyle - The annotation style object, if null, get from toJSON().
+   * @returns {string} A string representing the CSS text.
+   */
+  toCssText(options?: RTERenderContext, canMergeKeyList?: string[], annotationStyle?: AnnotationStyle): string;
+  /**
+   * Convert the annotation map to a JSON representation.
+   *
+   * @param {RTERenderContext} options - Rendering context options.
+   * @param {string[]} canMergeKeyList - List of style keys that can be merged by concatenation.
+   * @returns {AnnotationStyle} - The JSON representation of the annotation styles.
+   */
+  toJSON(options?: RTERenderContext, canMergeKeyList?: string[]): AnnotationStyle;
+  /**
+   * Filter annotations based on whether they are block or node annotations.
+   *
+   * @param {RTENodeAnnotationMapValue | RTEBlockAnnotationMapValue} annotation - The annotation to filter.
+   * @returns {boolean} - True if the annotation matches the DTO type, false otherwise.
+   */
+  private filterAnnotation;
+  /**
+   * Merge an array of annotation styles into a single style object.
+   * e.g.,
+   * { textDecoration: 'underline', textDecoration: 'line-through' }
+   * -> { textDecoration: 'underline line-through' }
+   *
+   * @param {AnnotationStyle[]} styles - Array of annotation style objects to merge.
+   * @param {string[]} canMergeKeyList - List of style keys that can be merged by concatenation.
+   * @returns {AnnotationStyle} - The merged annotation style object.
+   */
+  private mergeAnnotationStyles;
+}

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

@@ -1,4 +1,4 @@
-import { AnnotationStyle, RTEBlockAnnotationMapKey, RTEBlockAnnotationMapValue, RTERenderContext, VegaRTEBlockAnnotations, VegaRTEBlockBase, VegaRTETransformOptions } from '../../interface';
+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';
@@ -31,6 +31,15 @@ export declare abstract class RTEBlock<P = RTEBlockParentType, C = RTEBlockChild
    * @param {VegaRTETransformOptions} options - Options for transforming the block.
    */
   static from(json: unknown, options?: VegaRTETransformOptions): InstanceType<ClassType<RTEBlock>>;
+  /**
+   * Generates block children from an array of VegaRTEContentBlock.
+   *
+   * @param {VegaRTEContentBlock[]} blockArray - The array of VegaRTEContentBlock to generate children from.
+   * @param {VegaRTETransformOptions} [options] - Optional transformation options.
+   * @param {VegaRTEContent | RTEBlock} [parentBlock] - Optional parent block.
+   * @returns {RTEBlock[]} An array of generated RTEBlock children.
+   */
+  static generateBlockChildren(blockArray: VegaRTEContentBlock[], options?: VegaRTETransformOptions, parentBlock?: RTEBlockParentType): RTEBlock[];
   /**
    * The function `createAnnotationEntity` creates a block annotation entity based on the provided type
    * and value.

package/dist/types/components/vega-rich-text-editor/dto/blocks/html-block.d.ts

@@ -1,15 +1,15 @@
 import { RTEBlock } from './block.abstract';
-import { VegaRTEHtmlBlock, VegaRTETransformOptions, RTEContentBlock } from '../../interface';
+import { VegaRTEHtmlBlock, VegaRTETransformOptions } from '../../interface';
 import { VegaRTEContent } from '../content-state';
 import { RTENode } from '../nodes/node.abstract';
 /**
  * HTML Block
  */
-export declare class RTEHtmlBlock extends RTEBlock<VegaRTEContent | RTEHtmlBlock, RTEContentBlock> {
+export declare class RTEHtmlBlock extends RTEBlock<VegaRTEContent | RTEHtmlBlock, RTEBlock> {
   type: 'html-block';
   parent: VegaRTEContent | RTEHtmlBlock;
   htmlTag: string;
-  children: RTEContentBlock[];
+  children: RTEBlock[];
   constructor(id: string, htmlTag: string);
   /**
    * Converts a VegaRTEHtmlBlock to an RTEHtmlBlock.

package/dist/types/components/vega-rich-text-editor/dto/blocks/text-block.d.ts

@@ -82,6 +82,12 @@ export declare class RTETextBlock extends RTEBlock<VegaRTEContent | RTEListBlock
    * @returns {RTETextBlockTagType} The HTML tag for the block.
    */
   getBlockTag(): RTETextBlockTagType;
+  /**
+   * Get the HTML string for the children nodes, including handling link group annotations.
+   *
+   * @returns {string} The HTML string representing the children nodes.
+   */
+  getChildrenHtml(): string;
   /**
    * @inheritDoc
    */

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

@@ -126,17 +126,6 @@ export declare abstract class RTENode<P extends RTEBlock = RTEBlock> {
    * @param {ModifyContentAction} action ModifyContentAction
    */
   protected doModifyActionApply(action: ModifyContentAction): void;
-  /**
-   * Merge an array of annotation styles into a single style object.
-   * e.g.,
-   * { textDecoration: 'underline', textDecoration: 'line-through' }
-   * -> { textDecoration: 'underline line-through' }
-   *
-   * @param {AnnotationStyle[]} styles - Array of annotation style objects to merge.
-   * @param {string[]} canMergeKeyList - List of style keys that can be merged by concatenation.
-   * @returns {AnnotationStyle} - The merged annotation style object.
-   */
-  private mergeAnnotationStyles;
   /**
    * Clone the node.
    *

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

@@ -1,3 +1,5 @@
+import { BaseRenderer } from '../../../helpers/rte-manager/dto-renderer-manager';
+import { Nullable } from '../../../types/general';
 import { RTEBlock } from '../dto/blocks/block.abstract';
 import { RTENode } from '../dto/nodes/node.abstract';
 import { VegaRTEBaseRenderer } from '../dto/renderers/base-renderer';
@@ -8,6 +10,13 @@ declare type VegaRTEUseRef = (element: HTMLElement) => void;
  */
 export declare abstract class VegaRTEExtensionRenderer extends VegaRTEBaseRenderer<RTEBlock | RTENode, VegaRTERenderResult> {
   static REGISTER_REF_FLAG: string;
+  /**
+   * Returns the styles to be injected into the RTE scope.
+   * Override this method to provide custom styles for the custom blocks or nodes.
+   *
+   * @returns {string} - The styles as a string.
+   */
+  injectRTEScopeStyles(): string;
   /**
    * Renders the given data as a DOM element.
    *
@@ -24,6 +33,13 @@ export declare abstract class VegaRTEExtensionRenderer extends VegaRTEBaseRender
    * @returns {VegaRTEUseRef} - The function to register the element.
    */
   protected useRef(renderData: RTEBlock | RTENode): VegaRTEUseRef;
+  /**
+   * Get a registered renderer by its key.
+   *
+   * @param {string} key - The key of the renderer.
+   * @returns {Nullable<BaseRenderer>} - The registered renderer or null if not found.
+   */
+  protected getDTORenderer(key: string): Nullable<BaseRenderer>;
   /**
    * Auto render the block children if the block element is not exist
    *

package/dist/types/components/vega-rich-text-editor/extensions/base-toolbar-button-renderer.d.ts

@@ -1,5 +1,5 @@
 import { Nullable } from '../../../types/general';
-import { VegaRTECreateElementFunction, VegaRTEToolbarRenderContext, VegaRTERenderResult, RTEToolbarDropdownProps, RTEDropdownListItem, RTEToolbarButtonProps } from '../interface';
+import { VegaRTECreateElementFunction, VegaRTEToolbarRenderContext, VegaRTERenderResult, RTEToolbarDropdownProps, RTEDropdownListItem, RTEToolbarButtonProps, RTEDropdownListGroup } from '../interface';
 /**
  * Base class for rendering extension toolbar button in the rich text editor.
  * The renderer provides common functionalities for rendering toolbar buttons, including:
@@ -40,10 +40,10 @@ export declare abstract class VegaRTEToolbarButtonRenderer {
    * Renders the dropdown list template.
    *
    * @param {VegaRTECreateElementFunction} h - Create element function.
-   * @param {RTEDropdownListItem[]} itemList - The list of dropdown items.
+   * @param {(RTEDropdownListItem | RTEDropdownListGroup)[]} itemList - The list of dropdown items.
    * @returns {VegaRTERenderResult} - The render result for the dropdown list.
    */
-  protected renderDropdownListTemplate(h: VegaRTECreateElementFunction, itemList: RTEDropdownListItem[]): VegaRTERenderResult;
+  protected renderDropdownListTemplate(h: VegaRTECreateElementFunction, itemList: (RTEDropdownListItem | RTEDropdownListGroup)[]): VegaRTERenderResult;
   /**
    * Renders a dropdown item for the toolbar button.
    *
@@ -52,6 +52,14 @@ export declare abstract class VegaRTEToolbarButtonRenderer {
    * @returns {VegaRTERenderResult} - The render result for the dropdown item.
    */
   protected renderDropdownItem(h: VegaRTECreateElementFunction, item: RTEDropdownListItem): VegaRTERenderResult;
+  /**
+   * Renders a dropdown item for the toolbar button.
+   *
+   * @param {VegaRTECreateElementFunction} h - Create element function.
+   * @param {RTEDropdownListGroup} item - The dropdown group.
+   * @returns {VegaRTERenderResult} - The render result for the dropdown item.
+   */
+  protected renderDropdownGroup(h: VegaRTECreateElementFunction, item: RTEDropdownListGroup): VegaRTERenderResult;
   /**
    * Renders a common toolbar button with optional icon, label, and arrow icon.
    *
@@ -90,6 +98,14 @@ export declare abstract class VegaRTEToolbarButtonRenderer {
    * @param {MouseEvent} e The mouse event to prevent default action for.
    */
   protected preventDefault(e: MouseEvent): void;
+  /**
+   * Recursively searches for a dropdown list item by its key.
+   *
+   * @param {(RTEDropdownListItem | RTEDropdownListGroup)[]} itemList The list of dropdown items or groups to search through.
+   * @param {string} key The key of the item to find.
+   * @returns {Nullable<RTEDropdownListItem>} The dropdown list item if found, otherwise null.
+   */
+  protected getListItemByKey(itemList: (RTEDropdownListItem | RTEDropdownListGroup)[], key: string): Nullable<RTEDropdownListItem>;
   /**
    * Handles the button click event.
    *