@globalpayments/vega 2.90.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-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-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/slimmers/controllers/selection-controller.d.ts

@@ -104,6 +104,28 @@ export declare class SelectionController extends AutoRunWhenReRenderTaskQueueSli
    * The method invoke after the component re-render.
    */
   protected doTask: () => Promise<void>;
+  /**
+   * Scroll the editor's scrollable viewport so the caret stays visible.
+   * Setting the selection range programmatically does not trigger the browser's
+   * native auto-scroll, so when the cursor is moved (e.g. after inserting a
+   * function block) it can land outside the visible area of a fixed-height
+   * (rows) editor. This keeps the caret within view.
+   *
+   * Note: This method performs getBoundingClientRect() reads and is called during
+   * the re-render task path every time the saved selection is restored.
+   *
+   * @param {Range} range - The range that was applied to the selection.
+   */
+  private scrollCaretIntoView;
+  /**
+   * Get the bounding rect of the caret for the given range.
+   * A collapsed range inside an empty node can return an empty rect, so in that
+   * case fall back to the nearest element's bounding rect.
+   *
+   * @param {Range} range - The range to measure.
+   * @returns {Nullable<DOMRect>} The caret bounding rect, or null if it cannot be resolved.
+   */
+  private getCaretRect;
   /**
    * Save the current selection range detail
    */

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

@@ -163,11 +163,14 @@ export declare class VegaRichTextEditor {
    */
   hint: string;
   /**
-   * Specifies editable section rows for the rich text editor
+   * Specifies editable section rows for the rich text editor.
+   * When not set, the editor uses stretching behavior with a default visual height of 5 rows.
+   * When set, the editor height is fixed and content overflow is scrollable.
+   * The value accepts integers ≥ 2; for optimal display, values below 2 are internally normalized to 5 rows.
    *
    * @vegaVersion 2.34.0
    */
-  rows: number;
+  rows?: number;
   /**
    * Specifies the value of the rich text editor, which can be either VegaRTEContent or VegaRTEContentBlock.
    * It is recommended to use the VegaRTEContent type.