@globalpayments/vega 2.99.0 → 2.101.0

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

@@ -8,6 +8,7 @@ import { EventEmitSlimmerBase } from '../../helpers/event-manager/slimmers/event
 import { ChildNodesEventPreventSlimmer } from '../../helpers/event-manager/slimmers/child-nodes-event-prevent-slimmer';
 import { VegaComponentUsageRuntimeMetricsSlimmer } from '../../helpers/slimmers/component-usage-runtime-metrics';
 import { VegaButtonLoadingRenderer } from './slimmers/renderers/vega-button-loading-renderer';
+import { AriaAttributesValueMapper } from '../../helpers/slimmers/mutation-observer/aria-attributes-value-mapper';
 /**
  * Buttons are used for triggering actions.
  *
@@ -24,6 +25,7 @@ export declare class VegaButton {
   protected eventPrevent: ChildNodesEventPreventSlimmer;
   protected vegaComponentUsageRuntimeMetricsSlimmer: VegaComponentUsageRuntimeMetricsSlimmer<HTMLVegaButtonElement>;
   protected vegaButtonLoadingRenderer: VegaButtonLoadingRenderer;
+  protected ariaAttributesValueMapper: AriaAttributesValueMapper;
   host: HTMLVegaButtonElement;
   currentBreakpoint: BreakpointsTokenType;
   /**

package/dist/types/components/vega-button-group/types.d.ts

@@ -46,25 +46,31 @@ export type ButtonItemsProps = {
 	/**
 	 * Icon name for the button.
 	 */
-	icon: string;
+	'icon': string;
 	/**
 	 * Label text for the button.
 	 */
-	label: string;
+	'label': string;
 	/**
 	 * Size of the button.
 	 */
-	size: VegaButtonGroupSize;
+	'size': VegaButtonGroupSize;
 	/**
 	 * Icon alignment within the button.
 	 */
-	iconAlign: VegaButtonGroupIconAlign;
+	'iconAlign': VegaButtonGroupIconAlign;
 	/**
 	 * Whether the button is disabled.
 	 */
-	disabled: boolean;
+	'disabled': boolean;
+	/**
+	 * Accessible name forwarded to the underlying button when the visible label
+	 * is suppressed (icon-only). Mapped to `aria-label` by the button's
+	 * `AriaAttributesValueMapper`.
+	 */
+	'data-aria-label'?: string;
 	/**
 	 * Ref callback for obtaining the element.
 	 */
-	ref: (node: HTMLElement) => void;
+	'ref': (node: HTMLElement) => void;
 };

package/dist/types/components/vega-calendar/slimmers/common/renderers/vega-calendar-event-item-renderer.d.ts

@@ -10,9 +10,15 @@ export declare class VegaCalendarEventItemRenderer extends VegaSlimmer {
   protected eventClickEmitter: VegaCalendar['eventClickEmitter'];
   protected timeFormat: VegaCalendar['timeFormat'];
   protected enabledEventPreview: VegaCalendar['enabledEventPreview'];
+  protected eventPreviewEmitter: VegaCalendar['eventPreviewEmitter'];
   protected renderer: VegaCalendar['renderer'];
+  protected eventPreviewPopoverProps: VegaCalendar['eventPreviewPopoverProps'];
   protected eventPreviewPopoverController: VegaCalendar['eventPreviewPopoverController'];
   protected eventPreviewActionsController: VegaCalendar['eventPreviewActionsController'];
+  /**
+   * While it is a single event and the trigger is hover, we should show the preview popover when mouse enter on the event item.
+   */
+  previewingEvent(event: CalendarEvent, targetCalendarViewDate: CalendarDate, isGroupEvent: boolean): void;
   /**
    * render event component
    *
@@ -22,6 +28,10 @@ export declare class VegaCalendarEventItemRenderer extends VegaSlimmer {
    * @returns {HTMLVegaCalendarEventElement} calendar event element
    */
   render(item: CalendarEvent, classMap: Record<string, boolean>, targetCalendarViewDate: CalendarDate, isGroupEvent?: boolean): HTMLVegaCalendarEventElement;
+  /**
+   * While it is a group event or the trigger is click with single event, we should show the preview popover when click on the event item.
+   */
+  private onEventClick;
   /**
    * emit vega click event
    *
@@ -29,4 +39,12 @@ export declare class VegaCalendarEventItemRenderer extends VegaSlimmer {
    */
   private handleEventClick;
   private setupPreviewContainer;
+  /**
+   * 1. The popover is not closed immediately when mouse leave.
+   * 2. The event preview popover shares a single preview component.
+   * While a new event item is hovered, it will make previous event popover empty, this will emit the popover flash in view.
+   * To avoid this, we hide the previous preview popover when a new event item is hovered.
+   * Ticket: https://gethired.atlassian.net/browse/VD-9920
+   */
+  private hidePreviousPreviewPopover;
 }

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

