@globalpayments/vega 2.18.0 → 2.19.0

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

@@ -1,10 +1,14 @@
 import { VegaSlimmer } from '../../../../../../vega-slimmer/vega-slimmer-core';
 import { VegaCalendar } from '../../../../vega-calendar';
+/** renders all-day events in a calendar view, with options to display a limited number of events and show a "more" button for additional events. */
 export declare class VegaCalendarFullDayEventRenderer extends VegaSlimmer {
+  private static maxDisplayEventLength;
   protected calendarView: VegaCalendar['calendarView'];
   protected calendarEventController: VegaCalendar['calendarEventController'];
   protected eventItemRenderer: VegaCalendar['eventItemRenderer'];
   protected fullDayEventLayoutRenderer: VegaCalendar['fullDayEventLayoutRenderer'];
+  protected showAllEventsInDayOrWeekView: VegaCalendar['showAllEventsInDayOrWeekView'];
+  protected dayViewFullDayEventMoreButtonRenderer: VegaCalendar['dayViewFullDayEventMoreButtonRenderer'];
   /**
    * render current preiod all day events
    *
@@ -14,9 +18,17 @@ export declare class VegaCalendarFullDayEventRenderer extends VegaSlimmer {
   /**
    * render current date all day events
    *
-   * @param {Nullable<CalendarEvent>[]} events calendar events
+   * @param {Nullable<CalendarEvent>[]} events displayed calendar events
    * @param {number} currentViewIndex the current date index of the array
+   * @param {Nullable<CalendarEvent>[]} allEvents all calendar events
    * @returns {HTMLVegaCalendarEventElement[]} event component array
    */
   private renderCurrentFullDayEvents;
+  /**
+   * Get the display events base on the show all events flag
+   *
+   * @param {Nullable<CalendarEvent>[][]} rowEvents row events array
+   * @returns {Nullable<CalendarEvent>[][]} the part of the events or the whole events
+   */
+  private filterDisplayEvents;
 }

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

@@ -16,3 +16,10 @@ export declare function getMonthName(date: Date, isShortName?: boolean): string;
  * @returns {number} the index of the given time string based on the specified time unit.
  */
 export declare function getTimeIndex(timeString: string, unit?: number): number;
+/**
+ * Returns a string that includes the event key for a calendar event slot.
+ *
+ * @param {string} eventKey - represents the key or identifier of a calendar event.
+ * @returns {string} a string that is a concatenation of 'vega-calendar-event-slot-' and the eventKey parameter.
+ */
+export declare function getCalendarEventSlotName(eventKey: string): string;

package/dist/types/components/vega-calendar/vega-calendar-event/slimmers/controllers/vega-calendar-event-slot-controller.d.ts

@@ -0,0 +1,30 @@
+import { VegaSlimmer } from '../../../../../vega-slimmer/vega-slimmer-core';
+import { VegaCalendarEvent } from '../../vega-calendar-event';
+/** The controller will check the calendar render mode when component will mode and copy the slot element to calendar event if the calendar event is a repeat event or the event displayed in popover */
+export declare class VegaCalendarEventSlotController extends VegaSlimmer {
+  protected host: VegaCalendarEvent['host'];
+  protected calendarEvent: VegaCalendarEvent['calendarEvent'];
+  protected slotMode: VegaCalendarEvent['slotMode'];
+  protected renderer: VegaCalendarEvent['renderer'];
+  private matchSlotElement;
+  /**
+   * Find the current calendar event slot element, if the slot element is exists, set the calendar even slotMode to true, and store the current slot element.
+   */
+  protected findTheCalendarEventSlot(): void;
+  /**
+   * Append the current slot content to slot container if the calendar event is a repeat event or the calendar event render in a popover.
+   */
+  protected appendTheRepeatEventSlotToContainer(): void;
+  /**
+   * This method is responsible for finding and returning the parent `vega-calendar` element of the current component instance
+   *
+   * @returns {HTMLElement} The vega calendar element
+   */
+  private getParentCalendarElement;
+  /**
+   * Check the calendar is in popover
+   *
+   * @returns {boolean} true or false
+   */
+  private isPopoverContent;
+}

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

