@globalpayments/vega 2.87.0-beta.1 → 2.88.0

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

@@ -4,6 +4,7 @@ export declare class VegaAccordionRenderer extends VegaSlimmer {
   drawsBackground: VegaAccordion['drawsBackground'];
   prefixIcon: VegaAccordion['prefixIcon'];
   accordionTitle: VegaAccordion['accordionTitle'];
+  titleBackgroundColor: VegaAccordion['titleBackgroundColor'];
   expandIconAlign: VegaAccordion['expandIconAlign'];
   expand: VegaAccordion['expand'];
   iconPosition: VegaAccordion['iconPosition'];

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

@@ -1,6 +1,7 @@
 import { EventEmitter } from '../../stencil-public-runtime';
 import { GlobalSlimmers } from '../../vega-slimmer/vega-slimmer-core';
 import { ResponsiveType } from '../../types/ui.type';
+import { BackgroundColorsTokenType } from '../../types/design-token.type';
 import { VegaAccordionRenderer } from './slimmers/vega-accordion-renderer';
 import { VegaAccordionExpandController } from './slimmers/vega-accordion-expand-controller';
 import { EventEmitSlimmerBase } from '../../helpers/event-manager/slimmers/event-emit-slimmer';
@@ -42,6 +43,19 @@ export declare class VegaAccordion {
    * @vegaVersion 1.3.0
    */
   accordionTitle: string;
+  /**
+   * Specifies the background color of the accordion header row
+   *    (prefix icon, title and expand icon).
+   *
+   * When unset, the header has no background of its own.
+   *
+   * @VegaWarning Note: To ensure sufficient visual contrast and maintain accessibility standards,
+   *    avoid choosing a background color that closely matches the expand icon color
+   *    (such as `bg-action`), as it may make the icon difficult to perceive.
+   *
+   * @vegaVersion 2.88.0
+   */
+  titleBackgroundColor: BackgroundColorsTokenType;
   /**
    * Specifies the placement of the expand icon in the accordion.
    *

package/dist/types/components/vega-calendar/vega-calendar-event-preview/types.d.ts

@@ -11,7 +11,7 @@ export type VegaCalendarEventPreviewPayload = {
 	/**
 	 * The event actions available for the event preview
 	 *
-	 * @vegaVersion 2.87.0-beta.1
+	 * @vegaVersion 2.87.0
 	 */
 	eventActions: CalendarEventActions;
 };

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

@@ -199,7 +199,7 @@ export declare class VegaCalendar {
    * Controls whether the calendar is editable, allowing users to interact with events and dates.
    * When set to `false`, all interactive features such as clicking on events or dates will be disabled, making the calendar view-only.
    *
-   * @vegaVersion 2.87.0-beta.1
+   * @vegaVersion 2.87.0
    */
   eventEditable: boolean;
   /**
@@ -207,7 +207,7 @@ export declare class VegaCalendar {
    * It receives the raw event data and the associated date, and should return an object indicating which action buttons should be visible in the popover.
    * This allows for dynamic customization of the event preview based on the specific event being clicked.
    *
-   * @vegaVersion 2.87.0-beta.1
+   * @vegaVersion 2.87.0
    */
   getEventPreviewActions: CalendarEventActionsCallback;
   /**
@@ -243,14 +243,14 @@ export declare class VegaCalendar {
   /**
    * An event emitter notifying that a calendar event edit action is triggered from the event preview popover.
    *
-   * @vegaVersion 2.87.0-beta.1
+   * @vegaVersion 2.87.0
    */
   vegaEventEdit: EventEmitter<VegaCalendarEventEditInfo>;
   /**
    * An event emitter notifying that a calendar event edit action is triggered from the event preview popover.
    *
    * @eventSemantics namespace:native
-   * @vegaVersion 2.87.0-beta.1
+   * @vegaVersion 2.87.0
    */
   eventEdit: EventEmitter<VegaCalendarEventEditInfo>;
   /**

package/dist/types/components/vega-code-block/vega-code-block.d.ts

@@ -62,6 +62,7 @@ export declare class VegaCodeBlock {
   /**
    * Specifies whether to display the copy button in the code block.
    *
+   * @VegaWarning Only has effect when `readOnly` is `true`.
    * @vegaVersion 2.50.0
    */
   showCopyButton: boolean;

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

@@ -2,6 +2,7 @@ import { VegaSlimmer } from '../../../../vega-slimmer/vega-slimmer-core';
 import { VegaComboBox } from '../../vega-combo-box';
 export declare class VegaComboBoxRenderer extends VegaSlimmer {
   private required;
+  private optional;
   private hint;
   private disabled;
   private dropdownRenderer;

package/dist/types/components/vega-combo-box/vega-combo-box.d.ts

@@ -47,6 +47,16 @@ export declare class VegaComboBox {
    * @vegaVersion 1.11.0
    */
   required: boolean;
+  /**
+   * Indicates whether the field should be presented as optional.
+   *
+   * This property only takes effect when `required` is `false`.
+   * When `true`, an "optional" label is displayed next to the field label.
+   *
+   * @default false
+   * @vegaVersion 2.88.0
+   */
+  optional: boolean;
   /**
    * Specifies the source data used to populate the
    *    dropdown menu associated with the combo box.

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

@@ -0,0 +1,20 @@
+import { VegaDatePickerCalendar } from '../../vega-date-picker-calendar';
+import { PageResizeObserverSlimmer } from '../../../../../helpers/slimmers/page-resize-observer-slimmer';
+/**
+ * Controller for managing the size of the Vega date picker calendar.
+ */
+export declare class VegaDatePickerCalendarSizeController extends PageResizeObserverSlimmer {
+  protected size: VegaDatePickerCalendar['size'];
+  protected currentSize: VegaDatePickerCalendar['currentSize'];
+  constructor();
+  /**
+   * Updates the current size of the date picker calendar whenever the component is about to load or when the size prop changes.
+   */
+  protected updateCurrentSize(): void;
+  /**
+   * Returns the current size of the date picker calendar, formatted as a DatePickerCalendarSizeType.
+   *
+   * @returns {DatePickerCalendarSizeType} The current size of the date picker calendar.
+   */
+  private getCurrentSize;
+}

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

@@ -7,9 +7,10 @@ export declare class VegaDatePickerCalendarHeaderRenderer extends VegaSlimmer {
   private currentPeriodController;
   private maxCalendarDate;
   private minCalendarDate;
-  private size;
+  private currentSize;
   private timezone;
   private isDualMonths;
+  private todayClickEventEmitter;
   render(): HTMLElement;
   private renderSwitcher;
   private renderPrevIcon;

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

@@ -10,7 +10,7 @@ export declare class VegaDatePickerCalendarYearMonthSwitcherRenderer extends Veg
   maxCalendarDate: VegaDatePickerCalendar['maxCalendarDate'];
   yearMonthDropdownProps: VegaDatePickerCalendar['yearMonthDropdownProps'];
   currentPeriod: VegaDatePickerCalendar['currentPeriod'];
-  size: VegaDatePickerCalendar['size'];
+  currentSize: VegaDatePickerCalendar['currentSize'];
   mode: VegaDatePickerCalendar['mode'];
   isDualMonths: VegaDatePickerCalendar['isDualMonths'];
   render(): HTMLElement;

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

@@ -13,7 +13,6 @@ export declare class VegaDatePickerMonthItemRenderer extends VegaSlimmer {
   staticHeight: VegaDatePickerCalendar['staticHeight'];
   mode: VegaDatePickerCalendar['mode'];
   fillContainer: VegaDatePickerCalendar['fillContainer'];
-  size: VegaDatePickerCalendar['size'];
   isDualMonths: VegaDatePickerCalendar['isDualMonths'];
   isDateDisabled: VegaDatePickerCalendar['isDateDisabled'];
   dateIndicator: VegaDatePickerCalendar['dateIndicator'];

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

@@ -14,10 +14,12 @@ import { VegaDatePickerCalendarSelectionController } from './slimmers/controller
 import { Nullable } from '../../../types/general';
 import { VegaDatePickerCalendarMinMaxDateController } from './slimmers/controllers/vega-date-picker-calendar-min-max-date-controller';
 import { VegaDatePickerCalendarAllowRepickController } from './slimmers/controllers/vega-date-picker-calendar-allow-repick-controller';
+import { ResponsiveType } from '../../../types/ui.type';
 import { DisabledDate } from '../../vega-calendar/types';
 import { CalendarSelection } from './dto/calendar-selection';
 import { VegaDatePickerCalendarHeaderRenderer } from './slimmers/renderers/vega-date-picker-calendar-header-render';
 import { VegaDatePickerCalendarIsDualMonthsController } from './slimmers/controllers/vega-date-picker-calendar-is-dual-months-controller';
+import { VegaDatePickerCalendarSizeController } from './slimmers/controllers/vega-date-picker-calendar-size-controller';
 /**
  * @vegaVersion 2.0.0
  */
@@ -35,10 +37,13 @@ export declare class VegaDatePickerCalendar {
   protected yearMonthSwitcherRender: VegaDatePickerCalendarYearMonthSwitcherRenderer;
   protected allowRepickController: VegaDatePickerCalendarAllowRepickController;
   protected vegaComponentUsageRuntimeMetricsSlimmer: VegaComponentUsageRuntimeMetricsSlimmer<HTMLVegaDatePickerCalendarElement>;
+  protected readonly calendarSizeController: VegaDatePickerCalendarSizeController;
   protected clearEventEmitter: EventEmitSlimmerBase;
   protected monthYearChangeEventEmitter: EventEmitSlimmerBase;
   protected vegaSelectionChangeEventEmitter: EventEmitSlimmerBase;
+  protected todayClickEventEmitter: EventEmitSlimmerBase;
   host: HTMLVegaDatePickerCalendarElement;
+  currentSize: DatePickerCalendarSizeType;
   isMobileDevice: boolean;
   today: CalendarDate;
   currentPeriod: MonthPeriod;
@@ -52,11 +57,13 @@ export declare class VegaDatePickerCalendar {
   watchMinCalendarDate(): void;
   isDualMonths: boolean;
   /**
-   * Renders the calendar picker in different sizes. Defaults to regular size
+   * Renders the calendar picker in different sizes. Defaults to regular size.
+   *    Responsive sizing is supported starting with version 2.88.0.
    *
    * @vegaVersion 2.72.0
    */
-  size: DatePickerCalendarSizeType;
+  size: ResponsiveType<DatePickerCalendarSizeType>;
+  watchSize(): void;
   /**
    * Specifies whether to allow the calendar picker to fill the width and height of its parent container.
    *    As default, the calendar picker has a max width and height limit based on the size and mode variant.
@@ -207,6 +214,19 @@ export declare class VegaDatePickerCalendar {
    * @vegaVersion 2.72.0
    */
   selectionChange: EventEmitter<string | string[]>;
+  /**
+   * An event emitter notifying the today button is clicked in the date picker.
+   *
+   * @vegaVersion 2.88.0
+   */
+  vegaTodayClick: EventEmitter<string>;
+  /**
+   * An event emitter notifying the today button is clicked in the date picker.
+   *
+   * @eventSemantics namespace:native
+   * @vegaVersion 2.88.0
+   */
+  todayClick: EventEmitter<string>;
   /**
    * Invoke this method to reset calendar to its initial state,
    * 	it include reset to current value and reset the current period.

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

@@ -5,6 +5,7 @@ import { VegaComponentUsageRuntimeMetricsSlimmer } from '../../helpers/slimmers/
 import { LabelSuffixButtonConfig, LabelSuffixButtonProps } from './types';
 import { VegaFieldLabelSuffixElementRenderer } from './slimmers/renderers/vega-field-label-suffix-element-renderer';
 import { Nullable } from '../../types/general';
+import { TranslationSlimmer } from '../../helpers/slimmers/translation/translation-slimmer';
 /**
  * @vegaVersion 1.10.0
  */
@@ -14,6 +15,7 @@ export declare class VegaFieldLabel {
   protected suffixButtonClickEventEmitter: EventEmitSlimmerBase;
   protected vegaComponentUsageRuntimeMetricsSlimmer: VegaComponentUsageRuntimeMetricsSlimmer<HTMLVegaFieldLabelElement>;
   protected suffixElementRenderer: VegaFieldLabelSuffixElementRenderer;
+  protected translationSlimmer: TranslationSlimmer<HTMLVegaFieldLabelElement>;
   host: HTMLVegaFieldLabelElement;
   /**
    * @deprecated Please use `suffixButtonConfig` instead
@@ -58,6 +60,16 @@ export declare class VegaFieldLabel {
    * @vegaVersion 1.10.0
    */
   disabled: boolean;
+  /**
+   * Indicates whether the field should be presented as optional.
+   *
+   * This property only takes effect when `isFieldRequired` is `false`.
+   * When `true`, an "optional" label is displayed next to the field label.
+   *
+   * @default false
+   * @vegaVersion 2.88.0
+   */
+  optional: boolean;
   /**
    * An event emitter notifying that the field label has been clicked.
    *

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

@@ -3,6 +3,7 @@ import { VegaFileUploader } from '../../vega-file-uploader';
 /** renders a file uploader component with specified properties. */
 export declare class VegaFileUploaderRenderer extends VegaSlimmer {
   protected required: VegaFileUploader['required'];
+  protected optional: VegaFileUploader['optional'];
   protected disabled: VegaFileUploader['disabled'];
   protected label: VegaFileUploader['label'];
   protected hint: VegaFileUploader['hint'];

package/dist/types/components/vega-file-uploader/vega-file-uploader.d.ts

@@ -93,6 +93,16 @@ export declare class VegaFileUploader {
    * @vegaVersion 2.25.0
    */
   required: boolean;
+  /**
+   * Indicates whether the field should be presented as optional.
+   *
+   * This property only takes effect when `required` is `false`.
+   * When `true`, an "optional" label is displayed next to the field label.
+   *
+   * @default false
+   * @vegaVersion 2.88.0
+   */
+  optional: boolean;
   /**
    * Defines custom validation rules for the File Uploader field.
    *

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

@@ -8,6 +8,7 @@ export declare class VegaInputRenderer extends VegaSlimmer {
   private hint;
   private labelSuffixButtonProps;
   private labelSuffixButtonConfig;
+  private optional;
   private labelButtonClickEventEmitter;
   private inputContainerRenderer;
   private inputSuggestionsRenderer;

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

@@ -254,6 +254,16 @@ export declare class VegaInput {
    * @vegaVersion 1.0.5
    */
   required: boolean;
+  /**
+   * Indicates whether the field should be presented as optional.
+   *
+   * This property only takes effect when `required` is `false`.
+   * When `true`, an "optional" label is displayed next to the field label.
+   *
+   * @default false
+   * @vegaVersion 2.88.0
+   */
+  optional: boolean;
   /**
    * Sets the minimum allowable numeric value for the input.
    *

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

@@ -12,6 +12,7 @@ export declare class VegaInputPasscodeRenderer extends VegaSlimmer {
   protected inputType: VegaInputPasscode['inputType'];
   protected vegaInputValues: VegaInputPasscode['vegaInputValues'];
   protected valueController: VegaInputPasscode['valueController'];
+  protected optional: VegaInputPasscode['optional'];
   private vegaInputRefs;
   private currentIndex;
   private inputPasscodeContainerRef;

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

@@ -106,6 +106,16 @@ export declare class VegaInputPasscode {
    * @vegaVersion 2.66.0
    */
   required: boolean;
+  /**
+   * Indicates whether the field should be presented as optional.
+   *
+   * This property only takes effect when `required` is `false`.
+   * When `true`, an "optional" label is displayed next to the field label.
+   *
+   * @default false
+   * @vegaVersion 2.88.0
+   */
+  optional: boolean;
   /**
    * An array of custom validation rules applied to the passcode input in
    * addition to the built-in `RequiredFieldRule`. Each rule must implement

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

@@ -2,6 +2,7 @@ import { VegaSlimmer } from '../../../../vega-slimmer/vega-slimmer-core';
 import { VegaInputPhoneNumber } from '../../vega-input-phone-number';
 export declare class VegaInputPhoneNumberRenderer extends VegaSlimmer {
   protected required: VegaInputPhoneNumber['required'];
+  protected optional: VegaInputPhoneNumber['optional'];
   protected label: VegaInputPhoneNumber['label'];
   protected disabled: VegaInputPhoneNumber['disabled'];
   protected hint: VegaInputPhoneNumber['hint'];

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

@@ -60,6 +60,16 @@ export declare class VegaInputPhoneNumber {
    * @vegaVersion 2.18.0
    */
   required: boolean;
+  /**
+   * Indicates whether the field should be presented as optional.
+   *
+   * This property only takes effect when `required` is `false`.
+   * When `true`, an "optional" label is displayed next to the field label.
+   *
+   * @default false
+   * @vegaVersion 2.88.0
+   */
+  optional: boolean;
   /**
    * Specifies whether the phone number input field is disabled. When `true`,
    * both the country selector and the phone number text field become

package/dist/types/components/vega-rich-text-editor/assets/redo.d.ts

@@ -0,0 +1,3 @@
+import { IconPayload } from '../../../helpers/icon/interface';
+declare const _default: IconPayload;
+export default _default;

package/dist/types/components/vega-rich-text-editor/assets/undo.d.ts

@@ -0,0 +1,3 @@
+import { IconPayload } from '../../../helpers/icon/interface';
+declare const _default: IconPayload;
+export default _default;

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

@@ -5,7 +5,7 @@ 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 dtoName;
   private annotationMap;
   constructor(dto: T);
   /**

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

@@ -18,6 +18,11 @@ export declare type RTEBlockChildrenType = RTEBlock | RTENode;
 export declare abstract class RTEBlock<P = RTEBlockParentType, C = RTEBlockChildrenType> {
   id: string;
   annotationMap: BlockAnnotations;
+  /**
+   * Minimize-safe type discriminator. Each concrete sub-class declares its own
+   * `static readonly dtoName = 'ClassName'`.
+   */
+  readonly dtoName: string;
   abstract type: string;
   abstract parent: P;
   abstract children: C[];

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

@@ -11,6 +11,8 @@ import { RTEHtmlBlock } from './html-block';
  */
 export declare class RTECodeBlock extends RTEBlock<VegaRTEContent | RTEHtmlBlock, RTECodeBlockNode> {
   static CODE_BLOCK_PLACEHOLDER_CLASS_NAME: string;
+  static readonly dtoName: string;
+  readonly dtoName: string;
   type: RTEBlockType;
   parent: VegaRTEContent | RTEHtmlBlock;
   children: RTECodeBlockNode[];

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

@@ -6,6 +6,8 @@ import { RTENode } from '../nodes/node.abstract';
  * HTML Block
  */
 export declare class RTEHtmlBlock extends RTEBlock<VegaRTEContent | RTEHtmlBlock, RTEBlock> {
+  static readonly dtoName: string;
+  readonly dtoName: string;
   type: 'html-block';
   parent: VegaRTEContent | RTEHtmlBlock;
   htmlTag: string;

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

@@ -7,6 +7,8 @@ import { RTEHtmlBlock } from './html-block';
  * Image block
  */
 export declare class RTEImageBlock extends RTEBlock<VegaRTEContent | RTEHtmlBlock, RTEImageNode> {
+  static readonly dtoName: string;
+  readonly dtoName: string;
   readonly type: RTEBlockType;
   children: RTEImageNode[];
   parent: VegaRTEContent | RTEHtmlBlock;

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

@@ -10,6 +10,8 @@ export declare type RTEListBlockTagType = 'ol' | 'ul';
  * List block
  */
 export declare class RTEListBlock extends RTEBlock<VegaRTEContent | RTEListItemBlock | RTEHtmlBlock, RTEListItemBlock> {
+  static readonly dtoName: string;
+  readonly dtoName: string;
   type: VegaRTEListBlockType;
   children: RTEListItemBlock[];
   parent: RTEListItemBlock | VegaRTEContent | RTEHtmlBlock;

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

@@ -6,6 +6,8 @@ import { RTETextBlock } from './text-block';
  * List item block
  */
 export declare class RTEListItemBlock extends RTETextBlock {
+  static readonly dtoName: string;
+  readonly dtoName: string;
   /**
    * TODO: Refactor the list item properties children and nestList, merge two properties together.
    *

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

@@ -11,6 +11,8 @@ export declare type RTETextBlockTagType = 'div' | 'h1' | 'h2' | 'h3' | 'h4' | 'h
  * Text block
  */
 export declare class RTETextBlock extends RTEBlock<VegaRTEContent | RTEListBlock | RTEHtmlBlock, RTETextNode> {
+  static readonly dtoName: string;
+  readonly dtoName: string;
   type: VegaRTETextBlockType;
   children: RTETextNode[];
   parent: VegaRTEContent | RTEListBlock | RTEHtmlBlock;

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

@@ -10,6 +10,9 @@ import './setup';
  * Class representing the content state of the rich text editor.
  */
 export declare class VegaRTEContent {
+  /** Minimize-safe type discriminator for VegaRTEContent. */
+  static readonly dtoName: string;
+  readonly dtoName: string;
   children: RTEContentBlock[];
   constructor(blocks: RTEContentBlock[]);
   /**

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

@@ -18,6 +18,8 @@ declare type CodeBlockNodeAnnotationValue = SelectionRangeAnnotation | CustomSty
  * RTE code node DTO class.
  */
 export declare class RTECodeBlockNode extends RTEDecoratorNode<RTECodeBlock> {
+  static readonly dtoName: string;
+  readonly dtoName: string;
   type: NodeTypeEnum;
   parent: RTECodeBlock;
   text: string;

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

@@ -8,6 +8,8 @@ import { RTEDecoratorNode } from './decorator-node';
  * Image node
  */
 export declare class RTEImageNode extends RTEDecoratorNode<RTEImageBlock> {
+  static readonly dtoName: string;
+  readonly dtoName: string;
   readonly type: NodeTypeEnum;
   parent: RTEImageBlock;
   url: string;

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

@@ -18,6 +18,11 @@ export declare type NodeAnnotations = Map<RTENodeAnnotationMapKey, RTENodeAnnota
 export declare abstract class RTENode<P extends RTEBlock = RTEBlock> {
   id: string;
   annotationMap: NodeAnnotations;
+  /**
+   * Minimize-safe type discriminator. Each concrete sub-class declares its own
+   * `static readonly dtoName = 'ClassName'`.
+   */
+  readonly dtoName: string;
   abstract readonly type: string;
   abstract parent: P;
   protected constructor(id: string, annotationMap?: Map<RTENodeAnnotationMapKey, RTENodeAnnotationMapValue>);

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

@@ -20,6 +20,8 @@ export declare type InlineHtmlTagDescriptor = {
 export declare class RTETextNode extends RTENode<RTETextBlock> {
   static registerActionStrategyStatus: Record<string, boolean>;
   static readonly htmlTag: 'span';
+  static readonly dtoName: string;
+  readonly dtoName: string;
   readonly type: NodeTypeEnum | string;
   text: string;
   parent: RTETextBlock;

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

@@ -12,6 +12,9 @@ import { VegaRTECreateElementFunction, VegaRTEToolbarRenderContext, VegaRTERende
  * Override the methods to customize the rendering and behavior of the button.
  */
 export declare abstract class VegaRTEToolbarButtonRenderer {
+  private dropdownEl;
+  private itemsContainerEl;
+  private buttonEl;
   /**
    * Checks if the button should be hidden.
    *
@@ -116,6 +119,34 @@ export declare abstract class VegaRTEToolbarButtonRenderer {
    * @returns {Nullable<RTEDropdownListItem>} The dropdown list item if found, otherwise null.
    */
   protected getListItemByKey(itemList: (RTEDropdownListItem | RTEDropdownListGroup)[], key: string): Nullable<RTEDropdownListItem>;
+  /**
+   * Handles keyboard events on the toolbar button to support dropdown keyboard accessibility.
+   * - Enter / Space: Toggles the dropdown open/closed.
+   * - ArrowDown / ArrowUp: Opens the dropdown and focuses the first/last item.
+   *
+   * @param {KeyboardEvent} e The keyboard event.
+   */
+  private handleButtonKeyDown;
+  /**
+   * Handles keyboard navigation within the dropdown items container.
+   * - ArrowDown/ArrowUp: Moves focus to the next/previous non-disabled item.
+   * - Escape: Closes the dropdown and returns focus to the toolbar button.
+   *
+   * @param {KeyboardEvent} e The keyboard event.
+   */
+  private handleItemsKeyDown;
+  /**
+   * Focuses the first or last non-disabled dropdown item.
+   *
+   * @param {'first' | 'last'} position Whether to focus the first or last item.
+   */
+  private focusDropdownItem;
+  /**
+   * Gets all dropdown items from the items container.
+   *
+   * @returns {HTMLVegaDropdownItemElement[]} Array of dropdown item elements.
+   */
+  private getDropdownItems;
   /**
    * Handles the button click event.
    *

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

@@ -13,6 +13,11 @@ import { ActionHandlerInterceptor } from '../dto/action-handle-strategies/action
 import { AnnotationGeneratorStrategyAbstract } from '../slimmers/controllers/helper/element-to-dto-strategy/annotation-handler/annotation-generator-strategy.abstract';
 import { AnnotationAction } from '../dto/actions/annotation-action.abstract';
 import { RTEFilterStylesStrategy } from '../dto/filter-styles-strategies/filter-styles-strategy.abstract';
+import type { VegaRTEBlockBase, VegaRTETransformOptions } from '../interface';
+declare type BlockClassWithFrom = ClassType<RTEBlock> & {
+  from(block: VegaRTEBlockBase, options?: VegaRTETransformOptions): RTEBlock;
+};
+declare type AnnotationFromJsonHandler = (instance: RTEBlock, value: unknown, block: VegaRTEBlockBase, options?: VegaRTETransformOptions) => void;
 /**
  * Abstract class for Vega Rich Text Editor extensions.
  */
@@ -45,6 +50,19 @@ export declare abstract class VegaRTEExtension {
    * @param {RTEFilterStylesStrategy} strategy - The filter styles strategy to register.
    */
   static registerFilterStylesStrategy(blockOrNodeClassName: string, strategy: RTEFilterStylesStrategy): void;
+  /**
+   * Attach a custom JSON annotation handler to a block DTO class's static `from` flow.
+   *
+   * This is a reusable extension point: any extension can register a handler for an
+   * annotation key and transform the value into block annotations during JSON parsing.
+   *
+   * Safe to call multiple times per class/key/handler — duplicate registrations are no-ops.
+   *
+   * @param {BlockClassWithFrom} BlockClass - Block DTO class to patch.
+   * @param {string} annotationKey - JSON annotation key to read from `block.annotations`.
+   * @param {AnnotationFromJsonHandler} handler - Handler that applies annotation logic to the instance.
+   */
+  static attachAnnotationFromJson(BlockClass: BlockClassWithFrom, annotationKey: string, handler: AnnotationFromJsonHandler): void;
   /**
    * Lifecycle hook called by the rich text editor before the first render
    * (during `componentWillLoad`).  Override this method to perform per-host
@@ -152,3 +170,4 @@ export declare abstract class VegaRTEExtension {
    */
   protected registerAnnotationHandler(handler: AnnotationGeneratorStrategyAbstract): void;
 }
+export {};

package/dist/types/components/vega-rich-text-editor/extensions/functions/dto/function-block.d.ts

@@ -14,6 +14,8 @@ export declare type RTEFunctionBlockChild = RTELogicControlBlock | RTETextBlock;
  * RTE Function Block
  */
 export declare class RTEFunctionBlock extends RTEBlock<VegaRTEContent | RTEHtmlBlock, RTEFunctionBlockChild> {
+  static dtoName: string;
+  readonly dtoName: string;
   type: string;
   parent: VegaRTEContent | RTEHtmlBlock;
   children: RTEFunctionBlockChild[];

package/dist/types/components/vega-rich-text-editor/extensions/functions/dto/logic-control-block.d.ts

@@ -9,6 +9,8 @@ export declare type VegaRTELogicControlBlock = VegaRTECustomBlock & {
  * Class representing a logic control block in the rich text editor.
  */
 export declare class RTELogicControlBlock extends RTEBlock {
+  static dtoName: string;
+  readonly dtoName: string;
   type: string;
   parent: RTEFunctionBlock;
   children: RTELogicControlNode[];

package/dist/types/components/vega-rich-text-editor/extensions/functions/dto/logic-control-node.d.ts

@@ -5,6 +5,8 @@ import { RTELogicControlBlock } from './logic-control-block';
  * Class representing a logic control node in the rich text editor.
  */
 export declare class RTELogicControlNode extends RTENode {
+  static dtoName: string;
+  readonly dtoName: string;
   type: string;
   text: string;
   parent: RTELogicControlBlock;