@globalpayments/vega 2.90.0 → 2.92.0

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

@@ -11,6 +11,7 @@ export declare class VegaAccordionRenderer extends VegaSlimmer {
   showExpandIcon: VegaAccordion['showExpandIcon'];
   expandController: VegaAccordion['expandController'];
   translationSlimmer: VegaAccordion['translationSlimmer'];
+  host: VegaAccordion['host'];
   render(): HTMLElement;
   private renderHeader;
   private renderPrefixIcon;
@@ -19,4 +20,5 @@ export declare class VegaAccordionRenderer extends VegaSlimmer {
   private renderContent;
   private renderTitleSlot;
   private getExpandIconAriaLabel;
+  private getSlottedTitleText;
 }

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-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-field-label/slimmers/renderers/vega-field-label-suffix-element-renderer.d.ts

@@ -16,6 +16,7 @@ export declare class VegaFieldLabelSuffixElementRenderer extends VegaSlimmer {
    * Render a vega button circle component.
    *
    * @param {string} icon the button icon name
+   * @param {VegaButtonCircleSize} buttonSize the button size
    * @returns {HTMLVegaButtonCircleElement} vega button circle component
    */
   private renderSuffixButton;

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

@@ -1,3 +1,5 @@
+import { VegaButtonCircleSize } from '../vega-button-circle/types';
+
 /**
  * @deprecated Please use `LabelSuffixButtonConfig` instead
  * Configuration for the label suffix button (deprecated).
@@ -25,6 +27,16 @@ export type LabelSuffixButtonConfig = {
 	 * Icon name to display in the suffix button.
 	 */
 	icon: string;
+	/**
+	 * Controls the size of the suffix button trigger icon.
+	 */
+	buttonSize?: VegaButtonCircleSize;
+	/**
+	 * Center aligns the label text and suffix button icon.
+	 *
+	 * When omitted or false, default layout behavior is preserved.
+	 */
+	centerAlign?: boolean;
 } & Partial<
 	Pick<
 		HTMLVegaTooltipElement,

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-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/action-handle-strategies/modify-content-strategies/block-merge-nodes-strategy.d.ts

@@ -13,4 +13,13 @@ export declare class BlockMergeNodesStrategy extends ActionHandleStrategy<MergeT
    * @param {RTETextBlock | RTEImageBlock} target - The first text block or image block.
    */
   protected handleAction(action: MergeTwoBlocksNodesAction, target: RTETextBlock | RTEImageBlock): void;
+  /**
+   * Re-registers the link group annotation on the target block for any merged nodes that carry a
+   * link. The link group annotation lives on the block being removed, so without this the merged
+   * link nodes would lose their hyperlink rendering.
+   *
+   * @param {RTENode[]} mergedNodes - The nodes that were appended to the target block.
+   * @param {RTETextBlock} target - The text block that received the merged nodes.
+   */
+  private transferLinkGroups;
 }

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

@@ -0,0 +1,13 @@
+import { DeleteSelectedContentAction } from '../../actions/delete-selected-content-action';
+import type { RTEBlock } from '../../blocks/block.abstract';
+import type { VegaRTEContent } from '../../content-state';
+import { ActionHandleStrategy } from '../action-handle-strategy.abstract';
+/**
+ * DeleteSelectedContentStrategy is responsible for handling the deletion of selected content within the rich text editor.
+ */
+export declare class DeleteSelectedContentStrategy extends ActionHandleStrategy<DeleteSelectedContentAction, RTEBlock | VegaRTEContent> {
+  /**
+   * @inheritDoc
+   */
+  protected handleAction(action: DeleteSelectedContentAction): void;
+}

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

@@ -0,0 +1,12 @@
+import { ModifyContentAction, ModifyContentActionType } from './modify-content-action.abstract';
+/**
+ * Delete the currently selected content from the editor.
+ *
+ * @example currentVegaRTEContent.apply(new DeleteSelectedContentAction(host, mergeFlag))
+ */
+export declare class DeleteSelectedContentAction extends ModifyContentAction {
+  type: ModifyContentActionType;
+  mergeFlag: boolean;
+  host: HTMLVegaRichTextEditorElement;
+  constructor(host: HTMLVegaRichTextEditorElement, mergeFlag: boolean, flushable?: boolean);
+}

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

@@ -28,7 +28,8 @@ export declare enum ModifyContentActionType {
   '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",
-  'PASTE_CONTENT' = "PASTE_CONTENT"
+  'PASTE_CONTENT' = "PASTE_CONTENT",
+  'DELETE_SELECTED_CONTENT' = "DELETE_SELECTED_CONTENT"
 }
 /**
  * Abstract class for update node content, delete node, insert node

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

@@ -91,6 +91,22 @@ export declare class RTERange {
    * @returns {Nullable<Range>} The range instance. The return value could be null if the start node or end node are not rendered.
    */
   toNativeRange(): Nullable<Range>;
