@globalpayments/vega 2.89.0 → 2.91.0

package/dist/types/components/vega-app-footer/slimmers/renderers/vega-app-footer-additional-links-renderer.d.ts

@@ -0,0 +1,13 @@
+import { VegaSlimmer } from '../../../../vega-slimmer/vega-slimmer-core';
+/**
+ * This class is a slimmer that renders the additional links in the footer.
+ * It is used to separate the rendering logic from the main component.
+ */
+export declare class VegaAppFooterAdditionalLinksRenderer extends VegaSlimmer {
+  private additionalLinks;
+  private hideDefaultLinks;
+  private additionalLinkClickEventEmitter;
+  render(): HTMLElement;
+  private renderAdditionalLink;
+  private onAdditionalLinkClick;
+}

package/dist/types/components/vega-app-footer/vega-app-footer.d.ts

@@ -1,13 +1,18 @@
+import { EventEmitter } from '../../stencil-public-runtime';
 import { LinkTargetType, VegaAppFooterLink } from './types';
 import { GlobalSlimmers } from '../../vega-slimmer/vega-slimmer-core';
 import { VegaComponentUsageRuntimeMetricsSlimmer } from '../../helpers/slimmers/component-usage-runtime-metrics';
 import { BrandSwitchControllerSlimmer } from '../../helpers/slimmers/brand-switch-state-controller-slimmer';
 import { BrandOptions } from '../../helpers/theme/theme';