@@ -10,9 +10,18 @@ export declare class VegaCalendarEventPreviewPopoverRenderer extends VegaSlimmer
   protected timeFormat: VegaCalendar['timeFormat'];
   protected eventItemRenderer: VegaCalendar['eventItemRenderer'];
   protected enabledEventPreview: VegaCalendar['enabledEventPreview'];
+  protected eventPreviewPopoverProps: VegaCalendar['eventPreviewPopoverProps'];
   protected eventPreviewPopoverController: VegaCalendar['eventPreviewPopoverController'];
+  protected monthEventRenderer: VegaCalendar['monthEventRenderer'];
   private popoverHideObserver;
+  private popoverRefMap;
   render(event: CalendarEvent, targetCalendarViewDate: CalendarDate, classMap: Record<string, boolean>): HTMLElement;
   private renderPreviewPopover;
   private setPopoverHideObserver;
+  private listenPopoverRef;
+  /**
+   * When the mouse enters the popover, if the trigger is hover, we should show the preview popover when mouse enter on the event item.
+   * If the group event is previewing, we should prevent the popover from showing.
+   */
+  private onPopoverMouseEnter;
 }

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

@@ -17,6 +17,8 @@ export declare class VegaCalendarMonthEventRenderer extends VegaSlimmer {
   private moreEventsBoxRef;
   private maxMonthDisplayEventsCount;
   private popoverHideObserver;
+  private isGroupEventPreviewingFlag;
+  private groupPopoverRef;
   /**
    * current row dates all events.
    *
@@ -43,6 +45,12 @@ export declare class VegaCalendarMonthEventRenderer extends VegaSlimmer {
    * @returns {Nullable<HTMLVegaBoxElement>} the more events popover box element
    */
   getMoreEventsBoxRef(): Nullable<HTMLVegaBoxElement>;
+  /**
+   * Check if a group event preview is currently being displayed
+   *
+   * @returns {boolean} - True if a group event preview is being displayed, false otherwise
+   */
+  isGroupEventPreviewing(): boolean;
   /**
    * render the current date events
    *
@@ -74,5 +82,5 @@ export declare class VegaCalendarMonthEventRenderer extends VegaSlimmer {
    * @returns {Nullable<CalendarEvent>[][]} new event array
    */
   private hideTheCutOffEvents;
-  private setPopoverHideObserver;
+  private setPopoverObserver;
 }

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

@@ -134,6 +134,16 @@ export type VegaCalendarEventClickInfo = {
 	rawEvent: VegaCalendarRawEvent;
 };
 
+/**
+ * Information provided when a calendar event is previewed (e.g., hovered over or clicked for a popover).
+ */
+export type VegaCalendarEventPreviewInfo = {
+	/**
+	 * The raw event data that was previewed.
+	 */
+	rawEvent: VegaCalendarRawEvent;
+};
+
 /**
  * Information provided when a calendar event is edited.
  */
@@ -325,3 +335,15 @@ export type CalendarEventActionsCallback = (
 	event: VegaCalendarRawEvent,
 	date: VegaCalendarDateType,
 ) => CalendarEventActions;