+  /**
+   * Clamps an offset to the valid bound of a DOM container so that
+   * `Range.setStart` / `Range.setEnd` never throw `IndexSizeError`.
+   *
+   * A stored selection offset can become stale or unit-mismatched when an undo
+   * restores a selection captured against different content — for example after
+   * find-and-replace shrinks a text node, or when the selection node's DOM
+   * container is its parent element (offset measured in child-node count rather
+   * than characters, as for non-editable token / logic-control nodes). Text
+   * containers are bounded by character length, element containers by child count.
+   *
+   * @param {Node} container - The DOM container the offset applies to.
+   * @param {number} offset - The desired offset.
+   * @returns {number} The offset clamped to `[0, container length]`.
+   */
+  private clampOffsetToContainer;
   /**
    * Retrieves an RTENode based on the given element by checking its type and parent elements.
    *

package/dist/types/components/vega-rich-text-editor/extensions/copy/action-handler-strategies/copy-selected-content-strategy.d.ts

@@ -0,0 +1,79 @@
+import { ActionHandleStrategy } from '../../../dto/action-handle-strategies/action-handle-strategy.abstract';
+import type { VegaRTEContent } from '../../../dto/content-state';
+import { CopySelectedContentAction } from '../actions/copy-selected-content-action';
+/**
+ * Strategy that extracts the HTML and plain text content of the current selection, stores the
+ * result on the {@link CopySelectedContentAction} and writes it to the clipboard.
+ */
+export declare class CopySelectedContentStrategy extends ActionHandleStrategy<CopySelectedContentAction, VegaRTEContent> {
+  /**
+   * @inheritDoc
+   */
+  protected handleAction(action: CopySelectedContentAction): void;
+  /**
+   * Extracts the HTML and text content from the current selection.
+   *
+   * `Range.cloneContents()` returns only the nodes inside the selection, dropping the ancestor chain
+   * between the selection's common ancestor and its block. When the selection stays inside a single
+   * block, those dropped ancestors carry the styling, so the cloned fragment is re-wrapped with
+   * shallow clones of every ancestor from the common ancestor up to the block, preserving arbitrary
+   * inline nesting (e.g. `block > strong > em > span > text`).
+   *
+   * When the selection covers the whole block (its common ancestor sits above the block) or spans
+   * multiple blocks, each block is already kept by `cloneContents()`, so no re-wrapping is done.
+   *
+   * @param {Nullable<Selection>} selection - The current selection object.
+   * @param {RTEBlock[]} parentBlocks - The parent blocks of the selected nodes.
+   * @returns {RTESelectedContent} - The HTML and text content of the selected content.
+   */
+  private getSelectedContent;
+  /**
+   * Wraps the cloned selection fragment with the ancestor chain that `cloneContents()` dropped,
+   * rebuilding every element from the selection's common ancestor up to the block while preserving
+   * each element's styles. Returns the cloned block that holds the rebuilt chain and content.
+   *
+   * When the common ancestor is the block itself, the fragment is appended directly under the cloned
+   * block, since no inline ancestor chain was dropped.
+   *
+   * @param {Node} content - The cloned selection fragment to place at the innermost level.
+   * @param {Node} commonAncestor - The selection's common ancestor container.
+   * @param {HTMLElement} block - The block element to stop cloning at.
+   * @returns {HTMLElement} - The cloned block wrapping the rebuilt ancestor chain and content.
+   */
+  private wrapWithAncestorChain;
+  /**
+   * Retrieves the parent blocks of the given selected nodes.
+   *
+   * @param {RTENode[]} selectedNodes - The nodes for which to find parent blocks.
+   * @returns {RTEBlock[]} An array of parent blocks.
+   */
+  private getParentBlocks;
+  /**
+   * Copies both HTML and plain text content to the clipboard using the Clipboard API.
+   *
+   * Browser compatibility for `navigator.clipboard.write()` with `ClipboardItem`:
+   * - Chrome 76+, Edge 79+, Safari 13.1+, Firefox 127+
+   *
+   * Since Firefox 86+ must be supported, fall back to `execCommand('copy')` when the
+   * Clipboard API is unavailable or fails (e.g. Firefox 86-126).
+   *
+   * @param {string} htmlContent - The HTML content to copy.
+   * @param {string} textContent - The plain text content to copy.
+   * @returns {Promise<boolean>} - A promise that resolves to true if the copy operation succeeded.
+   */
+  private copyToClipboard;
+  /**
+   * Fallback copy method using `execCommand('copy')` for browsers that don't support the
+   * Clipboard API (e.g. Firefox 86-126).
+   *
+   * Instead of creating a temporary element and changing the selection (which would clear the
+   * editor's Shadow DOM selection and steal focus), this intercepts the native `copy` event that
+   * `execCommand('copy')` triggers and overrides its clipboard data. The user's original selection
+   * and focus stay untouched.
+   *
+   * @param {string} htmlContent - The HTML content to copy.
+   * @param {string} textContent - The plain text content to copy.
+   * @returns {boolean} - True if the copy command succeeded.
+   */
+  private copyWithExecCommand;
+}

package/dist/types/components/vega-rich-text-editor/extensions/copy/actions/copy-selected-content-action.d.ts

@@ -0,0 +1,18 @@
+import { Nullable } from '../../../../../types/general';
+import { ModifyContentAction } from '../../../dto/actions/modify-content-action.abstract';
+import { RTENode } from '../../../dto/nodes/node.abstract';
+/**
+ * Action to extract the currently selected content (HTML and plain text) from the editor.
+ *
+ * The action is read-only: it does not mutate the content state. The handling strategy resolves
+ * the selected HTML and plain text and writes them directly to the clipboard.
+ *
+ * @example host.value.apply(new CopySelectedContentAction(selection, selectedNodes));
+ */
+export declare class CopySelectedContentAction extends ModifyContentAction {
+  type: string;
+  selection: Nullable<Selection>;
+  selectedNodes: RTENode[];
+  copyResult: Promise<boolean> | null;
+  constructor(selection: Nullable<Selection>, selectedNodes: RTENode[]);
+}