+import { VegaAppFooterAdditionalLinksRenderer } from './slimmers/renderers/vega-app-footer-additional-links-renderer';
+import { EventEmitSlimmerBase } from '../../helpers/event-manager/slimmers/event-emit-slimmer';
 /**
  * @vegaVersion 1.3.0
  */
 export declare class VegaAppFooter {
   protected readonly globalSlimmers: GlobalSlimmers;
+  protected additionalLinkClickEventEmitter: EventEmitSlimmerBase;
+  protected additionalLinksRenderer: VegaAppFooterAdditionalLinksRenderer;
   protected vegaComponentUsageRuntimeMetricsSlimmer: VegaComponentUsageRuntimeMetricsSlimmer<HTMLVegaAppFooterElement>;
   protected readonly brandSwitchControllerSlimmer: BrandSwitchControllerSlimmer;
   private googlePrivacyPolicyUrl;
@@ -112,6 +117,19 @@ export declare class VegaAppFooter {
    * @vegaVersion 1.27.3
    */
   disclaimerUrlTarget: LinkTargetType;
+  /**
+   * An event emitter notifying the click event of the additional link in the app footer.
+   *
+   * @vegaVersion 2.91.0
+   */
+  vegaAdditionalLinkClick: EventEmitter<VegaAppFooterLink>;
+  /**
+   * An event emitter notifying the click event of the additional link in the app footer.
+   *
+   * @eventSemantics namespace:native
+   * @vegaVersion 2.91.0
+   */
+  additionalLinkClick: EventEmitter<VegaAppFooterLink>;
   render(): VegaAppFooter;
   private getDefaultContent;
   private getDefaultTermsOfUseUrl;
@@ -121,6 +139,5 @@ export declare class VegaAppFooter {
   private renderDefaultLinks;
   private getTermsOfUseUrl;
   private getPrivacyPolicyUrl;
-  private renderAdditionalLinks;
   private renderDisclaimer;
 }

package/dist/types/components/vega-calendar/slimmers/common/controllers/vega-calendar-current-period-controller.d.ts

@@ -1,7 +1,7 @@
 import { VegaSlimmer } from '../../../../../vega-slimmer/vega-slimmer-core';
 import { VegaCalendar } from '../../../vega-calendar';
 import { CalendarDate, CalendarPeriod } from '../../../../../helpers/calendar';
-import { VegaCalendarViewModeType } from '../../../types';
+import { VegaCalendarPeriodType, VegaCalendarViewModeType } from '../../../types';
 /** This TypeScript class `VegaCalendarCurrentPeriodController` updates the current period based on the view mode in a calendar component. */
 export declare class VegaCalendarCurrentPeriodController extends VegaSlimmer {
   protected currentPeriod: VegaCalendar['currentPeriod'];
@@ -10,7 +10,7 @@ export declare class VegaCalendarCurrentPeriodController extends VegaSlimmer {
   protected showWeekends: VegaCalendar['showWeekends'];
   protected timezone: VegaCalendar['timezone'];
   /**
-   * set new current period
+   * set new current period from VegaCalendarCurrentPeriodType
    *
    * @param {CalendarPeriod} newPeriod new value
    */
@@ -45,10 +45,15 @@ export declare class VegaCalendarCurrentPeriodController extends VegaSlimmer {
    */
   protected updateCurrentPeriodAfterHideWeekEndsChange(): void;
   /**
-   * The function `getStartDateAndEndDate` returns an array of `VegaCalendarDateType` objects based on the `startDate` and `endDate` properties of the `currentPeriod` object.
+   * set new current period from VegaCalendarPeriodType
    *
-   * @returns {VegaCalendarChangeEventType['currentPeriod']} An array of objects containing the date, month, and year properties of the currentPeriod's
-   * start date and end date.
+   * @param {VegaCalendarPeriodType} newPeriod new value
    */
-  private getCurrentPeriodSummary;
+  protected setCurrentPeriodFromExternal(newPeriod: VegaCalendarPeriodType): void;
+  /**
+   * Get the current calendar period.
+   *
+   * @returns {VegaCalendarPeriodType} the current calendar period
+   */
+  protected getCurrentPeriod(): VegaCalendarPeriodType;
 }

package/dist/types/components/vega-calendar/slimmers/common/renderers/vega-calendar-switch-panel.d.ts

@@ -14,6 +14,8 @@ export declare class VegaCalendarSwitchPanelRenderer extends VegaSlimmer {
   protected translationSlimmer: VegaCalendar['translationSlimmer'];
   protected postOperationDate: VegaCalendar['postOperationDate'];
   protected showSwitchView: VegaCalendar['showSwitchView'];
+  protected timezone: VegaCalendar['timezone'];
+  protected showWeekends: VegaCalendar['showWeekends'];
   private switchPanelRef;
   /**
    * get the switch panel container element
@@ -27,18 +29,7 @@ export declare class VegaCalendarSwitchPanelRenderer extends VegaSlimmer {
    * @returns {HTMLElement} html element
    */
   render(): HTMLElement;
-  /**
-   * The `renderDateSwitch` function returns a container with buttons for switching dates and displaying the current date.
-   *
-   * @returns {HTMLDivElement} action button elements container.
-   */
   private renderDateSwitch;
-  /**
-   * The function `renderCurrentPeriod` returns an HTML element displaying the view date content summary info.
-   *
-   * @returns {HTMLVegaFontElement} The text content inside the element is "Current Date Test".
-   */
-  private renderCurrentPeriod;
   /**
    * The function `renderViewSwitch` returns a JSX element for rendering a segment control component in a TypeScript React application.
    *
@@ -57,28 +48,10 @@ export declare class VegaCalendarSwitchPanelRenderer extends VegaSlimmer {
    * @param {NotifyObserverPayload<VegaCalendarViewModeType>} input mark which view should be selected
    */
   private handleViewChange;
-  /**
-   * reset view content to today
-   */
-  private todayButtonClick;
-  /**
-   * update view content after click next button
-   */
-  private nextButtonClick;
-  /**
-   * update view content after click previous button
-   */
-  private prevButtonClick;
   /**
    * The more action menu item click
    *
    * @param {NotifyObserverPayload<string>} payload The object contains the menu item key
    */
   private moreActionMenuClick;
-  /**
-   * Get the view content date summary info, such as `January, 2024` or `10 January, 2024` or `28 December, 2023 - 3 January, 2024`
-   *
-   * @returns {string} string
-   */
-  private getViewDateSummary;
 }

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

@@ -27,8 +27,9 @@ export type VegaCalendarDateType = {
 
 /**
  * Payload for events emitted when the calendar's view period changes.
+ * Also used as the return type of the `getCurrentPeriod` method.
  */
-export type VegaCalendarChangeEventType = {
+export type VegaCalendarPeriodType = {
 	/**
 	 * The newly visible period on the calendar.
 	 */
@@ -39,6 +40,11 @@ export type VegaCalendarChangeEventType = {
 	viewMode: VegaCalendarViewModeType;
 };
 
+/**
+ * @deprecated Use VegaCalendarPeriodType instead.
+ */
+export type VegaCalendarChangeEventType = VegaCalendarPeriodType;
+
 /**
  * Describes the currently visible period on the calendar.
  */

package/dist/types/components/vega-calendar/vega-calendar-period-switcher/slimmers/controllers/vega-calendar-period-current-period-controller.d.ts

@@ -0,0 +1,63 @@
+import { VegaSlimmer } from '../../../../../vega-slimmer/vega-slimmer-core';
+import { VegaCalendarPeriodType } from '../../../types';
+import { CalendarPeriod } from '../../../../../helpers/calendar';
+/**
+ * Controller for managing the current period of a calendar component.
+ */
+export declare class VegaCalendarPeriodCurrentPeriodController extends VegaSlimmer {
+  private host;
+  private currentPeriod;
+  private viewMode;
+  private timezone;
+  private showWeekends;
+  private changeEventEmitter;
+  /**
+   * Initialize the current period based on the view mode and timezone.
+   * This method is called when the component loads and when relevant properties change.
+   */
+  protected componentWillLoad(): void;
+  /**
+   * set new current period from VegaCalendarPeriodType
+   *
+   * @param {CalendarPeriod} newPeriod new value
+   */
+  setCurrentPeriod(newPeriod: CalendarPeriod): void;
+  /**
+   * The calendar period should update when the property viewMode changes
+   */
+  protected watchViewModeChange(): void;
+  /**
+   * The calendar period should update when the property showWeekends changes
+   */
+  protected watchShowWeekendsChange(): void;
+  /**
+   * The calendar period should update when the property timezone changes
+   */
+  protected watchTimezoneChange(): void;
+  /**
+   * Watch for changes in the current period and emit an event if it changes.
+   *
+   * @param {CalendarPeriod} newValue - The new current period.
+   * @param {CalendarPeriod} oldValue - The previous current period.
+   */
+  protected watchCurrentPeriodChange(newValue: CalendarPeriod, oldValue: CalendarPeriod): void;
+  /**
+   * Get the current calendar period.
+   *
+   * @param {VegaCalendarPeriodType} period - The new calendar period to set.
+   */
+  protected setCurrentPeriodFromExternal(period: VegaCalendarPeriodType): void;
+  /**
+   * Get the current calendar period.
+   *
+   * @returns {VegaCalendarPeriodType} the current calendar period
+   */
+  protected getCurrentPeriod(): VegaCalendarPeriodType;
+  /**
+   * Update the current calendar period based on the view mode and a reference date.
+   *
+   * @param {VegaCalendarViewModeType} viewMode - The current view mode of the calendar.
+   * @param {CalendarDate} date - A reference date to calculate the new period.
+   */
+  private updateCalendarPeriod;
+}

package/dist/types/components/vega-calendar/vega-calendar-period-switcher/slimmers/controllers/vega-calendar-period-state-controller.d.ts

@@ -0,0 +1,10 @@
+import { SubStateObserverSlimmer } from '../../../../../helpers/slimmers/sub-state/sub-state-observer-slimmer';
+import { VegaCalendarPeriodSwitcher } from '../../vega-calendar-period-switcher';
+/** The `VegaCalendarPeriodStateController` class in TypeScript initializes a calendar with specified subStates. */
+export declare class VegaCalendarPeriodStateController extends SubStateObserverSlimmer<HTMLVegaCalendarPeriodSwitcherElement> {
+  protected currentPeriodController: VegaCalendarPeriodSwitcher['currentPeriodController'];
+  /**
+   * The constructor function initializes a calendar with specified subStates in TypeScript.
+   */
+  constructor();
+}

package/dist/types/components/vega-calendar/vega-calendar-period-switcher/slimmers/renderers/vega-calendar-period-renderer.d.ts

@@ -0,0 +1,11 @@
+import { VegaSlimmer } from '../../../../../vega-slimmer/vega-slimmer-core';
+export declare class VegaCalendarPeriodRenderer extends VegaSlimmer {
+  private currentPeriod;
+  private translationSlimmer;
+  private currentPeriodController;
+  render(): HTMLElement;
+  private renderTodayButton;
+  private renderPreviousButton;
+  private renderNextButton;
+  private renderDateSummary;
+}

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

@@ -0,0 +1,82 @@
+import { EventEmitter } from '../../../stencil-public-runtime';
+import { GlobalSlimmers } from '../../../vega-slimmer/vega-slimmer-core';
+import { VegaComponentUsageRuntimeMetricsSlimmer } from '../../../helpers/slimmers/component-usage-runtime-metrics';
+import { VegaCalendarPeriodType, VegaCalendarViewModeType } from '../types';
+import { CalendarPeriod } from '../../../helpers/calendar';
+import { EventEmitSlimmerBase } from '../../../helpers/event-manager/slimmers/event-emit-slimmer';
+import { VegaCalendarPeriodCurrentPeriodController } from './slimmers/controllers/vega-calendar-period-current-period-controller';
+import { VegaCalendarPeriodRenderer } from './slimmers/renderers/vega-calendar-period-renderer';
+import { VegaCalendarPeriodStateController } from './slimmers/controllers/vega-calendar-period-state-controller';
+import { TranslationSlimmer } from '../../../helpers/slimmers/translation';
+/**
+ * @vegaVersion 2.91.0
+ */
+export declare class VegaCalendarPeriodSwitcher {
+  protected translationSlimmer: TranslationSlimmer<HTMLVegaCalendarElement>;
+  protected changeEventEmitter: EventEmitSlimmerBase;
+  protected readonly globalSlimmer: GlobalSlimmers;
+  protected vegaComponentUsageRuntimeMetricsSlimmer: VegaComponentUsageRuntimeMetricsSlimmer<HTMLElement>;
+  protected currentPeriodController: VegaCalendarPeriodCurrentPeriodController;
+  protected stateController: VegaCalendarPeriodStateController;
+  protected renderer: VegaCalendarPeriodRenderer;
+  host: HTMLVegaCalendarPeriodSwitcherElement;
+  currentPeriod: CalendarPeriod;
+  /**
+   * Tracks changes to the current period state.
+   *
+   * @param {CalendarPeriod} newValue Specifies the new calendar period.
+   * @param {CalendarPeriod} oldValue Specifies the old calendar period.
+   */
+  watchCurrentPeriodChange(newValue: CalendarPeriod, oldValue: CalendarPeriod): void;
+  /**
+   * Specifies the current view mode of the calendar period switcher.
+   *
+   * @vegaVersion 2.91.0
+   */
+  viewMode: VegaCalendarViewModeType;
+  watchViewModeChange(): void;
+  /**
+   * Specifies the IANA time zone or Etc/GMT±n format.
+   *  It accepts values such as "America/New_York" or "Etc/GMT+12".
+   *  If not set, the component defaults to the system's time zone.
+   *  For a complete list of IANA time zones, see Time Zone DB(https://timezonedb.com/time-zones).
+   *
+   * @vegaVersion 2.91.0
+   */
+  timezone: string;
+  watchTimezoneChange(): void;
+  /**
+   * Determines whether weekends are displayed in the calendar period switcher.
+   *
+   * @vegaVersion 2.91.0
+   */
+  showWeekends: boolean;
+  watchShowWeekendsChange(): void;
+  /**
+   * An event emitter notifying that the calendar period has changed.
+   *
+   * @vegaVersion 2.91.0
+   */
+  vegaChange: EventEmitter<VegaCalendarPeriodType>;
+  /**
+   * An event emitter notifying that the calendar period has changed.
+   *
+   * @eventSemantics namespace:native
+   * @vegaVersion 2.91.0
+   */
+  change: EventEmitter<VegaCalendarPeriodType>;
+  /**
+   * Invoke this method to set the current calendar period.
+   * Use `VegaCalendarPeriodFactory.fromDate` to create a `VegaCalendarPeriodType` from a date if needed.
+   *
+   * @vegaVersion 2.91.0
+   */
+  setCurrentPeriod(period: VegaCalendarPeriodType): Promise<void>;
+  /**
+   * Invoke this method to get the current calendar period.
+   *
+   * @vegaVersion 2.91.0
+   */
+  getCurrentPeriod(): Promise<VegaCalendarPeriodType>;
+  render(): VegaCalendarPeriodSwitcher;
+}

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 } from './types';
+import { VegaCalendarChangeEventType, VegaCalendarEventClickInfo, VegaCalendarDateClickInfo, VegaCalendarRawEvent, VegaCalendarViewModeType, DropdownPropsForCalendar, DisabledDate, CalendarEventActionsCallback, VegaCalendarEventEditInfo, VegaCalendarPeriodType } 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';
@@ -73,6 +73,7 @@ export declare class VegaCalendar {
   protected changeEventPrevent: ChildNodesEventPreventSlimmer;
   protected readonly timeFormatNotifySlimmer: SubStateNotifySlimmerBase;
   protected readonly showEventColorBarNotifySlimmer: SubStateNotifySlimmerBase;
+  protected readonly currentPeriodNotifySlimmer: SubStateNotifySlimmerBase;
   host: HTMLVegaCalendarElement;
   calendarView: CalendarView;
   currentPeriod: CalendarPeriod;
@@ -292,6 +293,19 @@ export declare class VegaCalendar {
    * @vegaVersion 2.20.0
    */
   moreActionClick: EventEmitter<string>;
+  /**
+   * Invoke this method to set the current calendar period.
+   * Use `VegaCalendarPeriodFactory.fromDate` to create a `VegaCalendarPeriodType` from a date if needed.
+   *
+   * @vegaVersion 2.91.0
+   */
+  setCurrentPeriod(period: VegaCalendarPeriodType): Promise<void>;
+  /**
+   * Invoke this method to get the current calendar period.
+   *
+   * @vegaVersion 2.91.0
+   */
+  getCurrentPeriod(): Promise<VegaCalendarPeriodType>;
   render(): VegaCalendar;
   /**
    * Get initial post operation date considering timezone

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

@@ -63,6 +63,16 @@ export declare class VegaCheckboxGroup {
    * @vegaVersion 1.3.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.90.0
+   */
+  optional: boolean;
   /**
    * Provides a supplementary prompt message that
    *    assists users in selecting the appropriate
@@ -152,7 +162,6 @@ export declare class VegaCheckboxGroup {
    */
   render(): VegaCheckboxGroup;
   private renderLabelDom;
-  private renderRequireDom;
   private renderHintDom;
   private setVegaFlexProperty;
   /**

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

@@ -128,16 +128,8 @@ export declare class VegaComboBox {
    */
   size: VegaComboBoxSize;
   /**
-   * Specifies the maximum height of the combo box container,
-   *    including selected chips and input area.
-   *
-   * When set, vertical scrolling will be enabled once the
-   *    container content exceeds the configured height.
-   *
-   * Note: values smaller than the input minimum height (26px)
-   *    are floored to keep the input usable. Use
-   *    `vegaDropdownProps.maxHeight` to control the dropdown
-   *    menu height independently.
+   * Specifies the maximum height of the combo box container.
+   *    When the content exceeds this limit, vertical scrolling is enabled.
    *
    * @vegaVersion 2.89.0
    */

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

@@ -25,6 +25,16 @@ export declare class VegaInputCreditCard {
    * @vegaVersion 1.26.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.90.0
+   */
+  optional: boolean;
   /**
    * Determines whether the credit card input field is disabled.
    *

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

@@ -35,7 +35,6 @@ export declare class VegaInputSelectDropdownRenderer extends VegaSlimmer {
   private renderSelectContainer;
   private renderMultipleSelected;
   private renderSingleSelected;
-  private preventBlur;
   private getVegaDropdownProperties;
   private getSelectedLabelTooltipProps;
   private getDropdownSource;

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

@@ -64,6 +64,16 @@ export declare class VegaRadioGroup {
    * @vegaVersion 1.3.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.90.0
+   */
+  optional: boolean;
   /**
    * Provides a supplementary prompt message that assists users
    *    in selecting the appropriate value for the radio group.
@@ -117,7 +127,6 @@ export declare class VegaRadioGroup {
   componentDidLoad(): void;
   render(): VegaRadioGroup;
   private renderLabelDom;
-  private renderRequireDom;
   private renderHintDom;
   private setVegaFlexProperty;
   /**

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

@@ -9,3 +9,8 @@ export declare const VegaRTEPresetToolbarItems: VegaRTEToolbarItem[][];
  * Source: https://html.spec.whatwg.org/multipage/syntax.html#void-elements
  */
 export declare const HTML_VOID_TAGS: Set<string>;
+/**
+ * The visual height in pixels of one row in the rich text editor.
+ * This value is based on the paragraph line-height and padding of text content.
+ */
+export declare const VegaRTEOneRowHeightPx: number;

package/dist/types/components/vega-rich-text-editor/dto/renderers/blocks/link-wrapper-renderer.d.ts

@@ -13,11 +13,13 @@ declare class RTELinkWrapperRenderer {
    * @param {RTERenderContext} context - Context containing render options.
    * @returns {VegaRTERenderResult[]} - Array of rendered HTML elements.
    */
-  render(nodes: RTETextNode[], linkGroupAnnotation: LinkGroupAnnotation, { editable }: RTERenderContext): VegaRTERenderResult[];
+  render(nodes: RTETextNode[], linkGroupAnnotation: LinkGroupAnnotation, { editable, host }: RTERenderContext): VegaRTERenderResult[];
   private groupNodesByLink;
   private isLinkGroup;
   private renderLinkEditorWrapper;
   private renderLink;
+  private normalizeLinkNodesByDefaultProtocol;
+  private normalizeUrlByDefaultProtocol;
   private handleChange;
 }
 declare const _default: RTELinkWrapperRenderer;

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

@@ -52,25 +52,28 @@ export declare abstract class VegaRTEToolbarButtonRenderer {
    *
    * @param {VegaRTECreateElementFunction} h - Create element function.
    * @param {(RTEDropdownListItem | RTEDropdownListGroup)[]} itemList - The list of dropdown items.
+   * @param {VegaRTEToolbarRenderContext} editorContext - The render context for the editor.
    * @returns {VegaRTERenderResult} - The render result for the dropdown list.
    */
-  protected renderDropdownListTemplate(h: VegaRTECreateElementFunction, itemList: (RTEDropdownListItem | RTEDropdownListGroup)[]): VegaRTERenderResult;
+  protected renderDropdownListTemplate(h: VegaRTECreateElementFunction, itemList: (RTEDropdownListItem | RTEDropdownListGroup)[], editorContext: VegaRTEToolbarRenderContext): VegaRTERenderResult;
   /**
    * Renders a dropdown item for the toolbar button.
    *
    * @param {VegaRTECreateElementFunction} h - Create element function.
    * @param {RTEDropdownListItem} item - The dropdown item.
+   * @param {VegaRTEToolbarRenderContext} editorContext - The render context for the editor.
    * @returns {VegaRTERenderResult} - The render result for the dropdown item.
    */
-  protected renderDropdownItem(h: VegaRTECreateElementFunction, item: RTEDropdownListItem): VegaRTERenderResult;
+  protected renderDropdownItem(h: VegaRTECreateElementFunction, item: RTEDropdownListItem, editorContext: VegaRTEToolbarRenderContext): VegaRTERenderResult;
   /**
-   * Renders a dropdown item for the toolbar button.
+   * Renders a dropdown group 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.
+   * @param {VegaRTEToolbarRenderContext} editorContext - The render context for the editor.
+   * @returns {VegaRTERenderResult} - The render result for the dropdown group.
    */
-  protected renderDropdownGroup(h: VegaRTECreateElementFunction, item: RTEDropdownListGroup): VegaRTERenderResult;
+  protected renderDropdownGroup(h: VegaRTECreateElementFunction, item: RTEDropdownListGroup, editorContext: VegaRTEToolbarRenderContext): VegaRTERenderResult;
   /**
    * Renders a common toolbar button with optional icon, label, and arrow icon.
    * When a tooltip is provided via `buttonProps.tooltip`, the button is wrapped

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

@@ -14,6 +14,7 @@ import { AnnotationGeneratorStrategyAbstract } from '../slimmers/controllers/hel
 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';
+import { RTEExtensionStateStore } from './rte-extension-state-store';
 declare type BlockClassWithFrom = ClassType<RTEBlock> & {
   from(block: VegaRTEBlockBase, options?: VegaRTETransformOptions): RTEBlock;
 };
@@ -63,6 +64,14 @@ export declare abstract class VegaRTEExtension {
    * @param {AnnotationFromJsonHandler} handler - Handler that applies annotation logic to the instance.
    */
   static attachAnnotationFromJson(BlockClass: BlockClassWithFrom, annotationKey: string, handler: AnnotationFromJsonHandler): void;
+  /**
+   * Create a per-host state store for this extension.
+   * Declare as `static readonly` to share store across extension instances while isolating state per RTE host.
+   *
+   * @template T - The type of the state value to store per host.
+   * @returns {RTEExtensionStateStore<T>} A new state store instance.
+   */
+  protected static createStateStore<T>(): RTEExtensionStateStore<T>;
   /**
    * Lifecycle hook called by the rich text editor before the first render
    * (during `componentWillLoad`).  Override this method to perform per-host

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

@@ -3,23 +3,20 @@ import { VegaRTEToolbarButtonRenderer } from '../base-toolbar-button-renderer';
 export declare type LanguageSelectedCallback = (selectedLanguage: string) => void;
 /**
  * Toolbar button renderer for language selection in Vega Rich Text Editor.
- *
- * Each {@link HTMLVegaRichTextEditorElement} that uses a language extension receives its
- * **own** instance of this renderer, registered in the per-host map inside
- * {@link RTEDTORendererManager} via {@link VegaRTEExtension#prepareBeforeLoad}.  Because
- * every editor has a dedicated renderer, all state (label DOM ref, selected language, and
- * the language-change callback) is held in plain instance fields — no WeakMaps or shared
- * singletons are required.
+ * Each editor host gets its own instance, registered via
+ * {@link VegaRTEExtension#prepareBeforeLoad}, so renderer state is held in plain fields.
  */
 export declare class RTELanguageToolbarButtonRenderer extends VegaRTEToolbarButtonRenderer {
   private languageList;
   private languageChangeCallback;
   private selectedLanguage;
   private labelRef;
+  private translation;
   constructor(languageList: (RTEDropdownListItem | RTEDropdownListGroup)[], languageChangeCallback: LanguageSelectedCallback, selectedLanguage?: string);
   /**
-   * Updates the selected language and refreshes the button label text in-place,
-   * without requiring a full re-render of the toolbar.
+   * Updates the selected language and refreshes the button label text in-place
+   * without a full toolbar re-render. The label is routed through the translation
+   * helper so localization is preserved on imperative updates.
    *
    * @param {string} language The language key to set as selected.
    */
@@ -48,9 +45,7 @@ export declare class RTELanguageToolbarButtonRenderer extends VegaRTEToolbarButt
    */
   protected handleButtonClick(editorContext: VegaRTEToolbarRenderContext): void;
   /**
-   * Handles the language selection event.
-   * Because each editor has its own renderer instance, the language-change callback
-   * is stored directly on this instance — no indirect context lookup is needed.
+   * Handles the language selection event from the dropdown.
    *
    * @param {string} itemKey - The key of the selected language item.
    */
@@ -62,4 +57,13 @@ export declare class RTELanguageToolbarButtonRenderer extends VegaRTEToolbarButt
    * @returns {string} The label of the language, or the key if not found.
    */
   private getLanguageLabelByKey;
+  /**
+   * Recursively translates labels in a dropdown entry so that nested
+   * {@link RTEDropdownListGroup} children are also localized.
+   *
+   * @param {RTEDropdownListItem | RTEDropdownListGroup} entry The entry to translate.
+   * @param {VegaRTEToolbarRenderContext} editorContext The render context.
+   * @returns {RTEDropdownListItem | RTEDropdownListGroup} The translated entry.
+   */
+  private translateDropdownEntry;
 }

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

@@ -0,0 +1,27 @@
+import { VegaRTEExtension } from '../extension.abstract';
+import { VegaRTELinkExtensionConfig } from './type';
+import { RTEExtensionStateStore } from '../rte-extension-state-store';
+/**
+ * Rich Text Editor extension that configures built-in link behavior.
+ */
+export declare class VegaRTELinkExtension extends VegaRTEExtension {
+  private readonly config;
+  /**
+   * Per-host config store. Declare as static readonly to isolate config per editor host.
+   *
+   * @type {RTEExtensionStateStore<VegaRTELinkExtensionConfig>}
+   */
+  static readonly configStore: RTEExtensionStateStore<VegaRTELinkExtensionConfig>;
+  constructor(config?: VegaRTELinkExtensionConfig);
+  /**
+   * Store config per host so both toolbar-link and inline-link editors
+   * can consistently read the extension settings.
+   *
+   * @param {HTMLElement} host - The host rich text editor element.
+   */
+  prepareBeforeLoad(host: HTMLVegaRichTextEditorElement): void;
+  /**
+   * Remove config for the current host when the extension is destroyed.
+   */
+  destroyExtension(): void;
+}