+
+/**
+ * Configuration options for the event preview popover behavior.
+ */
+export type VegaCalendarEventPreviewPopoverProps = {
+	/**
+	 * Specifies the interaction that triggers the event preview popover.
+	 * - 'click': Popover appears when the event is clicked (default behavior).
+	 * - 'hover': Popover appears when the mouse hovers over the event.
+	 */
+	trigger: 'hover' | 'click';
+};

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

@@ -6,7 +6,7 @@ import { VegaCalendarViewRenderer } from './slimmers/common/renderers/vega-calen
 import { VegaCalendarMonthViewRenderer } from './slimmers/month-view/renderers/vega-calendar-month-view-renderer';
 import { VegaCalendarViewWithTimeRenderer } from './slimmers/day-view/renderers/vega-calendar-view-with-time-renderer';
 import { VegaCalendarTimeLineRenderer } from './slimmers/day-view/renderers/vega-calendar-time-line-renderer';
-import { VegaCalendarChangeEventType, VegaCalendarEventClickInfo, VegaCalendarDateClickInfo, VegaCalendarRawEvent, VegaCalendarViewModeType, DropdownPropsForCalendar, DisabledDate, CalendarEventActionsCallback, VegaCalendarEventEditInfo, VegaCalendarPeriodType } from './types';
+import { VegaCalendarChangeEventType, VegaCalendarEventClickInfo, VegaCalendarDateClickInfo, VegaCalendarRawEvent, VegaCalendarViewModeType, DropdownPropsForCalendar, DisabledDate, CalendarEventActionsCallback, VegaCalendarEventEditInfo, VegaCalendarPeriodType, VegaCalendarEventPreviewPopoverProps, VegaCalendarEventPreviewInfo } from './types';
 import { EventEmitSlimmerBase } from '../../helpers/event-manager/slimmers/event-emit-slimmer';
 import { CalendarDate, CalendarPeriod, CalendarView } from '../../helpers/calendar';
 import { VegaCalendarViewController } from './slimmers/common/controllers/vega-calendar-view-controller';
