@globalpayments/vega 2.88.0 → 2.89.0

package/dist/types/components/vega-rich-text-editor/extensions/horizontal-line/filter-styles-strategies/horizontal-line-block/horizontal-line-filter-styles-strategy.d.ts

@@ -0,0 +1,31 @@
+import { RTEBlock } from '../../../../dto/blocks/block.abstract';
+import { RTENode } from '../../../../dto/nodes/node.abstract';
+import { RTEFilterStyles, RTEFilterStylesStrategy } from '../../../../dto/filter-styles-strategies/filter-styles-strategy.abstract';
+/**
+ * Default visual styles for the `<hr>` element in the RTE.
+ * These styles match the CSS applied in `horizontal-line-block-styles.css`.
+ *
+ * @see {@link file://extensions/horizontal-line/renderers/horizontal-line-block-styles.css} — must stay in sync.
+ */
+export declare const HR_DEFAULT_STYLES: RTEFilterStyles;
+/**
+ * Filter styles strategy for horizontal line blocks.
+ * Strips default HR visual styles during output and refills them during input,
+ * ensuring source edit round-trips do not lose information.
+ */
+export declare class HorizontalLineFilterStylesStrategy extends RTEFilterStylesStrategy {
+  protected stylesToBeFiltered: RTEFilterStyles;
+  protected elementTagName: string;
+  /**
+   * @inheritDoc
+   */
+  canFilter(blockOrNodeInstance: RTEBlock | RTENode): boolean;
+  /**
+   * @inheritDoc
+   */
+  canRefill(_blockOrNodeClassName: string, element: HTMLElement): boolean;
+  /**
+   * @inheritDoc
+   */
+  toCssText(): string;
+}

package/dist/types/components/vega-rich-text-editor/extensions/horizontal-line/filter-styles-strategies/horizontal-line-block/predicate.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Predicate class provides static methods to check specific conditions on HTML elements or dto instances.
+ */
+export declare class Predicate {
+  /**
+   * Checks if the given class name corresponds to a horizontal line block.
+   *
+   * @param {string} className The class name to check.
+   * @returns {boolean} True if the class name corresponds to a horizontal line block, false otherwise.
+   */
+  static isHorizontalLineBlock(className: string): boolean;
+}

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

@@ -0,0 +1,9 @@
+import { VegaRTEExtension } from '../extension.abstract';
+/**
+ * Extension that adds horizontal line (`<hr>`) support to the Vega Rich Text Editor.
+ */
+export declare class VegaRTEHorizontalLineExtension extends VegaRTEExtension {
+  private blockRenderer;
+  private toolbarButtonRenderer;
+  constructor();
+}

package/dist/types/components/vega-rich-text-editor/extensions/horizontal-line/renderers/horizontal-line-block-renderer.d.ts

@@ -0,0 +1,16 @@
+import { VegaRTEExtensionRenderer } from '../../base-extension-renderer';
+import { RTEHorizontalLineBlock } from '../dto/horizontal-line-block';
+import { RTERenderContext, VegaRTECreateElementFunction, VegaRTERenderResult } from '../../../interface';
+/**
+ * Renderer for horizontal line blocks in the rich text editor.
+ */
+export declare class RTEHorizontalLineBlockRenderer extends VegaRTEExtensionRenderer {
+  /**
+   * @inheritDoc
+   */
+  doRender(createElement: VegaRTECreateElementFunction, block: RTEHorizontalLineBlock, rteContext: RTERenderContext): VegaRTERenderResult;
+  /**
+   * @inheritDoc
+   */
+  injectRTEScopeStyles(): string;
+}

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

@@ -0,0 +1,27 @@
+import { VegaRTEToolbarButtonRenderer } from '../../base-toolbar-button-renderer';
+import { VegaRTECreateElementFunction, VegaRTERenderResult, VegaRTEToolbarRenderContext } from '../../../interface';
+/**
+ * Toolbar button renderer for horizontal line insertion.
+ */
+export declare class RTEHorizontalLineToolbarButtonRenderer extends VegaRTEToolbarButtonRenderer {
+  /**
+   * Renders the horizontal line toolbar button.
+   *
+   * @param {VegaRTECreateElementFunction} createElement - The function to create elements.
+   * @param {VegaRTEToolbarRenderContext} editorContext - The render context.
+   * @returns {VegaRTERenderResult} The rendered toolbar button.
+   */
+  render(createElement: VegaRTECreateElementFunction, editorContext: VegaRTEToolbarRenderContext): VegaRTERenderResult;
+  /**
+   * @inheritDoc
+   */
+  protected isDisabled(editorContext: VegaRTEToolbarRenderContext): boolean;
+  /**
+   * @inheritDoc
+   */
+  protected handleButtonClick(editorContext: VegaRTEToolbarRenderContext): void;
+  /**
+   * @inheritDoc
+   */
+  protected handleDropdownClick(): void;
+}

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

@@ -16,6 +16,7 @@ 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';

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-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.
    *