@globalpayments/vega 2.77.0 → 2.78.0

package/dist/types/components/vega-input-phone-number/vega-input-phone-number.d.ts

@@ -30,127 +30,192 @@ export declare class VegaInputPhoneNumber {
   host: HTMLVegaInputPhoneNumberElement;
   phoneNumberInputValue: string;
   /**
-   * Specifies the label or title for the phone number input field.
-   *
-   * It provides descriptive text that helps identify the
-   *    purpose or content expected in the input field.
+   * Specifies the visible label text rendered above the phone number input.
+   * The label identifies the purpose of the field and serves as the
+   * accessible name for screen readers.
    *
+   * @default ''
    * @vegaVersion 2.18.0
    */
   label: string;
   /**
-   * Specifies the size of the phone number input field.
+   * Controls the visual size of the phone number input field.
+   *
+   * - `'default'` — Standard height, suitable for most form layouts.
+   * - `'small'` — Compact height, useful for dense UIs.
    *
+   * @default 'default'
    * @vegaVersion 2.18.0
    */
   size: 'default' | 'small';
   /**
-   * Determines whether the phone number input field is required.
+   * Determines whether the phone number input field must have a value before
+   * the form can be submitted. When `true`, the built-in
+   * `InputPhoneNumberRequiredRule` is applied during validation and a
+   * required indicator is shown on the label.
    *
+   * @default false
    * @vegaVersion 2.18.0
    */
   required: boolean;
   /**
-   * Determines whether the phone number input field is disabled.
+   * Specifies whether the phone number input field is disabled. When `true`,
+   * both the country selector and the phone number text field become
+   * non-interactive — the user cannot type, select a country, or focus
+   * any part of the component.
    *
+   * @default false
    * @vegaVersion 2.18.0
    */
   disabled: boolean;
   /**
-   * Specifies the default country calling code using the two-letter uppercase country code.
+   * Specifies the currently selected country using a two-letter uppercase
+   * ISO 3166-1 alpha-2 code (e.g., `'US'`, `'GB'`, `'CN'`). The country
+   * code determines the flag icon and calling code prefix displayed in the
+   * country selector. Changing this value updates the phone number prefix
+   * accordingly.
    *
+   * @default 'US'
    * @vegaVersion 2.18.0
-   * @defaultValue US
    */
   countryCode: VegaCountryCode;
   watchCountryCode(newCountryCode: VegaCountryCode, oldCountryCode: VegaCountryCode): void;
   /**
-   * Specifies the countries available for selection.
+   * An array of country codes available for selection in the country
+   * dropdown. Each entry must be a two-letter uppercase ISO 3166-1 alpha-2
+   * code.
    *
-   * Note: By default, 245 codes are provided, but loading all of them may take time. To improve performance, it is recommended to include only the necessary codes.
+   * By default all 245 supported codes are loaded, but providing a smaller
+   * subset improves initial render performance.
    *
+   * @default VegaCountryCode[] (all 245 codes)
    * @vegaVersion 2.18.0
-   * @defaultValue ['US', 'CN', ...]{@link VegaCountryCode}
    */
   allowedCountryCodes: VegaCountryCode[];
   /**
-   * Specifies whether the phone number input field can be set to an empty value.
-   * - `true`:
-   *      The value property is cleared when the input field is empty.
-   * - `false`:
-   *      The value property is `+1` when no phone number is entered.
+   * Controls whether the `value` property can be an empty string.
    *
+   * - `true` — The `value` property is cleared to `''` when the user
+   *   deletes all digits from the input field.
+   * - `false` — The `value` property always retains at least the country
+   *   calling code prefix (e.g., `'+1'` for US) even when no phone number
+   *   digits have been entered.
+   *
+   * @default false
    * @vegaVersion 2.35.0
    */
   emptyValueEnabled: boolean;
   watchEmptyValueEnabled(): void;
   /**
-   * Specifies the value of the phone number input in [E.164]{@link https://en.wikipedia.org/wiki/E.164} format.
+   * The current value of the phone number input in
+   * [E.164](https://en.wikipedia.org/wiki/E.164) format (e.g., `'+14155552671'`).
+   *
+   * This property is mutable and reflected to the host element attribute.
+   * It updates as the user types and can be set externally to pre-populate
+   * or reset the field. When `emptyValueEnabled` is `false` and no digits
+   * have been entered, the value defaults to the country calling code
+   * prefix (e.g., `'+1'` for US).
    *
-   * @VegaWarning - Note: The input phone number field will always have a value. If no phone number is entered, the default format is `+{default_country_code}`.
-   *              - For example, if the default country code is US, the default value will be `+1`.
+   * @default '+1'
    * @vegaVersion 2.18.0
-   * @defaultValue +1
    */
   value: string;
   watchValue(newValue: string, oldValue: string): void;
   /**
-   * Specifies custom validation rules for the phone number input field.
+   * An array of custom validation rules applied to the phone number input in
+   * addition to the built-in rules (`InputPhoneNumberRequiredRule`,
+   * `ValidPhoneNumberRule`). Each rule must implement the
+   * `FormFieldValidationRule` interface.
    *
+   * Rules are evaluated in order when `autoValidation` is enabled or when
+   * validation is triggered programmatically.
+   *
+   * @default []
    * @vegaVersion 2.18.0
    */
   validationRules: FormFieldValidationRule<unknown>[];
   watchValidationRules(): void;
   /**
-   * Indicates whether the current value in the field is considered valid
-   *    based on the defined validation rules.
+   * Reflects the current validation status of the phone number input.
+   *
+   * - `true` — the field value passes all validation rules.
+   * - `false` — one or more validation rules have failed.
+   * - `null` — the field has not been validated yet (initial state).
    *
+   * This property is mutable: it is updated automatically when
+   * `autoValidation` is enabled, but can also be set manually to override
+   * the validation state.
+   *
+   * @default null
    * @vegaVersion 2.18.0
    */
   isValid: boolean;
   /**
-   * Determines whether the phone number input field should undergo automatic validation
-   *    during the user's input.
+   * Determines whether the phone number input should be validated
+   * automatically as the user interacts with it. When `true`, validation
+   * rules (including `required`, `ValidPhoneNumberRule`, and custom
+   * `validationRules`) are evaluated and the `isValid` property is updated
+   * accordingly.
+   *
+   * Set to `false` to handle validation manually.
    *
+   * @default true
    * @vegaVersion 2.18.0
    */
   autoValidation: boolean;
   /**
-   * Specifies a placeholder string that displays as a temporary hint
-   *    or example inside the input field.
+   * Specifies placeholder text displayed inside the phone number text field
+   * when it is empty. The placeholder disappears once the user begins typing
+   * and is typically used to indicate the expected format
+   * (e.g., `'(555) 555-5555'`).
    *
+   * @default undefined
    * @vegaVersion 2.18.0
    */
   placeholder: string;
   /**
-   * Provides a supplementary prompt message that assists users in
-   *    understanding the expected value for the input field.
+   * Supplementary helper message displayed below the phone number input that
+   * assists users in understanding the expected value or provides additional
+   * context (e.g., `'We will send a verification code to this number'`).
    *
+   * @default ''
    * @vegaVersion 2.18.0
    */
   hint: string;
   /**
-   * An event emitter notifying a value change.
+   * Fires whenever the phone number value changes — including typing,
+   * pasting, or programmatic updates. The event detail contains the full
+   * phone number in E.164 format (e.g., `'+14155552671'`).
    *
+   * @eventDetail string
    * @vegaVersion 2.18.0
    */
   vegaChange: EventEmitter<string>;
   /**
-   * An event emitter notifying a value change.
+   * Native-equivalent mirror of `vegaChange`. Fires with the same payload
+   * and at the same time, allowing consumers to listen using the standard
+   * `change` event name.
    *
+   * @eventDetail string
    * @eventSemantics namespace:native
    * @vegaVersion 2.18.0
    */
   change: EventEmitter<string>;
   /**
-   * An event emitter notifying a country change.
+   * Fires whenever the selected country changes via the country dropdown.
+   * The event detail contains a `VegaCountryType` object with the country
+   * code, calling code, and display name of the newly selected country.
    *
+   * @eventDetail VegaCountryType
    * @vegaVersion 2.18.0
    */
   vegaCountryChange: EventEmitter<VegaCountryType>;
   /**
-   * An event emitter notifying a country change.
+   * Native-equivalent mirror of `vegaCountryChange`. Fires with the same
+   * payload and at the same time, allowing consumers to listen using the
+   * standard `countryChange` event name.
    *
+   * @eventDetail VegaCountryType
    * @eventSemantics namespace:native
    * @vegaVersion 2.18.0
    */

package/dist/types/components/vega-input-range/slimmers/renderers/vega-input-range-input-renderer.d.ts

@@ -10,6 +10,7 @@ export declare class VegaInputRangeInputRenderer extends VegaSlimmer {
   protected max: VegaInputRange['max'];
   protected size: VegaInputRange['size'];
   protected placeholder: VegaInputRange['placeholder'];
+  protected label: VegaInputRange['label'];
   protected showClearIcon: VegaInputRange['showClearIcon'];
   protected valueController: VegaInputRange['valueController'];
   protected clearIconRenderer: VegaInputRange['clearIconRenderer'];
@@ -54,6 +55,13 @@ export declare class VegaInputRangeInputRenderer extends VegaSlimmer {
    * @returns {string} the input placeholder text
    */
   private getPlaceholderByIndex;
+  /**
+   * Get the data aria label for the input range input by the input range index
+   *
+   * @param {number} index the range index 0|1
+   * @returns {string} the data aria label for the input range input
+   */
+  private getDataAriaLabel;
   /**
    * get the input value by the input range index
    *

package/dist/types/components/vega-input-select/vega-input-select.d.ts

@@ -80,11 +80,11 @@ export declare class VegaInputSelect {
    * Allows customization of the text displayed within the
    *    select field when single or multiple items are selected.
    *    The default format for the selected label is
-   *    `${number of selected items} Selected` for multiple mode only.
+   *    `{0} Selected` for multiple mode only.
    *
    *	To enable all modes, use the `SelectedLabelTypeForAllModes` type.
    * 		For single mode, the default format is the `displayName` of the selected item if not set
-   * 		For multiple mode, the default format is `${number of selected items} Selected` if not set
+   * 		For multiple mode, the default format is `{0} Selected` if not set
    *
    * @vegaVersion 1.35.0
    */

package/dist/types/components/vega-rich-text-editor/slimmers/controllers/insert-image-controller.d.ts

@@ -1,6 +1,9 @@
 import { VegaSlimmer } from '../../../../vega-slimmer/vega-slimmer-core';
 import { VegaRichTextEditor } from '../../vega-rich-text-editor';
+import { RTEBlock } from '../../dto/blocks/block.abstract';
 import { RTEImageNode } from '../../dto/nodes/image-node';
+import { RTENode } from '../../dto/nodes/node.abstract';
+import { RTERange } from '../../dto/range';
 /** Used to control the insert image tool button actions */
 export declare class InsertImageController extends VegaSlimmer {
   protected selectionController: VegaRichTextEditor['selectionController'];
@@ -11,9 +14,12 @@ export declare class InsertImageController extends VegaSlimmer {
    * Insert a image to current state
    *
    * @param {string} imageUrl The image url
+   * @param {RTEBlock[]} selectedBlocks The current selected blocks, if not provided, will get from selectionController
+   * @param {RTENode[]} selectedNodes The current selected nodes, if not provided, will get from selectionController
+   * @param {RTERange} currentRange The current selected range, if not provided, will get from selectionController
    * @returns {RTEImageNode} RTEImageNode
    */
-  insertImageToCaretPosition(imageUrl: string): RTEImageNode;
+  insertImageToCaretPosition(imageUrl: string, selectedBlocks?: RTEBlock[], selectedNodes?: RTENode[], currentRange?: RTERange): RTEImageNode;
   /**
    * Add image selected observer
    */

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

@@ -1,20 +1,48 @@
 import { ToolbarInternalButtonConfig } from './toolbar-button-slimmer.abstract';
 import { VegaRichTextEditor } from '../../../vega-rich-text-editor';
 import { VisualModeToolbarButtonSlimmer } from './visual-mode-toolbar-button-slimmer.abstract';
+export declare type InsertImageType = 'upload' | 'url';
+export declare type InsertImageItem = {
+  key: InsertImageType;
+  label: string;
+};
+export declare type InsertURLForm = {
+  url: string;
+};
 export declare class ImageToolbarButtonSlimmer extends VisualModeToolbarButtonSlimmer {
+  private static readonly items;
   protected insertImageController: VegaRichTextEditor['insertImageController'];
   protected imageInsertedEventEmitter: VegaRichTextEditor['imageInsertedEventEmitter'];
   protected selectionController: VegaRichTextEditor['selectionController'];
-  private inputElementRef;
+  private uploadInputRef;
+  private dropdownRef;
+  private insertURLInputRef;
+  private insertURLModalRef;
   private updateNodeURLMap;
+  private currentRange;
+  private currentSelectedBlocks;
+  private currentSelectedNodes;
   constructor();
   protected renderBtnWrapper(renderBtn: (toolbarInternalButton: ToolbarInternalButtonConfig) => HTMLElement): HTMLElement;
-  protected onClick: () => void;
   protected isSelected(): boolean;
   protected isDisabled(): boolean;
+  private renderDropdownContent;
+  private renderUploadInput;
+  private renderInsertURLModal;
+  private addDropdownObserver;
+  private addModalCancelObserver;
+  private addModalInsertObserver;
+  private insertURLImage;
+  private handleDropdownItemClick;
   /**
    * The below method is e2e-test covered in
    * @see{module:should-update-url-properly-when-upload-images}
    */
   private fileInputChange;
+  /**
+   * The below method is e2e-test covered in
+   * @see{module:should-update-url-properly-when-upload-images}
+   */
+  private applyImageNode;
+  private normalizeSafeImageUrl;
 }

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

@@ -4,7 +4,7 @@ export declare class SourceEditToolbarButtonSlimmer extends ToolbarButtonSlimmer
   sourceView: VegaRichTextEditor['sourceView'];
   selectionController: VegaRichTextEditor['selectionController'];
   valueController: VegaRichTextEditor['valueController'];
-  vegaRichTextEditorRenderer: VegaRichTextEditor['vegaRichTextEditorRenderer'];
+  richTextEditorSourceViewRenderer: VegaRichTextEditor['richTextEditorSourceViewRenderer'];
   sourceEditConfig: VegaRichTextEditor['sourceEditConfig'];
   value: VegaRichTextEditor['value'];
   constructor();

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

@@ -16,10 +16,10 @@ export declare class VegaRichTextEditorRenderer extends VegaSlimmer {
   sourceEditConfig: VegaRichTextEditor['sourceEditConfig'];
   allowSourceEdit: VegaRichTextEditor['allowSourceEdit'];
   extensions: VegaRichTextEditor['extensions'];
+  richTextEditorSourceViewRenderer: VegaRichTextEditor['richTextEditorSourceViewRenderer'];
   private richTextContainerRef;
   private richTextContentRef;
   private richTextWrapperRef;
-  private sourceCodeBlockRef;
   /**
    * Component lifecycle - [componentDidRender]{@link VegaRichTextEditor.componentDidRender}
    */
@@ -48,7 +48,6 @@ export declare class VegaRichTextEditorRenderer extends VegaSlimmer {
    * @returns {Nullable<HTMLDivElement>} The div element which has property contenteditable
    */
   getRTEEditableElementRef(): Nullable<HTMLDivElement>;
-  getSourceCode(): Nullable<string>;
   render(): VegaRichTextEditor;
   private renderRichTextEditor;
   private renderLabel;
@@ -57,6 +56,5 @@ export declare class VegaRichTextEditorRenderer extends VegaSlimmer {
   private renderCharacterCounter;
   private renderErrorMessage;
   private richTextContentFocus;
-  private renderSourceViewContent;
   private renderContent;
 }

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

@@ -0,0 +1,37 @@
+import { VegaSlimmer } from '../../../../vega-slimmer/vega-slimmer-core';
+import { VegaRichTextEditor } from '../../vega-rich-text-editor';
+import { Nullable } from '../../../../types/general';
+/**
+ * The renderer for the source view of the rich text editor. It renders a code block for editing the source code of the rich text editor content.
+ */
+export declare class VegaRichTextEditorSourceViewRenderer extends VegaSlimmer {
+  host: VegaRichTextEditor['host'];
+  allowSourceEdit: VegaRichTextEditor['allowSourceEdit'];
+  sourceView: VegaRichTextEditor['sourceView'];
+  value: VegaRichTextEditor['value'];
+  disabled: VegaRichTextEditor['disabled'];
+  sourceEditConfig: VegaRichTextEditor['sourceEditConfig'];
+  sourceCodeChangeEventEmitter: VegaRichTextEditor['sourceCodeChangeEventEmitter'];
+  private sourceCodeBlockRef;
+  private prevRecord;
+  /**
+   * Clean up the code block blur observer when the component is disconnected to prevent memory leaks.
+   */
+  clearCodeBlockBlurObserver(): void;
+  /**
+   * Get the source code from the source view's code block.
+   *
+   * @returns {Nullable<string>} The source code, or null if the code block reference is not set.
+   */
+  getSourceCode(): Nullable<string>;
+  /**
+   * Render the source view, which is a code block for editing the source code of the rich text editor content.
+   *
+   * @returns {Nullable<HTMLElement>} The rendered source view element, or null if source editing is not allowed.
+   */
+  render(): Nullable<HTMLElement>;
+  /**
+   * Handle the blur event of the code block. When the code block loses focus, emit the source code change event with the current source code.
+   */
+  private handleCodeBlockBlur;
+}

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

@@ -44,6 +44,7 @@ import { InternalCodeBlockSelectionController } from './slimmers/controllers/int
 import { SourceEditToolbarButtonSlimmer } from './slimmers/renderers/tools/source-edit-toolbar-button-slimmer';
 import { VegaRTEExtension } from './extensions/extension.abstract';
 import { RTEExtensionController } from './slimmers/controllers/extension-controller';
+import { VegaRichTextEditorSourceViewRenderer } from './slimmers/renderers/vega-rich-text-editor-source-view-renderer';
 /**
  * @vegaVersion 2.34.0
  */
@@ -88,6 +89,8 @@ export declare class VegaRichTextEditor {
   protected readonly historyController: HistoryController;
   protected readonly internalCodeBlockSelectionController: InternalCodeBlockSelectionController;
   protected readonly rteExtensionController: RTEExtensionController;
+  protected readonly sourceCodeChangeEventEmitter: EventEmitSlimmerBase;
+  protected readonly richTextEditorSourceViewRenderer: VegaRichTextEditorSourceViewRenderer;
   host: HTMLVegaRichTextEditorElement;
   richTextContentEditable: boolean;
   watchRichTextContentEditable(): void;
@@ -222,6 +225,19 @@ export declare class VegaRichTextEditor {
    * @vegaVersion 2.34.0
    */
   imageInserted: EventEmitter<VegaRichTextEditorImage>;
+  /**
+   * An event emitter notifying a source code change event. It triggers when the editor loses focus in source edit mode.
+   *
+   * @vegaVersion 2.78.0
+   */
+  vegaSourceCodeChange: EventEmitter<string>;
+  /**
+   * An event emitter notifying a source code change event. It triggers when the editor loses focus in source edit mode.
+   *
+   * @eventSemantics namespace:native
+   * @vegaVersion 2.78.0
+   */
+  sourceCodeChange: EventEmitter<string>;
   componentWillLoad(): void;
   render(): VegaRichTextEditor;
 }