@@ -68,6 +68,7 @@ export declare class VegaCalendar {
   protected eventResponsiveController: VegaCalendarEventResponsiveController;
   protected changeEventEmitter: EventEmitSlimmerBase;
   protected eventClickEmitter: EventEmitSlimmerBase;
+  protected eventPreviewEmitter: EventEmitSlimmerBase;
   protected dateDblClickEmitter: EventEmitSlimmerBase;
   protected moreActionClickEmitter: EventEmitSlimmerBase;
   protected dateClickEmitter: EventEmitSlimmerBase;
@@ -213,6 +214,14 @@ export declare class VegaCalendar {
    * @vegaVersion 2.87.0
    */
   getEventPreviewActions: CalendarEventActionsCallback;
+  /**
+   * Configuration options for the event preview popover behavior.
+   * Allows customization of how the popover is triggered (hover or click).
+   * By default, the popover triggers on click.
+   *
+   * @vegaVersion 2.101.0
+   */
+  eventPreviewPopoverProps: VegaCalendarEventPreviewPopoverProps;
   /**
    * Monitors changes in the timezone prop for the calendar.
    */
@@ -230,6 +239,19 @@ export declare class VegaCalendar {
    * @vegaVersion 2.14.0
    */
   change: EventEmitter<VegaCalendarChangeEventType>;
+  /**
+   * An event emitter notifying that a calendar event is ready to review.
+   *
+   * @vegaVersion 2.101.0
+   */
+  vegaEventPreview: EventEmitter<VegaCalendarEventPreviewInfo>;
+  /**
+   * An event emitter notifying that a calendar event is ready to review.
+   *
+   * @eventSemantics namespace:native
+   * @vegaVersion 2.101.0
+   */
+  eventPreview: EventEmitter<VegaCalendarEventPreviewInfo>;
   /**
    * An event emitter notifying that a component event item is clicked.
    *

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

@@ -7,7 +7,7 @@ import { VegaDropdownCreateRenderer } from './slimmers/renderers/vega-dropdown-c
 import { VegaDropdownListRenderer } from './slimmers/renderers/vega-dropdown-list-renderer';
 import { VegaDropdownItemLevelRenderer } from './slimmers/renderers/vega-dropdown-item-level-renderer';
 import { VegaDropdownSearchRenderer } from './slimmers/renderers/vega-dropdown-search-renderer';
-import { VegaDropdownKeyboardController } from './slimmers/controllers/vega-dropdown-keyboard-conttroller';
+import { VegaDropdownKeyboardController } from './slimmers/controllers/vega-dropdown-keyboard-controller';
 import { VegaDropdownAppenderController } from './slimmers/controllers/vega-dropdown-appender-controller';
 import { VegaDropdownSearchTriggerEventDetail, VegaDropdownSearchTriggerByType, VegaDropdownSourceItem } from './types';
 import { VegaDropdownGroupLevelRenderer } from './slimmers/renderers/vega-dropdown-group-level-renderer';

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

@@ -1,5 +1,4 @@
 import { VegaSlimmer } from '../../../../vega-slimmer/vega-slimmer-core';
-import { Nullable } from '../../../../types/general';
 export declare class VegaFieldLabelLabelAnnouncementRenderer extends VegaSlimmer {
   private label;
   private isFieldRequired;
@@ -7,15 +6,9 @@ export declare class VegaFieldLabelLabelAnnouncementRenderer extends VegaSlimmer
   private disabled;
   private translationSlimmer;
   /**
-   * Render a label announcement.
+   * Build the visually-hidden state suffix (the part after the label text).
    *
-   * @returns {Nullable<HTMLElement>}
+   * @returns {string} e.g. ", Required, Disabled", or '' when there is no state to announce.
    */
-  render(): Nullable<HTMLElement>;
-  /**
-   * Generate a screen-reader-friendly announcement string that concatenates the label text with the field's required/optional and disabled states.
-   *
-   * @returns {string} The generated announcement string.
-   */
-  private generateAnnouncement;
+  getStateSuffix(): string;
 }

package/dist/types/components/vega-flag-icon/slimmers/controllers/vega-flag-icon-controller.d.ts

@@ -13,9 +13,9 @@ export declare class VegaFlagIconController extends VegaSlimmer {
   protected country: VegaFlagIcon['country'];
   private observer;
   /**
-   * componentWillLoad
+   * connectedCallback
    */
-  componentWillLoad(): void;
+  connectedCallback(): void;
   /**
    * disconnectedCallback
    */

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

@@ -47,7 +47,6 @@ export declare class CountrySelectRenderer extends VegaSlimmer {
    * rendering the JSX structure of the component. Here's a breakdown of what it is doing:
    */
   render(): HTMLElement;
-  private renderDropdownPrefixIconWithFlagIcon;
   /**
    * This `renderDropdownItem` function is responsible for rendering a dropdown item for a specific country in
    * the `VegaInputPhoneNumberCountryCodeRenderer` component.

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

@@ -30,6 +30,14 @@ export declare class VegaInputSelectDropdownRenderer extends VegaSlimmer {
   render(): HTMLVegaDropdownElement;
   private renderItemsSlot;
   private renderContainer;
+  /**
+   * VD-9605: open/close the dropdown on both Enter and Space, matching native button
+   * semantics. Space is preventDefaulted so activating the trigger does not scroll the page.
+   *
+   * @param {KeyboardEvent} e - keydown event on the select trigger.
+   * @returns {void}
+   */
+  private handleTriggerKeyDown;
   private renderPrefixIcon;
   private renderToggleIcon;
   private renderSelectContainer;

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

@@ -1,21 +1,9 @@
 import { VegaSlimmer } from '../../../../vega-slimmer/vega-slimmer-core';
 import { VegaInputSelect } from '../../vega-input-select';
-import { Nullable } from '../../../../types/general';
-/** Manager remote invocation */
 export declare class VegaInputSelectPrefixIconRenderer extends VegaSlimmer {
   host: VegaInputSelect['host'];
   private prefixIcon;
-  private remotePhoneNumberPrefixIconRenderSubject;
-  /**
-   * Component lifecycle - connectedCallback
-   */
-  connectedCallback(): void;
-  /**
-   * Call the render function in input-phone-number.
-   *
-   * @param {unknown[]} args - arguments of remote search function
-   * @returns {Nullable<HTMLVegaFlagIconElement>} - returned vega-flag-icon.
-   */
-  callRemotePrefixIconRender(...args: unknown[]): Nullable<HTMLVegaFlagIconElement>;
+  private hasPrefixSlot;
+  checkPrefixSlotPresence(): void;
   render(): HTMLDivElement;
 }

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

@@ -56,6 +56,7 @@ export declare class VegaInputSelect {
   currentBreakpoint: BreakpointsTokenType;
   isLazyLoading: boolean;
   selectedItem: Nullable<SelectSourceItem | SelectSourceItem[]>;
+  hasPrefixSlot: boolean;
   /**
    * Specifies the label or title for the input field.
    *

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

@@ -21,6 +21,23 @@ export declare class VegaModalOpenStateController extends VegaSlimmer {
   protected readonly ariaDialogFocusableTrapSlimmer: AriaDialogFocusableTrapSlimmer;
   private backdropMouseDownOnHost;
   private backdropMouseUpOnHost;
+  /**
+   * Component lifecycle - [connectedCallback]
+   *
+   * Capture-phase Escape listener is registered here (rather than
+   * `componentDidLoad`) so it is re-added whenever the modal element is moved
+   * in the DOM (e.g. RTE's Insert-via-URL modal is moved to `host.parentElement`
+   * before being shown — that triggers disconnect+connect but does not re-fire
+   * `componentDidLoad`).
+   *
+   * Capture-phase Escape listener so ancestor focus-trap containers (e.g. a
+   * Bootstrap modal whose own keydown handler is attached to the modal
+   * element) do not also react to the same Escape press while a vega-modal
+   * is open inside them. Capture phase fires before any descendant bubble
+   * listener; calling `stopPropagation` then prevents those listeners from
+   * running. We only intervene when this is the topmost open vega-modal.
+   */
+  connectedCallback(): void;
   /**
    * Component lifecycle - [disconnectedCallback]
    */
@@ -95,6 +112,22 @@ export declare class VegaModalOpenStateController extends VegaSlimmer {
    * @param {VegaModalOpenStateChangeTrigger} triggerBy - Source that initiated the change.
    */
   changeOpenState(isOpen: boolean, triggerBy: VegaModalOpenStateChangeTrigger): void;
+  /**
+   * Capture-phase document `keydown` listener for Escape. When this modal is
+   * the topmost open vega-modal we close it and stop propagation so that
+   * ancestor focus traps (e.g. a Bootstrap modal which closes itself on
+   * Escape via its own keydown listener attached to the modal element) do
+   * not also react to the same key press and close themselves.
+   *
+   * If an inner overlay (vega-dropdown / vega-popover) already handled this
+   * Escape press, it calls `markOverlayHandledEscape(event)` from its own
+   * capture-phase listener. `isOverlayHandledEscape` detects this so this
+   * modal does not also close — meaning Escape closes only the innermost
+   * overlay.
+   *
+   * @param {KeyboardEvent} event - The keydown event.
+   */
+  private handleEscapeCapture;
   /**
    * Manages the visibility and behavior of a modal by updating various properties
    * and emitting an event.

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

@@ -28,4 +28,5 @@ export type VegaModalOpenStateChangeTrigger =
 	| 'method' // The public modal('hide/show') method triggers to close or show modal by user.
 	| 'property' // The `open` property is changed by user.
 	| 'data-target' // The target element clicked has a `data-target='modal'` attribute and open the modal.
-	| 'data-dismiss'; // The target element clicked has a `data-dismiss='modal'` attribute and close the modal.
+	| 'data-dismiss' // The target element clicked has a `data-dismiss='modal'` attribute and close the modal.
+	| 'escape'; // User presses the Escape key while this modal is the topmost open vega-modal.

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

@@ -16,6 +16,15 @@ export declare class VegaPopoverAppenderRenderer extends VegaSlimmer {
    * @returns {HTMLVegaPopoverContentBoxElement} An HTMLVegaPopoverContentBoxElement is being returned.
    */
   getPopoverContentBox(): HTMLVegaPopoverContentBoxElement;
+  /**
+   * Whether an inner overlay (e.g. an open `vega-input-select`/`vega-dropdown`
+   * or a nested popover) is currently displayed inside this popover's content
+   * box. Such overlays own the Escape key, so the popover must not close while
+   * one of them is open.
+   *
+   * @returns {boolean} True when a visible nested overlay content box exists.
+   */
+  hasOpenNestedOverlay(): boolean;
   /**
    * The `render` function returns a JSX element for a `vega-popover-content-box` component with a ref assigned to `this.popoverContentBox`.
    *

package/dist/types/components/vega-rich-text-editor/constants/constant.d.ts

@@ -2,6 +2,11 @@ import { VegaRTEColorSchema, VegaRTETextStyleItem, VegaRTEToolbarItem } from '..
 export declare const RTE_DEFAULT_TEXT_COLOR: VegaRTEColorSchema;
 export declare const RTE_TEXT_COLORS: VegaRTEColorSchema[];
 export declare const ZERO_WIDTH_SPACE: string;
+export declare enum RTEUpdateSource {
+  Default = "default",
+  Composition = "composition"
+}
+export declare const RTE_UPDATE_SOURCE_KEY: string;
 export declare const VegaRTEDefaultTextStyleItems: VegaRTETextStyleItem[];
 export declare const VegaRTEPresetToolbarItems: VegaRTEToolbarItem[][];
 /**
@@ -33,3 +38,4 @@ export declare const RTE_PASTE_MODE_DATA_TYPE: string;
  * originated from Microsoft Word.
  */
 export declare const RTE_PASTE_MODE_WORD: string;
+export declare const RTE_WORD_COUNT_KEY: string;

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

@@ -0,0 +1,13 @@
+import { CommitValueAction } from '../../actions/commit-value-action';
+import type { VegaRTEContent } from '../../content-state';
+import { ActionHandleStrategy } from '../action-handle-strategy.abstract';
+/**
+ * Default commit strategy — the candidate becomes the committed value. Rejection
+ * is handled exclusively by interceptors that veto the commit by not executing.
+ */
+export declare class CommitValueStrategy extends ActionHandleStrategy<CommitValueAction, VegaRTEContent, VegaRTEContent> {
+  /**
+   * @inheritDoc
+   */
+  protected handleAction(action: CommitValueAction): VegaRTEContent;
+}

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

@@ -0,0 +1,20 @@
+import { Nullable } from '../../../../types/general';
+import type { VegaRTEContent } from '../content-state';
+import { ModifyContentAction } from './modify-content-action.abstract';
+/**
+ * Action type discriminator. Plain string constant — intentionally NOT added to
+ * {@link ModifyContentActionType} enum to keep the commit-validation flow self-contained.
+ */
+export declare const COMMIT_VALUE: string;
+/**
+ * Dispatched before the editor commits a candidate value. The default strategy
+ * commits the candidate as-is; interceptors are the only place a commit is vetoed.
+ */
+export declare class CommitValueAction extends ModifyContentAction {
+  readonly candidate: VegaRTEContent;
+  readonly previous: Nullable<VegaRTEContent>;
+  readonly host: HTMLVegaRichTextEditorElement;
+  isFlushable: boolean;
+  type: string;
+  constructor(candidate: VegaRTEContent, previous: Nullable<VegaRTEContent>, host: HTMLVegaRichTextEditorElement);
+}

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

@@ -104,6 +104,12 @@ export declare abstract class RTEBlock<P = RTEBlockParentType, C = RTEBlockChild
    * @returns {Nullable<RTENode>} The first RTENode or null if no children exist.
    */
   getFirstNode(): Nullable<RTENode>;
+  /**
+   * Get the plain text content of the block, used for character counting.
+   *
+   * @returns {string} The concatenated plain text of all child nodes and blocks.
+   */
+  getPlainText(): string;
   /**
    * Check if the block is a list item block
    *

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

@@ -45,6 +45,10 @@ export declare class RTEListItemBlock extends RTETextBlock {
    * @inheritDoc
    */
   getLastNode(): RTETextNode;
+  /**
+   * @inheritDoc
+   */
+  getPlainText(): string;
   /**
    * Create a new list item block.
    *

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

@@ -1,4 +1,4 @@
-import { VegaRTETextBlock, VegaRTETextBlockType, VegaRTEBlockAnnotations, VegaRTETextStyleType, VegaRTETransformOptions } from '../../interface';
+import { VegaRTETextNode, VegaRTETextBlock, VegaRTETextBlockType, VegaRTEBlockAnnotations, VegaRTETextStyleType, VegaRTETransformOptions } from '../../interface';
 import { RTETextNode } from '../nodes/text-node';
 import { Nullable } from '../../../../types/general';
 import { VegaRTEContent } from '../content-state';
@@ -25,6 +25,16 @@ export declare class RTETextBlock extends RTEBlock<VegaRTEContent | RTEListBlock
    * @returns {RTETextBlock} A RTETextBlock class
    */
   static from(block: VegaRTETextBlock, options?: VegaRTETransformOptions): RTETextBlock;
+  /**
+   * Convert raw node payloads to their registered `RTENode` subclasses via
+   * `RTEDTOClassManager`, preserving custom types (e.g. `RTETokenNode`).
+   *
+   * @param {VegaRTETextNode[]} nodes - Raw node payloads.
+   * @param {RTETextBlock} parent - Parent block for the converted nodes.
+   * @param {VegaRTETransformOptions} [options] - Optional transform options.
+   * @returns {RTETextNode[]} Converted nodes; unregistered types are dropped.
+   */
+  protected static convertNodes(nodes: VegaRTETextNode[], parent: RTETextBlock, options?: VegaRTETransformOptions): RTETextNode[];
   /**
    * The function `createAnnotationEntity` creates a block annotation entity based on the provided type
    * and value.

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

@@ -83,6 +83,12 @@ export declare class VegaRTEContent {
    * @returns {Nullable<RTENode>} The last node in the content or null if there are no nodes.
    */
   getLastNode(): Nullable<RTENode>;
+  /**
+   * Get the plain text content of the whole document, used for character counting.
+   *
+   * @returns {string} The concatenated plain text of all top-level blocks.
+   */
+  getPlainText(): string;
   /**
    * Convert text to list.
    *

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

@@ -32,6 +32,10 @@ export declare class RTECodeBlockNode extends RTEDecoratorNode<RTECodeBlock> {
    * @returns {VegaRTECodeNode} - An object contains content property.
    */
   toJSON(): VegaRTECodeNode;
+  /**
+   * @inheritDoc
+   */
+  getPlainText(): string;
   /**
    * @inheritDoc
    */

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

@@ -90,6 +90,12 @@ export declare abstract class RTENode<P extends RTEBlock = RTEBlock> {
    * @returns {boolean} - True if the node is a text node, false otherwise.
    */
   isTextNode(): this is RTETextNode;
+  /**
+   * Get the plain text content of the node, used for character counting. Default implementation returns an empty string, subclasses should override this method to provide the actual plain text content.
+   *
+   * @returns {string} The plain text content of the node.
+   */
+  getPlainText(): string;
   /**
    * Get the HTMLElement reference associated with this node.
    *

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

@@ -103,6 +103,10 @@ export declare class RTETextNode extends RTENode<RTETextBlock> {
    * @inheritDoc
    */
   isContentEditable(): boolean;
+  /**
+   * @inheritDoc
+   */
+  getPlainText(): string;
   /**
    * Returns the inline HTML wrapper descriptor at the given depth in the
    * annotation chain. Depth 0 is the outermost wrapper, depth 1 is its child, etc.

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

@@ -114,6 +114,11 @@ export declare abstract class VegaRTEToolbarButtonRenderer {
    * @param {MouseEvent} e The mouse event to prevent default action for.
    */
   protected preventDefault(e: MouseEvent): void;
+  /**
+   * Moves focus to the toolbar button. Targets the inner focusable `<button>`
+   * inside the button's shadow root, falling back to the host element.
+   */
+  protected focusToolbarButton(): void;
   /**
    * Recursively searches for a dropdown list item by its key.
    *

package/dist/types/components/vega-rich-text-editor/extensions/find-replace/slimmer/renderers/find-replace-toolbar-button-renderer.d.ts

@@ -61,4 +61,23 @@ export declare class FindReplaceToolbarButtonRenderer extends VegaRTEToolbarButt
    * Closes the panel popover.
    */
   private closePanel;
+  /**
+   * Decides whether closing the panel should return focus to the toolbar button.
+   *
+   * Focus is restored when the panel is dismissed while focus is still inside it
+   * (Escape key or the Close button) — including the VoiceOver case where the
+   * dialog's `inert` blur has already moved focus to `<body>`. It is not restored
+   * when focus has intentionally moved to another element (Tab out of the panel
+   * or interacting with something else), so we don't yank focus back.
+   *
+   * @returns {boolean} True when focus should return to the toolbar button.
+   */
+  private shouldRestoreFocusToButton;
+  /**
+   * Checks whether an element is inside the panel, crossing shadow boundaries.
+   *
+   * @param {Nullable<HTMLElement>} el - The element to test.
+   * @returns {boolean} True when the element is contained by the panel.
+   */
+  private isElementWithinPanel;
 }

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

@@ -47,4 +47,8 @@ export declare class RTELogicControlNode extends RTENode {
    * @returns {boolean} - The content editable state of the node.
    */
   isContentEditable(): boolean;
+  /**
+   * @inheritDoc
+   */
+  getPlainText(): string;
 }

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

@@ -1,5 +1,5 @@
 import { VegaRTELineHeightOption } from '../type';
-import { VegaRTECreateElementFunction, VegaRTERenderResult, VegaRTEToolbarRenderContext } from '../../interface';
+import { RTEDropdownListItem, VegaRTECreateElementFunction, VegaRTERenderResult, VegaRTEToolbarRenderContext } from '../../interface';
 import { VegaRTEToolbarButtonRenderer } from '../base-toolbar-button-renderer';
 /**
  * Renderer for the line-height toolbar button in the Vega Rich Text Editor.
@@ -11,6 +11,19 @@ export declare class RTELineHeightToolbarButtonRenderer extends VegaRTEToolbarBu
    * @inheritDoc
    */
   render(createElement: VegaRTECreateElementFunction, editorContext: VegaRTEToolbarRenderContext): VegaRTERenderResult;
+  /**
+   * Renders each line-height option with its label as light-DOM children rather than the
+   * `label` prop. This gives the focusable menuitem a light-DOM text anchor so Safari
+   * VoiceOver's reading cursor follows focus into the item (Ctrl+Opt+Right walks item→item
+   * instead of escaping to the next toolbar button).
+   *
+   * The label is wrapped in a `<span>` (not a bare text node) so a click targeting the label
+   * lands on a slotted element that composes into the item's shadow `<li>`; a bare text node
+   * resolves to the `vega-dropdown-item` host, whose click never reaches the shadow handler.
+   *
+   * @inheritDoc
+   */
+  protected renderDropdownItem(h: VegaRTECreateElementFunction, item: RTEDropdownListItem, editorContext: VegaRTEToolbarRenderContext): VegaRTERenderResult;
   /**
    * @inheritDoc
    */