@globalpayments/vega 2.87.0 → 2.89.0

package/dist/types/components/vega-rich-text-editor/extensions/table/dto/table-head-cell-block.d.ts

@@ -13,6 +13,8 @@ export declare type VegaRTETableHeadCellBlock = VegaRTEBlockBase & {
  * Class representing a table head block in the rich text editor.
  */
 export declare class RTETableHeadCellBlock extends RTETableCellBlock {
+  static readonly dtoName: string;
+  readonly dtoName: string;
   type: string;
   constructor(id: string, options?: VegaRTETransformOptions);
   /**

package/dist/types/components/vega-rich-text-editor/extensions/table/dto/table-row-block.d.ts

@@ -13,6 +13,8 @@ export declare type VegaRTETableRowBlock = VegaRTEBlockBase & {
  * Class representing a table row block in the rich text editor.
  */
 export declare class RTETableRowBlock extends RTEBlock<RTETableBodyBlock | RTETableHeadBlock, RTETableCellBlock | RTETableHeadCellBlock> {
+  static readonly dtoName: string;
+  readonly dtoName: string;
   type: string;
   parent: RTETableBodyBlock | RTETableHeadBlock;
   children: (RTETableCellBlock | RTETableHeadCellBlock)[];

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

@@ -5,6 +5,8 @@ import { VegaRTEExtension } from '../extension.abstract';
  */
 export declare class VegaRTETokenExtension extends VegaRTEExtension {
   private tokenRenderer;
-  private tokenToolbarButtonRenderer;
+  private readonly tokenList;
   constructor(tokenList?: (RTEDropdownListItem | RTEDropdownListGroup)[]);
+  /** @inheritDoc */
+  prepareBeforeLoad(host: HTMLVegaRichTextEditorElement): void;
 }

package/dist/types/components/vega-rich-text-editor/extensions/tokens/token-node.d.ts

@@ -5,6 +5,8 @@ import { RTENodeAnnotationMapKey, RTENodeAnnotationMapValue, VegaRTETokenNode }
  * Token node for the Vega Rich Text Editor.
  */
 export declare class RTETokenNode extends RTETextNode {
+  static dtoName: string;
+  readonly dtoName: string;
   type: string;
   token: string;
   constructor(id: string, token: string, text: string, parentBlock: RTETextBlock, annotations?: Map<RTENodeAnnotationMapKey, RTENodeAnnotationMapValue>);

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

@@ -0,0 +1,14 @@
+/**
+ * Line height option configuration for the line-height extension.
+ */
+export declare type VegaRTELineHeightOption = {
+  /**
+   * Optional display title for the option.
+   * If not provided, the value will be used as the display label.
+   */
+  title?: string;
+  /**
+   * The line height value to apply.
+   */
+  value: string;
+};

package/dist/types/components/vega-rich-text-editor/helpers/extension-context-manager.d.ts

@@ -12,7 +12,7 @@ declare class RTEExtensionContextManager {
    *
    * @param {RTEExtensionContext} context - The extension context to store.
    */
-  setExtensionContext(context: RTEExtensionContext): void;
+  updateExtensionContext(context: RTEExtensionContext): void;
   /**
    * Get the extension context for the given rich text editor host element.
    *

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

@@ -17,6 +17,7 @@ import * as VegaComponents from '../../components';
 import { RTEHtmlBlock } from './dto/blocks/html-block';
 import { InlineHtmlAnnotation } from './dto/annotations/inline-html-annotation';
 import { RTERange, RTERangeOptions } from './dto/range';
+import { TranslationSlimmer } from '../../helpers/slimmers/translation';
 import type { RTENode } from './dto/nodes/node.abstract';
 import type { VegaRTEContent } from './dto/content-state';
 
@@ -478,6 +479,8 @@ export type VegaRTEToolbarItem =
 	| 'rightAlign'
 	| 'justified'
 	| 'codeBlock'
+	| 'undo'
+	| 'redo'
 	| string; // Custom toolbar item types can be added here
 
 /**
@@ -695,6 +698,11 @@ export type VegaRTEToolbarRenderContext = {
 	 * Whether source edit mode is enabled.
 	 */
 	sourceEditMode: boolean;
+	/**
+	 * Translation slimmer for i18n support.
+	 * Used to translate tooltip texts and other dynamic strings in extension toolbar buttons.
+	 */
+	translation: TranslationSlimmer<HTMLVegaRichTextEditorElement>;
 };
 
 /**

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

@@ -16,6 +16,10 @@ export { RTELanguageToolbarButtonRenderer } from './extensions/languages/languag
 export { VegaRTELanguageExtension } from './extensions/languages/language-extension';
 export { VegaRTEFunctionExtension } from './extensions/functions/function-extension';
 export { VegaRTETableExtension } from './extensions/table/table-extension';
+export { VegaRTEHorizontalLineExtension } from './extensions/horizontal-line/horizontal-line-extension';
+export { VegaRTESpecialCharactersExtension } from './extensions/special-characters/special-characters-extension';
+export { VegaRTESpecialCharactersEssentials, VegaRTESpecialCharactersLatin, VegaRTESpecialCharactersMathematical, VegaRTESpecialCharactersArrows, VegaRTESpecialCharactersCurrency, VegaRTESpecialCharactersText, } from './extensions/special-characters/constants/default-categories';
+export { VegaRTELineHeightExtension } from './extensions/line-height/line-height-extension';
 export { ModifyContentAction, ModifyContentActionType } from './dto/actions/modify-content-action.abstract';
 export { AppendChildrenAction } from './dto/actions/append-child-nodes-action';
 export { RemoveChildrenAction } from './dto/actions/remove-child-action';
@@ -35,4 +39,6 @@ export { ElementToDTOStrategy } from './slimmers/controllers/helper/element-to-d
 export { BlockToRTEBlockStrategyAbstract } from './slimmers/controllers/helper/element-to-dto-strategy/block-to-rte-block-strategy.abstract';
 export { htmlElementToAnnotationGenerator };
 export { VegaRTEDefaultTextStyleItems, VegaRTEPresetToolbarItems } from './constants/constant';
+export { VegaRTEDefaultLineHeightOptions } from './extensions/line-height/constants';
+export { VegaRTELineHeightOption } from './extensions/type';
 export { RTEFilterStylesStrategy } from './dto/filter-styles-strategies/filter-styles-strategy.abstract';

package/dist/types/components/vega-rich-text-editor/slimmers/controllers/helper/element-to-dto-strategy/annotation-handler/html-element-to-annotation-generator.d.ts

@@ -3,7 +3,9 @@ import { VegaRTEAnnotations, VegaRTETextAnnotations, VegaRTETransformOptions } f
 import { RTEBlock } from '../../../../../dto/blocks/block.abstract';
 import { RTENode } from '../../../../../dto/nodes/node.abstract';
 import { ClassPrototype } from '../../../../../../../types/class.type';
-export declare type RTEDtoClassPrototype = ClassPrototype<RTEBlock | RTENode>;
+export declare type RTEDtoClassPrototype = ClassPrototype<RTEBlock | RTENode> & {
+  readonly dtoName: string;
+};
 export declare type HtmlElementToAnnotationGenerateOptions = {
   parentAnnotations?: VegaRTETextAnnotations;
 } & Partial<Pick<VegaRTETransformOptions, 'autoMatchFormat' | 'skipCustomAnnotations' | 'filterInlineStyles'>>;

package/dist/types/components/vega-rich-text-editor/slimmers/renderers/toolbar-renderer.d.ts

@@ -19,8 +19,11 @@ export declare class ToolbarRenderer extends VegaSlimmer {
   codeToolbarButtonSlimmer: VegaRichTextEditor['codeToolbarButtonSlimmer'];
   linkToolbarButtonSlimmer: VegaRichTextEditor['linkToolbarButtonSlimmer'];
   codeBlockToolbarButtonSlimmer: VegaRichTextEditor['codeBlockToolbarButtonSlimmer'];
+  undoToolbarButtonSlimmer: VegaRichTextEditor['undoToolbarButtonSlimmer'];
+  redoToolbarButtonSlimmer: VegaRichTextEditor['redoToolbarButtonSlimmer'];
   sourceEditToolbarButtonSlimmer: VegaRichTextEditor['sourceEditToolbarButtonSlimmer'];
   selectionController: VegaRichTextEditor['selectionController'];
+  translationSlimmer: VegaRichTextEditor['translationSlimmer'];
   sourceView: VegaRichTextEditor['sourceView'];
   render(): HTMLElement;
   private getToolbarBtnRenderer;

package/dist/types/components/vega-rich-text-editor/slimmers/renderers/tools/redo-toolbar-button-slimmer.d.ts

@@ -0,0 +1,9 @@
+import { VegaRichTextEditor } from '../../../vega-rich-text-editor';
+import { VisualModeToolbarButtonSlimmer } from './visual-mode-toolbar-button-slimmer.abstract';
+export declare class RedoToolbarButtonSlimmer extends VisualModeToolbarButtonSlimmer {
+  protected readonly historyController: VegaRichTextEditor['historyController'];
+  constructor();
+  protected onClick(): void;
+  protected isSelected(): boolean;
+  protected isDisabled(): boolean;
+}

package/dist/types/components/vega-rich-text-editor/slimmers/renderers/tools/undo-toolbar-button-slimmer.d.ts

@@ -0,0 +1,9 @@
+import { VegaRichTextEditor } from '../../../vega-rich-text-editor';
+import { VisualModeToolbarButtonSlimmer } from './visual-mode-toolbar-button-slimmer.abstract';
+export declare class UndoToolbarButtonSlimmer extends VisualModeToolbarButtonSlimmer {
+  protected readonly historyController: VegaRichTextEditor['historyController'];
+  constructor();
+  protected onClick(): void;
+  protected isSelected(): boolean;
+  protected isDisabled(): boolean;
+}

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

@@ -6,6 +6,7 @@ export declare class VegaRichTextEditorRenderer extends VegaSlimmer {
   toolbarRenderer: VegaRichTextEditor['toolbarRenderer'];
   label: VegaRichTextEditor['label'];
   required: VegaRichTextEditor['required'];
+  optional: VegaRichTextEditor['optional'];
   hint: VegaRichTextEditor['hint'];
   disabled: VegaRichTextEditor['disabled'];
   rows: VegaRichTextEditor['rows'];

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

@@ -39,6 +39,8 @@ import { DeleteSelectedNodesController } from './slimmers/controllers/delete-sel
 import { TranslationSlimmer } from '../../helpers/slimmers/translation';
 import { HistoryController } from './slimmers/controllers/history-controller';
 import { CodeBlockToolbarButtonSlimmer } from './slimmers/renderers/tools/code-block-toolbar-button-slimmer';
+import { UndoToolbarButtonSlimmer } from './slimmers/renderers/tools/undo-toolbar-button-slimmer';
+import { RedoToolbarButtonSlimmer } from './slimmers/renderers/tools/redo-toolbar-button-slimmer';
 import { InternalCodeBlockSelectionController } from './slimmers/controllers/internal-code-block-selection-controller';
 import { SourceEditToolbarButtonSlimmer } from './slimmers/renderers/tools/source-edit-toolbar-button-slimmer';
 import { VegaRTEExtension } from './extensions/extension.abstract';
@@ -74,6 +76,8 @@ export declare class VegaRichTextEditor {
   protected readonly bulletsNumbersToolbarButtonSlimmer: BulletsNumbersToolbarButtonSlimmer;
   protected readonly horizontalAlignmentToolbarButtonSlimmer: HorizontalAlignmentToolbarButtonSlimmer;
   protected readonly codeBlockToolbarButtonSlimmer: CodeBlockToolbarButtonSlimmer;
+  protected readonly undoToolbarButtonSlimmer: UndoToolbarButtonSlimmer;
+  protected readonly redoToolbarButtonSlimmer: RedoToolbarButtonSlimmer;
   protected readonly sourceEditToolbarButtonSlimmer: SourceEditToolbarButtonSlimmer;
   protected readonly placeholderNotifySlimmer: SubStateNotifySlimmerBase;
   protected readonly disabledNotifySlimmer: SubStateNotifySlimmerBase;
@@ -110,6 +114,16 @@ export declare class VegaRichTextEditor {
    * @vegaVersion 2.34.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.88.0
+   */
+  optional: boolean;
   /**
    * Specifies a placeholder string that displays as a
    *    temporary hint or example within the rich text editor.

package/dist/types/components/vega-selection-tile/vega-selection-tile-group/slimmers/renderers/vega-selection-tile-group-renderer.d.ts

@@ -4,14 +4,15 @@ export declare class VegaSelectionTileGroupRenderer extends VegaSlimmer {
   host: VegaSelectionTileGroup['host'];
   label: VegaSelectionTileGroup['label'];
   required: VegaSelectionTileGroup['required'];
+  optional: VegaSelectionTileGroup['optional'];
   hint: VegaSelectionTileGroup['hint'];
   layout: VegaSelectionTileGroup['layout'];
+  disabled: VegaSelectionTileGroup['disabled'];
   itemsController: VegaSelectionTileGroup['itemsController'];
   private groupContainerRef;
   getGroupContainerRef(): HTMLElement;
   render(): HTMLElement;
   private renderLabel;
-  private renderRequire;
   private renderContainer;
   private renderHint;
 }

package/dist/types/components/vega-selection-tile/vega-selection-tile-group/vega-selection-tile-group.d.ts

@@ -86,6 +86,16 @@ export declare class VegaSelectionTileGroup {
    * @vegaVersion 2.7.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.89.0
+   */
+  optional: boolean;
   /**
    * Indicates if the selection tile group is disabled.
    *

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

@@ -3,6 +3,7 @@ import { VegaSignatureCapture } from '../../../vega-signature-capture';
 export declare class WrittenModeRenderer extends VegaSlimmer {
   label: VegaSignatureCapture['label'];
   required: VegaSignatureCapture['required'];
+  optional: VegaSignatureCapture['optional'];
   showClearBtn: VegaSignatureCapture['showClearBtn'];
   placeholder: VegaSignatureCapture['placeholder'];
   placeholderIcon: VegaSignatureCapture['placeholderIcon'];

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

@@ -52,6 +52,16 @@ export declare class VegaSignatureCapture {
    * @vegaVersion 2.19.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.89.0
+   */
+  optional: boolean;
   /**
    * Determines whether the clear button is displayed.
    *

package/dist/types/components/vega-text/slimmers/renderers/vega-text-tooltip-renderer.d.ts

@@ -2,12 +2,12 @@ import { VegaText } from '../../vega-text';
 import { PageResizeObserverSlimmer } from '../../../../helpers/slimmers/page-resize-observer-slimmer';
 /** The vega-text tooltip renderer slimmer */
 export declare class VegaTextTooltipRenderer extends PageResizeObserverSlimmer {
-  private static readonly DEFAULT_FONT_SIZE;
   host: VegaText['host'];
+  text: VegaText['text'];
   tooltip: VegaText['tooltip'];
   overflow: VegaText['overflow'];
   private tooltipRef;
-  private content;
+  private widthCheckerRef;
   /**
    * Component lifecycle - [componentDidLoad]{@link VegaText.componentDidLoad}
    */
@@ -18,6 +18,12 @@ export declare class VegaTextTooltipRenderer extends PageResizeObserverSlimmer {
    * @see{module:vega-text-restore-on-enlarge-screen-size}
    */
   constructor();
+  /**
+   * Watching the text prop — sync cached content and re-evaluate tooltip.
+   * The below method is e2e-test covered in
+   * @see{module:vega-text-with-dynamic-update-content}
+   */
+  watchText(): void;
   /**
    * The below method is e2e-test covered in
    * @see{module:vega-text-with-tooltip-placement}
@@ -31,22 +37,32 @@ export declare class VegaTextTooltipRenderer extends PageResizeObserverSlimmer {
    */
   private handleTooltip;
   /**
-   * The below method is e2e-test covered in
+   * Removes the tooltip from the DOM and restores plain text, regardless of hydration state.
+   *
    * @see{module:vega-text-with-long-text}
    * @see{module:vega-text-with-long-text-change-screen-size}
    */
-  private createTooltip;
-  /** Calculate the number of displayed characters according to the screen width and font size.
-   * In order to avoid errors, recalculate whether the vega-tooltip displays a line break.
-   * If it has, gradually reduce the number of calculated characters until there is no line break.
-   * If there is no newline yet, incrementally increase the counted number of characters until the newline.
-   * The below method is e2e-test covered in
+  private removeTooltip;
+  /**
+   * Update the tooltip display text.
+   *
    * @see{module:vega-text-with-long-text}
    * @see{module:vega-text-with-long-text-change-screen-size}
-   * @see{module:vega-text-with-long-text-minimize-screen-size}
-   * @see{module:vega-text-with-long-text-minimize-screen-safari}
    */
   private updateTooltipDisplayText;
+  /**
+   * The below method is e2e-test covered in
+   * @see{module:vega-text-with-long-text}
+   * @see{module:vega-text-with-long-text-change-screen-size}
+   */
+  private createTooltip;
+  /**
+   * Get the truncated text based on the available width and the font styles.
+   * If the truncated length is less than or equal to 1, it will set a min-width to prevent Safari from wrapping the text to multiple lines when the container is narrower than a single character.
+   *
+   * @see{module:vega-text-with-long-text}
+   */
+  private computeTruncatedText;
   /**
    * The below method is e2e-test covered in
    * @see{module:vega-text-with-long-text}
@@ -54,11 +70,17 @@ export declare class VegaTextTooltipRenderer extends PageResizeObserverSlimmer {
    * @see{module:vega-text-with-long-text-minimize-screen-size}
    */
   private truncateStringWithEllipsis;
-  private initTextContent;
   /**
    * Dynamically calculates and sets the minimum width of an element based on the content inside a hidden placeholder element.
    * The below method is e2e-test covered in
    * @see{module:vega-text-with-long-text-minimize-screen-safari}
    */
   private insertMinWidthStyle;
+  /**
+   * Check the maximum length of text that can be displayed without overflow based on the available width.
+   *
+   * @see {module:multiple-vega-text-in-flex-container}
+   * @returns {number} The maximum length of text that can be displayed without overflow.
+   */
+  private getSafeTextLengthByDom;
 }

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

@@ -17,6 +17,18 @@ export declare class VegaText {
    * @vegaVersion 1.18.0
    */
   overflow: 'ellipsis' | 'newline';
+  /**
+   * Specifies the text content to display.
+   *
+   * @vegaVersion 2.89.0
+   */
+  text: string;
+  /**
+   * The below method is e2e-test covered in
+   * @see{module:vega-text-with-dynamic-update-content}
+   */
+  /** Watching the text prop. */
+  watchText(): void;
   /**
    * Specifies the properties of the vega-tooltip in vega-text.
    *
@@ -30,5 +42,12 @@ export declare class VegaText {
   /** Watching the tooltip prop. */
   watchTooltip(): void;
   componentDidLoad(): void;
+  /**
+   * Renders the VegaText component.
+   * span.placeholder-text is used as a placeholder to maintain an optimal, fixed width when the displayed text changes, thereby preventing anomalous line breaks caused by secondary width adjustments within a flex container.
+   * span.width-checker is used to calculate the maximum length of text that can be displayed without overflow based on the available width, which is essential for the tooltip functionality to determine when to show the tooltip and what content to display in it.
+   *
+   * @returns {VegaText} The rendered JSX element.
+   */
   render(): VegaText;
 }

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

@@ -168,6 +168,16 @@ export declare class VegaTextarea {
    * @vegaVersion 1.11.0
    */
   minLength: number;
+  /**
+   * 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.88.0
+   */
+  optional: boolean;
   /**
    * Determines whether the user can vertically resize the text area by
    * dragging its bottom-right corner. When `false`, the resize handle is

package/dist/types/components/vega-time-picker/slimmers/renderers/vega-time-picker-label-renderer.d.ts

@@ -4,6 +4,7 @@ export declare class VegaTimePickerLabelRenderer extends VegaSlimmer {
   private label;
   private mode;
   private required;
+  private optional;
   private disabled;
   private singleInputRenderer;
   private rangeInputRenderer;

package/dist/types/components/vega-time-picker/vega-time-picker.d.ts

@@ -84,6 +84,16 @@ export declare class VegaTimePicker {
    * @vegaVersion 1.12.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.89.0
+   */
+  optional: boolean;
   /**
    * Specifies placeholder strings that provide a temporary hint
    *    or example inside the time input field.

package/dist/types/components/vega-toggle-switch/vega-toggle-switch.d.ts

@@ -48,6 +48,16 @@ export declare class VegaToggleSwitch {
    * @vegaVersion 2.25.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.89.0
+   */
+  optional: boolean;
   /**
    * Specifies whether the toggle switch is disabled.
    *