@@ -6,20 +6,34 @@ export declare class VegaCalendarEventRenderer extends VegaSlimmer {
   protected host: VegaCalendarEvent['host'];
   protected timeFormat: VegaCalendarEvent['timeFormat'];
   protected calendarEvent: VegaCalendarEvent['calendarEvent'];
+  protected slotMode: VegaCalendarEvent['slotMode'];
   protected colorController: VegaCalendarEvent['colorController'];
   private eventTitleContainerRef;
+  private slotContainerRef;
   /**
    * This function returns the event title container as a nullable HTMLDivElement.
    *
    * @returns {Nullable<HTMLDivElement>} The method `getEventTitleContainer` is returning a nullable HTMLDivElement.
    */
   getEventTitleContainerRef(): Nullable<HTMLDivElement>;
+  /**
+   * Get the calendar event slot container element
+   *
+   * @returns {Nullable<HTMLDivElement>} a div element
+   */
+  getSlotContainerRef(): Nullable<HTMLDivElement>;
   /**
    * The function conditionally renders either a group event or a normal event based on a boolean flag.
    *
    * @returns {HTMLElement} the event element
    */
   render(): HTMLElement;
+  /**
+   * The vega calendar event default render
+   *
+   * @returns {HTMLElement} calendar event element
+   */
+  private calendarEventRender;
   /**
    * render background mode event element
    *
@@ -38,6 +52,25 @@ export declare class VegaCalendarEventRenderer extends VegaSlimmer {
    * @returns {HTMLDivElement} div element
    */
   private renderEventStatus;
+  /**
+   * Render the month view timed event.
+   *
+   * @returns {HTMLElement} a div element
+   */
+  private defaultNormalMonthEventContentRender;
+  /**
+   * Render the day view timed event.
+   *
+   * @param {number} eventDuration the event duration
+   * @returns {HTMLElement} a div element
+   */
+  private defaultNormalTimedEventContentRender;
+  /**
+   * Return a slot element if the calendar is not a repeat event
+   *
+   * @returns {Nullable<HTMLElement>} slot element or null
+   */
+  private getSlotElement;
   /**
    * render the custom color style tag element
    *

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

@@ -7,16 +7,19 @@ import { TimeFormat } from '../../../types/general';
 import { VegaCalendarEventSubStateController } from './slimmers/controllers/vega-calendar-sub-state-controller';
 import { VegaCalendarTitleMaxHeightController } from './slimmers/controllers/vega-calendar-event-title-max-height-controller';
 import { PageResizeObserverSlimmer } from '../../../helpers/slimmers/pageResizeObserverSlimmer';
+import { VegaCalendarEventSlotController } from './slimmers/controllers/vega-calendar-event-slot-controller';
 export declare class VegaCalendarEvent {
   protected readonly globalSlimmer: GlobalSlimmers;
   protected readonly pageResizeObserverSlimmer: PageResizeObserverSlimmer;
-  protected vegaComponentUsageRuntimeMetricsSlimmer: VegaComponentUsageRuntimeMetricsSlimmer<HTMLVegaCardElement>;
+  protected vegaComponentUsageRuntimeMetricsSlimmer: VegaComponentUsageRuntimeMetricsSlimmer<HTMLVegaCalendarEventElement>;
   protected renderer: VegaCalendarEventRenderer;
   protected colorController: VegaCalendarEventBgColorController;
+  protected slotController: VegaCalendarEventSlotController;
   protected subStateController: VegaCalendarEventSubStateController;
   protected titleMaxHeightController: VegaCalendarTitleMaxHeightController;
   host: HTMLVegaCalendarEventElement;
   timeFormat: TimeFormat;
+  slotMode: boolean;
   /**
    * Specifies the calendar event.
    */

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

@@ -0,0 +1,12 @@
+import { GlobalSlimmers } from '../../../vega-slimmer/vega-slimmer-core';
+import { VegaComponentUsageRuntimeMetricsSlimmer } from '../../../helpers/slimmers/componentUsageRuntimeMetrics';
+export declare class VegaCalendarEventSlot {
+  protected readonly globalSlimmer: GlobalSlimmers;
+  protected vegaComponentUsageRuntimeMetricsSlimmer: VegaComponentUsageRuntimeMetricsSlimmer<HTMLVegaCalendarEventSlotElement>;
+  host: HTMLVegaCalendarEventSlotElement;
+  /**
+   * Specifies the event key.
+   */
+  eventKey: string;
+  render(): VegaCalendarEventSlot;
+}

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

@@ -24,9 +24,10 @@ import { VegaComponentUsageRuntimeMetricsSlimmer } from '../../helpers/slimmers/
 import { VegaCalendarFullDayEventLayoutRenderer } from './slimmers/common/renderers/vega-calendar-full-day-event-layout-renderer';
 import { TimeFormat } from '../../types/general';
 import { SubStateNotifySlimmerBase } from '../../helpers/slimmers/sub-state/subStateNotifySlimmerBase';
+import { VegaCalendarFullDayEventMoreButtonRenderer } from './slimmers/day-view/renderers/full-day-event/vega-calendar-full-day-event-more-button-renderer';
 export declare class VegaCalendar {
   protected readonly globalSlimmer: GlobalSlimmers;
-  protected vegaComponentUsageRuntimeMetricsSlimmer: VegaComponentUsageRuntimeMetricsSlimmer<HTMLVegaCardElement>;
+  protected vegaComponentUsageRuntimeMetricsSlimmer: VegaComponentUsageRuntimeMetricsSlimmer<HTMLVegaCalendarElement>;
   protected renderer: VegaCalendarRenderer;
   protected switchPanelRenderer: VegaCalendarSwitchPanelRenderer;
   protected viewRenderer: VegaCalendarViewRenderer;
@@ -37,6 +38,7 @@ export declare class VegaCalendar {
   protected currentPeriodController: VegaCalendarCurrentPeriodController;
   protected calendarViewController: VegaCalendarViewController;
   protected dayViewFullDayEventRenderer: VegaCalendarFullDayEventRenderer;
+  protected dayViewFullDayEventMoreButtonRenderer: VegaCalendarFullDayEventMoreButtonRenderer;
   protected dayViewTimedEventRenderer: VegaCalendarTimedEventRenderer;
   protected eventItemRenderer: VegaCalendarEventItemRenderer;
   protected dayViewEventLayoutRenderer: VegaCalendarDayViewEventLayoutRenderer;
@@ -51,6 +53,7 @@ export declare class VegaCalendar {
   host: HTMLVegaCalendarElement;
   calendarView: CalendarView;
   currentPeriod: CalendarPeriod;
+  showAllEventsInDayOrWeekView: boolean;
   /**
    * Tracks changes to the current period state.
    *

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

@@ -1,6 +1,6 @@
 import { GlobalSlimmers } from '../../../vega-slimmer/vega-slimmer-core';
-import { ChildNodesEventPreventSlimmer } from '../../../helpers/event-manager/slimmers/childNodesEventPreventSlimmer';
 import { VegaComponentUsageRuntimeMetricsSlimmer } from '../../../helpers/slimmers/componentUsageRuntimeMetrics';
+import { ChildNodesEventPreventSlimmer } from '../../../helpers/event-manager/slimmers/childNodesEventPreventSlimmer';
 export declare class VegaDropdownContentBox {
   protected readonly globalSlimmers: GlobalSlimmers;
   protected eventPrevent: ChildNodesEventPreventSlimmer;

package/dist/types/components/vega-signature-capture/assets/icons.d.ts

@@ -0,0 +1,4 @@
+import { IconPayload } from '../../../helpers/icon/interface';
+export declare const Icons: Record<IconType, IconPayload>;
+declare type IconType = 'signature';
+export {};

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

@@ -0,0 +1,7 @@
+import { VegaSlimmer } from '../../../../vega-slimmer/vega-slimmer-core';
+import { VegaSignatureCapture } from '../../vega-signature-capture';
+export declare class VegaSignatureCaptureRenderer extends VegaSlimmer {
+  mode: VegaSignatureCapture['mode'];
+  writtenModeRenderer: VegaSignatureCapture['writtenModeRenderer'];
+  render(): VegaSignatureCapture;
+}

package/dist/types/components/vega-signature-capture/slimmers/written-mode/controllers/written-mode-svg-controller.d.ts

@@ -0,0 +1,88 @@
+import { VegaSlimmer } from '../../../../../vega-slimmer/vega-slimmer-core';
+import { VegaSignatureCapture } from '../../../vega-signature-capture';
+import { VegaSignatureValue } from '../../../types';
+/**
+ * Signature written mode controller
+ */
+export declare class WrittenModeSvgController extends VegaSlimmer {
+  changeEventEmitter: VegaSignatureCapture['changeEventEmitter'];
+  host: VegaSignatureCapture['host'];
+  value: VegaSignatureCapture['value'];
+  isDrawing: VegaSignatureCapture['isDrawing'];
+  disabled: VegaSignatureCapture['disabled'];
+  private signatureContainerRef;
+  private penWidth;
+  private currentPath;
+  /**
+   * Setup written listeners
+   */
+  componentDidLoad(): void;
+  /**
+   * Clear the signature
+   */
+  handleClear(): void;
+  /**
+   * Emit the vegaChange event when value changed
+   *
+   * @param {VegaSignatureValue} newValue - The `newValue` parameter is a object representing the new value for the signature capture.
+   * @param {VegaSignatureValue} oldValue - The `oldValue` parameter is a object representing the old value for the signature capture.
+   */
+  watchValue(newValue: VegaSignatureValue, oldValue: VegaSignatureValue): void;
+  /**
+   * Set the signature container ref
+   *
+   * @param {SVGElement} ref - signature container ref
+   */
+  setSignatureContainerRef(ref: SVGElement): void;
+  /**
+   * Clear the signature
+   */
+  clear: () => void;
+  /**
+   * Setup the listeners, for desktop and mobile
+   */
+  private setupListeners;
+  /**
+   * Start drawing the current path
+   *
+   * @param {MouseEvent} e - MouseEvent
+   */
+  private startDrawing;
+  /**
+   * Get the current mouse position
+   *
+   * @param {MouseEvent | TouchEvent} e - MouseEvent on desktop or TouchEvent on mobile
+   * @returns {VegaSignatureMousePosition} - Current mouse position
+   */
+  private getPoint;
+  /**
+   * Draw the current path to the end point
+   *
+   * @param {MouseEvent} e - Mouse event
+   */
+  private draw;
+  /**
+   * Stop drawing and update the value
+   */
+  private stopDrawing;
+  /**
+   * Generate the signature base64 image string
+   *
+   * @returns {string} - base64 image string
+   */
+  private generateSignatureImage;
+  /**
+   * Parse the value to svg
+   *
+   * @param {VegaSignatureValue} value - Signature value
+   * @returns {Nullable<HTMLElement>} - SVG element
+   */
+  private fromDataURL;
+  /**
+   * Fill the signature from the value.
+   * Not fill the signature if the signature container already has child nodes, that means in written status.
+   *
+   * @param {VegaSignatureValue} value - Signature value
+   */
+  private fillSignature;
+}

package/dist/types/components/vega-signature-capture/slimmers/written-mode/renderers/written-mode-renderer.d.ts

@@ -0,0 +1,27 @@
+import { VegaSlimmer } from '../../../../../vega-slimmer/vega-slimmer-core';
+import { VegaSignatureCapture } from '../../../vega-signature-capture';
+export declare class WrittenModeRenderer extends VegaSlimmer {
+  label: VegaSignatureCapture['label'];
+  required: VegaSignatureCapture['required'];
+  showClearBtn: VegaSignatureCapture['showClearBtn'];
+  placeholder: VegaSignatureCapture['placeholder'];
+  placeholderIcon: VegaSignatureCapture['placeholderIcon'];
+  disabled: VegaSignatureCapture['disabled'];
+  value: VegaSignatureCapture['value'];
+  isDrawing: VegaSignatureCapture['isDrawing'];
+  writtenModeSvgController: VegaSignatureCapture['writtenModeSvgController'];
+  private signatureCaptureContainerRef;
+  getSignatureCaptureContainer(): HTMLElement;
+  render(): HTMLElement;
+  private renderLabel;
+  private renderContainer;
+  private renderPlaceholder;
+  private renderSignaturePad;
+  private renderFooter;
+  private renderClearBtn;
+  /**
+   * The below method is e2e-test covered in
+   * @see{module:vega-signature-capture-focus-e2e}
+   */
+  private signatureCaptureFocus;
+}

package/dist/types/components/vega-signature-capture/types.d.ts

@@ -0,0 +1,5 @@
+export type VegaSignatureCaptureMode = 'written';
+
+export type VegaSignatureMousePosition = { x: number; y: number };
+
+export type VegaSignatureValue = { type: VegaSignatureCaptureMode; img: string };

package/dist/types/components/vega-signature-capture/vega-signature-capture.d.ts

@@ -0,0 +1,95 @@
+import { EventEmitter } from '../../stencil-public-runtime';
+import { GlobalSlimmers } from '../../vega-slimmer/vega-slimmer-core';
+import { VegaComponentUsageRuntimeMetricsSlimmer } from '../../helpers/slimmers/componentUsageRuntimeMetrics';
+import { VegaSignatureCaptureRenderer } from './slimmers/renderers/vega-signature-capture-renderer';
+import { WrittenModeRenderer } from './slimmers/written-mode/renderers/written-mode-renderer';
+import { VegaSignatureCaptureMode, VegaSignatureValue } from './types';
+import { WrittenModeSvgController } from './slimmers/written-mode/controllers/written-mode-svg-controller';
+import { EventEmitSlimmerBase } from '../../helpers/event-manager/slimmers/eventEmitSlimmer';
+import { FormFieldControllerSlimmer } from '../../helpers/slimmers/formFieldControllerSlimmer';
+import { FormFieldValidationRule } from '../../helpers/validator/rules/formFieldValidationRule';
+export declare class VegaSignatureCapture {
+  protected readonly globalSlimmers: GlobalSlimmers;
+  protected vegaComponentUsageRuntimeMetricsSlimmer: VegaComponentUsageRuntimeMetricsSlimmer<HTMLVegaSignatureCaptureElement>;
+  protected readonly vegaSignatureCaptureRenderer: VegaSignatureCaptureRenderer;
+  protected readonly writtenModeRenderer: WrittenModeRenderer;
+  protected readonly writtenModeSvgController: WrittenModeSvgController;
+  protected changeEventEmitter: EventEmitSlimmerBase;
+  protected formFieldController: FormFieldControllerSlimmer<VegaSignatureValue>;
+  host: HTMLVegaSignatureCaptureElement;
+  /**
+   * Specifies the state of the signature
+   */
+  isDrawing: boolean;
+  /**
+   * Specifies the mode of the signature capture
+   */
+  mode: VegaSignatureCaptureMode;
+  /**
+   * Specifies the label or title for the signature capture.
+   *
+   * It provides descriptive text that helps identify the
+   *    purpose or content expected in the signature capture.
+   */
+  label: string;
+  /**
+   * Determines whether the signature capture field is required.
+   */
+  required: boolean;
+  /**
+   * Determines whether the clear button is displayed.
+   */
+  showClearBtn: boolean;
+  /**
+   * Specifies a placeholder string that displays as a temporary hint
+   *    or example inside the signature capture.
+   *
+   * It indicates the expected format or pattern of the signature capture.
+   */
+  placeholder: string;
+  /**
+   * Specifies an icon or symbol that appears before the placeholder,
+   *    providing visual context or enhancing the aesthetic appearance
+   *    of the signature capture.
+   */
+  placeholderIcon: string;
+  /**
+   * Specifies whether the signature capture is disabled.
+   */
+  disabled: boolean;
+  /**
+   * Specifies the value of the signature capture
+   */
+  value: VegaSignatureValue | null;
+  watchValue(newValue: VegaSignatureValue, oldValue: VegaSignatureValue): void;
+  /**
+   * Indicates whether the current value in the field is considered valid or
+   *    invalid based on the defined validation rules.
+   */
+  isValid: boolean | null;
+  /**
+   * Determines whether the signature capture field should undergo automatic validation
+   *    during the user's sign.
+   */
+  autoValidation: boolean;
+  /**
+   * Defines custom validation rules for the signature capture field.
+   */
+  validationRules: FormFieldValidationRule<unknown>[];
+  watchValidationRules(): void;
+  /**
+   * An event emitter notifying a value change.
+   */
+  vegaChange: EventEmitter<VegaSignatureValue>;
+  /**
+   * An event emitter notifying a value change.
+   *
+   * @eventSemantics namespace:native
+   */
+  change: EventEmitter<VegaSignatureValue>;
+  /**
+   * Invoke this method to clear the signature
+   */
+  clear(): Promise<void>;
+  render(): VegaSignatureCapture;
+}

package/dist/types/components/vega-table/vega-table-head/vega-table-head.d.ts

@@ -1,10 +1,12 @@
 import { VegaTableHeadStateController } from './slimmers/controllers/vega-table-head-state-controller';
 import { GlobalSlimmers } from '../../../vega-slimmer/vega-slimmer-core';
 import { VegaComponentUsageRuntimeMetricsSlimmer } from '../../../helpers/slimmers/componentUsageRuntimeMetrics';
+import { ChildNodesEventPreventSlimmer } from '../../../helpers/event-manager/slimmers/childNodesEventPreventSlimmer';
 export declare class VegaTableHead {
   protected readonly globalSlimmers: GlobalSlimmers;
   protected readonly vegaTableHeadStateController: VegaTableHeadStateController;
   protected vegaComponentUsageRuntimeMetricsSlimmer: VegaComponentUsageRuntimeMetricsSlimmer<HTMLVegaTableHeadElement>;
+  protected headCellEventPrevent: ChildNodesEventPreventSlimmer;
   private tableHeadRef;
   host: HTMLVegaTableHeadElement;
   /**

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

@@ -76,6 +76,10 @@ export declare class VegaTextarea {
    *    that the user must enter in the text area.
    */
   minLength: number;
+  /**
+   * Determines whether the text area is vertically resizable.
+   */
+  resizable: boolean;
   /**
    * Specifies custom validation rules for the text area.
    */