@globalpayments/vega 2.96.0 → 2.98.0

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

@@ -12,6 +12,8 @@ import { VegaFormSubmitController } from './slimmers/controllers/vega-form-submi
 import { VegaFormFieldController } from './slimmers/controllers/vega-form-field-controller';
 import { VegaFormResetController } from './slimmers/controllers/vega-form-reset-controller';
 /**
+ * The Form component is a utility element used to manage data validation and submission of form fields.
+ *
  * @vegaVersion 1.3.0
  */
 export declare class VegaForm {
@@ -99,6 +101,14 @@ export declare class VegaForm {
    * @vegaVersion 2.64.0
    */
   method: 'post' | 'get';
+  /**
+   * Specifies the name attribute used to identify the form field during data submission.
+   *   It functions identically to the `data-vega-form` attribute but operates at a lower priority.
+   *
+   * @default ''
+   * @vegaVersion 2.97.0
+   */
+  name: string;
   /**
    * An event emitter notifying the change in the validation result.
    *

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

@@ -2,6 +2,8 @@ import { ResponsiveType, GridRowsType, GridColumnsType, GapType, GridJustifyItem
 import { GlobalSlimmers } from '../../vega-slimmer/vega-slimmer-core';
 import { VegaComponentUsageRuntimeMetricsSlimmer } from '../../helpers/slimmers/component-usage-runtime-metrics';
 /**
+ * The Grid component is a low-level utility container that implements features of CSS Grid, and allows setting gap values using predefined size tokens.
+ *
  * @vegaVersion 1.3.0
  */
 export declare class VegaGrid {

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

@@ -2,6 +2,8 @@ import { SpacingTokenType, TextColorsTokenType } from '../../types/design-token.
 import { GlobalSlimmers } from '../../vega-slimmer/vega-slimmer-core';
 import { VegaComponentUsageRuntimeMetricsSlimmer } from '../../helpers/slimmers/component-usage-runtime-metrics';
 /**
+ * The Icon component is a wrapper for Font Awesome icons, sized and colored using design tokens.
+ *
  * @vegaVersion 1.0.4
  */
 export declare class VegaIcon {

package/dist/types/components/vega-image-uploader/vega-image-uploader.d.ts

@@ -13,7 +13,7 @@ import { VegaImageUploaderUploadingContentRenderer } from './slimmers/renderers/
 import { VegaImageUploaderDefaultContentRenderer } from './slimmers/renderers/vega-image-uploader-default-content-renderer';
 import { VegaImageUploaderRemoveController } from './slimmers/controllers/vega-image-uploader-remove-controller';
 import { DropFileAcceptFilterSlimmer } from '../../helpers/slimmers/drop-file-accept-filter-slimmer';
-import { FormFieldControllerSlimmer } from '../../helpers/slimmers/form-field-controller-slimmer';
+import { FormFieldControllerSlimmer } from '../../helpers/slimmers/form/form-field-controller-slimmer';
 import { VegaImageUploaderActionsVisibilityController } from './slimmers/controllers/vega-image-uploader-actions-visibility-controller';
 import { Nullable } from '../../types/general';
 import { ChildNodesEventPreventSlimmer } from '../../helpers/event-manager/slimmers/child-nodes-event-prevent-slimmer';
@@ -23,6 +23,8 @@ import { VegaComponentUsageRuntimeMetricsSlimmer } from '../../helpers/slimmers/
 import { TranslationSlimmer } from '../../helpers/slimmers/translation';
 import { DarkModeStateControllerSlimmer } from '../../helpers/slimmers/dark-mode-state-controller-slimmer';
 /**
+ * The Image Uploader allows users to select and upload an image file from their device.
+ *
  * @vegaVersion 1.14.0
  */
 export declare class VegaImageUploader {
@@ -112,6 +114,14 @@ export declare class VegaImageUploader {
    * @vegaVersion 2.89.0
    */
   optional: boolean;
+  /**
+   * Specifies the name attribute used to identify the form field during data submission.
+   *   It functions identically to the `data-vega-form` attribute but operates at a lower priority.
+   *
+   * @default ''
+   * @vegaVersion 2.97.0
+   */
+  name: string;
   /**
    * Specifies the validation status.
    *

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

@@ -146,5 +146,15 @@ export type InputEnterKeyHintTypes = 'enter' | 'done' | 'go' | 'next' | 'previou
  * Dropdown configuration for input suggestions.
  */
 export type VegaInputSuggestionsDropdownConfig = Partial<
-	Pick<HTMLVegaDropdownElement, 'caseSensitive' | 'itemDisplayRule' | 'isLoading' | 'searchNoResultsText'>
+	Pick<
+		HTMLVegaDropdownElement,
+		| 'caseSensitive'
+		| 'itemDisplayRule'
+		| 'isLoading'
+		| 'searchNoResultsText'
+		| 'placement'
+		| 'alignment'
+		| 'isScreenPosition'
+		| 'positionRelativeTo'
+	>
 >;

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

@@ -2,7 +2,7 @@ import { EventEmitter } from '../../stencil-public-runtime';
 import { FormFieldValidationRule } from '../../helpers/validator/rules/form-field-validation-rule';
 import { DataTransferType, InputAutocompleteTypes, InputEnterKeyHintTypes, InputType, InputValueUpdateTriggeredBy, MaskConfigType, VegaInputSuggestionsDropdownConfig } from './types';
 import { GlobalSlimmers } from '../../vega-slimmer/vega-slimmer-core';
-import { FormFieldControllerSlimmer } from '../../helpers/slimmers/form-field-controller-slimmer';
+import { FormFieldControllerSlimmer } from '../../helpers/slimmers/form/form-field-controller-slimmer';
 import { EventEmitSlimmerBase } from '../../helpers/event-manager/slimmers/event-emit-slimmer';
 import { VegaInputCopyPasteController } from './slimmers/controllers/vega-input-copy-paste-controller';
 import { VegaInputPrefixSlotRenderer } from './slimmers/renderers/vega-input-prefix-slot-renderer';
@@ -24,6 +24,8 @@ import { VegaInputRenderModeController } from './slimmers/controllers/vega-input
 import { AriaAttributesValueMapper } from '../../helpers/slimmers/mutation-observer/aria-attributes-value-mapper';
 import { DataTabIndexValueMapper } from '../../helpers/slimmers/mutation-observer/data-tab-index-value-mapper';
 /**
+ * An Input Field component allows users to enter a few words or a single line of text.
+ *
  * @vegaVersion 1.0.5
  */
 export declare class VegaInput {
@@ -157,7 +159,8 @@ export declare class VegaInput {
    */
   watchTypeChange(newType: InputType, oldType: InputType): void;
   /**
-   * Sets the `name` attribute on the underlying native `<input>` element.
+   * Specifies the name attribute used to identify the form field during data submission.
+   *   It functions identically to the `data-vega-form` attribute but operates at a lower priority.
    *
    * This is used to identify the field when submitting form data and is also
    * used by the browser's autocomplete feature to recall previously entered values.

package/dist/types/components/vega-input-credit-card/vega-input-credit-card.d.ts

@@ -1,11 +1,13 @@
 import { EventEmitter } from '../../stencil-public-runtime';
 import { FormFieldValidationRule } from '../../helpers/validator/rules/form-field-validation-rule';
 import { GlobalSlimmers } from '../../vega-slimmer/vega-slimmer-core';
-import { FormFieldControllerSlimmer } from '../../helpers/slimmers/form-field-controller-slimmer';
+import { FormFieldControllerSlimmer } from '../../helpers/slimmers/form/form-field-controller-slimmer';
 import { EventEmitSlimmerBase } from '../../helpers/event-manager/slimmers/event-emit-slimmer';
 import { ChildNodesEventPreventSlimmer } from '../../helpers/event-manager/slimmers/child-nodes-event-prevent-slimmer';
 import { VegaComponentUsageRuntimeMetricsSlimmer } from '../../helpers/slimmers/component-usage-runtime-metrics';
 /**
+ * The Credit Card Input is a text field designed specifically for entering credit card numbers.
+ *
  * @vegaVersion 1.26.0
  */
 export declare class VegaInputCreditCard {
@@ -35,6 +37,14 @@ export declare class VegaInputCreditCard {
    * @vegaVersion 2.90.0
    */
   optional: boolean;
+  /**
+   * Specifies the name attribute used to identify the form field during data submission.
+   *   It functions identically to the `data-vega-form` attribute but operates at a lower priority.
+   *
+   * @default ''
+   * @vegaVersion 2.97.0
+   */
+  name: string;
   /**
    * Determines whether the credit card input field is disabled.
    *

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

@@ -7,9 +7,11 @@ import { EventEmitSlimmerBase } from '../../helpers/event-manager/slimmers/event
 import { VegaInputNumericValueController } from './slimmers/controllers/vega-input-numeric-value-controller';
 import { VegaInputNumericKeyboardController } from './slimmers/controllers/vega-input-numeric-keyboard-controller';
 import { FormFieldValidationRule } from '../../types/components.type';
-import { FormFieldControllerSlimmer } from '../../helpers/slimmers/form-field-controller-slimmer';
+import { FormFieldControllerSlimmer } from '../../helpers/slimmers/form/form-field-controller-slimmer';
 import { SubStateNotifySlimmerBase } from '../../helpers/slimmers/sub-state/sub-state-notify-slimmer-base';
 /**
+ * The numeric input field allows users to input and increment numeric values.
+ *
  * @vegaVersion 2.29.0
  */
 export declare class VegaInputNumeric {
@@ -175,6 +177,14 @@ export declare class VegaInputNumeric {
    * @vegaVersion 2.89.0
    */
   optional: boolean;
+  /**
+   * Specifies the name attribute used to identify the form field during data submission.
+   *   It functions identically to the `data-vega-form` attribute but operates at a lower priority.
+   *
+   * @default ''
+   * @vegaVersion 2.97.0
+   */
+  name: string;
   /**
    * An array of custom validation rules applied to the numeric input in
    * addition to the built-in rules (`RequiredFieldRule`, `MinNumberRule`,

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

@@ -6,10 +6,12 @@ import { VegaInputPasscodeValueController } from './slimmers/controllers/vega-in
 import { EventEmitSlimmerBase } from '../../helpers/event-manager/slimmers/event-emit-slimmer';
 import { VegaInputPasscodeKeyboardController } from './slimmers/controllers/vega-input-passcode-keyboard-controller';
 import { ChildNodesEventPreventSlimmer } from '../../helpers/event-manager/slimmers/child-nodes-event-prevent-slimmer';
-import { FormFieldControllerSlimmer } from '../../helpers/slimmers/form-field-controller-slimmer';
+import { FormFieldControllerSlimmer } from '../../helpers/slimmers/form/form-field-controller-slimmer';
 import { FormFieldValidationRule } from '../../helpers/validator/rules/form-field-validation-rule';
 import { ImmutableArray } from '../../helpers/immutable/immutable-array';
 /**
+ * A multi-field input component for entering short numeric or alphanumeric passcodes. It renders a sequence of synchronized input fields that automatically advance focus and handle pasted codes intelligently.
+ *
  * @vegaVersion 2.66.0
  */
 export declare class VegaInputPasscode {
@@ -116,6 +118,14 @@ export declare class VegaInputPasscode {
    * @vegaVersion 2.88.0
    */
   optional: boolean;
+  /**
+   * Specifies the name attribute used to identify the form field during data submission.
+   *   It functions identically to the `data-vega-form` attribute but operates at a lower priority.
+   *
+   * @default ''
+   * @vegaVersion 2.97.0
+   */
+  name: string;
   /**
    * An array of custom validation rules applied to the passcode input in
    * addition to the built-in `RequiredFieldRule`. Each rule must implement

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

@@ -7,13 +7,15 @@ import { VegaInputPhoneNumberValueController } from './slimmers/controllers/vega
 import { FormFieldValidationRule } from '../../helpers/validator/rules/form-field-validation-rule';
 import { VegaComponentUsageRuntimeMetricsSlimmer } from '../../helpers/slimmers/component-usage-runtime-metrics';
 import { AriaAttributesValueMapper } from '../../helpers/slimmers/mutation-observer/aria-attributes-value-mapper';
-import { FormFieldControllerSlimmer } from '../../helpers/slimmers/form-field-controller-slimmer';
+import { FormFieldControllerSlimmer } from '../../helpers/slimmers/form/form-field-controller-slimmer';
 import { CountrySelectController } from './slimmers/controllers/country-select-controller';
 import { EventEmitSlimmerBase } from '../../helpers/event-manager/slimmers/event-emit-slimmer';
 import { ChildNodesEventPreventSlimmer } from '../../helpers/event-manager/slimmers/child-nodes-event-prevent-slimmer';
 import { VegaCountryCode } from '../../types/flag.type';
 import { VegaCountryType } from './types';
 /**
+ * The Phone Number Input allows users to enter a phone number and the option to select a country code.
+ *
  * @vegaVersion 2.18.0
  */
 export declare class VegaInputPhoneNumber {
@@ -70,6 +72,14 @@ export declare class VegaInputPhoneNumber {
    * @vegaVersion 2.88.0
    */
   optional: boolean;
+  /**
+   * Specifies the name attribute used to identify the form field during data submission.
+   *   It functions identically to the `data-vega-form` attribute but operates at a lower priority.
+   *
+   * @default ''
+   * @vegaVersion 2.97.0
+   */
+  name: string;
   /**
    * Specifies whether the phone number input field is disabled. When `true`,
    * both the country selector and the phone number text field become

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

@@ -3,7 +3,7 @@ import { FormFieldValidationRule } from '../../helpers/validator/rules/form-fiel
 import { GlobalSlimmers } from '../../vega-slimmer/vega-slimmer-core';
 import { VegaInputRangeRenderer } from './slimmers/renderers/vega-input-range-renderer';
 import { EventEmitSlimmerBase } from '../../helpers/event-manager/slimmers/event-emit-slimmer';
-import { FormFieldControllerSlimmer } from '../../helpers/slimmers/form-field-controller-slimmer';
+import { FormFieldControllerSlimmer } from '../../helpers/slimmers/form/form-field-controller-slimmer';
 import { InputRangeStackType, InputRangeValueType } from './types';
 import { VegaInputRangeValueController } from './slimmers/controllers/vega-input-range-value-controller';
 import { VegaInputRangeInputRenderer } from './slimmers/renderers/vega-input-range-input-renderer';
@@ -12,6 +12,8 @@ import { VegaInputRangeClearIconRenderer } from './slimmers/renderers/vega-input
 import { VegaComponentUsageRuntimeMetricsSlimmer } from '../../helpers/slimmers/component-usage-runtime-metrics';
 import { TranslationSlimmer } from '../../helpers/slimmers/translation';
 /**
+ * The Input Range component allows users to select a numerical range value.
+ *
  * @vegaVersion 2.2.0
  */
 export declare class VegaInputRange {
@@ -105,6 +107,14 @@ export declare class VegaInputRange {
    * @vegaVersion 2.89.0
    */
   optional: boolean;
+  /**
+   * Specifies the name attribute used to identify the form field during data submission.
+   *   It functions identically to the `data-vega-form` attribute but operates at a lower priority.
+   *
+   * @default ''
+   * @vegaVersion 2.97.0
+   */
+  name: string;
   /**
    * Indicates whether the current value in the field is considered valid
    *    based on the defined validation rules.

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

@@ -9,7 +9,7 @@ import { VegaInputSelectDropdownController } from './slimmers/controllers/vega-i
 import { VegaInputSelectValueController } from './slimmers/controllers/vega-input-select-value-controller';
 import { VegaInputSelectItemController } from './slimmers/controllers/vega-input-select-item-controller';
 import { VegaInputSelectDropdownRenderer } from './slimmers/renderers/vega-input-select-dropdown-renderer';
-import { FormFieldControllerSlimmer } from '../../helpers/slimmers/form-field-controller-slimmer';
+import { FormFieldControllerSlimmer } from '../../helpers/slimmers/form/form-field-controller-slimmer';
 import { PageResizeObserverSlimmer } from '../../helpers/slimmers/page-resize-observer-slimmer';
 import { EventEmitSlimmerBase } from '../../helpers/event-manager/slimmers/event-emit-slimmer';
 import { ChildNodesEventPreventSlimmer } from '../../helpers/event-manager/slimmers/child-nodes-event-prevent-slimmer';
@@ -23,6 +23,8 @@ import { VegaInputSelectPrefixIconRenderer } from './slimmers/renderers/vega-inp
 import { LabelSuffixButtonConfig } from '../vega-field-label/types';
 import { Nullable } from '../../types/general';
 /**
+ * The Select Menu allows users to choose a single item from a list of options.
+ *
  * @vegaVersion 1.0.7
  */
 export declare class VegaInputSelect {
@@ -88,6 +90,14 @@ export declare class VegaInputSelect {
    * @vegaVersion 2.89.0
    */
   optional: boolean;
+  /**
+   * Specifies the name attribute used to identify the form field during data submission.
+   *   It functions identically to the `data-vega-form` attribute but operates at a lower priority.
+   *
+   * @default ''
+   * @vegaVersion 2.97.0
+   */
+  name: string;
   /**
    * Allows customization of the text displayed within the
    *    select field when single or multiple items are selected.

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

@@ -5,6 +5,8 @@ import { GlobalSlimmers } from '../../vega-slimmer/vega-slimmer-core';
 import { DeprecatedPropertySlimmerBase } from '../../helpers/slimmers/deprecated-property-slimmer';
 import { VegaComponentUsageRuntimeMetricsSlimmer } from '../../helpers/slimmers/component-usage-runtime-metrics';
 /**
+ * The Item Toggle component allows users to toggle between on and off states of a binary value in a custom stylized manner.
+ *
  * @vegaVersion 1.0.5
  */
 export declare class VegaItemToggle {

package/dist/types/components/vega-loading-indicator/vega-loading-indicator.d.ts

@@ -5,6 +5,8 @@ import { GlobalSlimmers } from '../../vega-slimmer/vega-slimmer-core';
 import { PageResizeObserverSlimmer } from '../../helpers/slimmers/page-resize-observer-slimmer';
 import { VegaComponentUsageRuntimeMetricsSlimmer } from '../../helpers/slimmers/component-usage-runtime-metrics';
 /**
+ * A Loading Indicator informs users that data is loading and can display progress as data is loaded.
+ *
  * @vegaVersion 1.16.0
  */
 export declare class VegaLoadingIndicator {

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

@@ -20,6 +20,8 @@ import { VegaModalOpenState } from './slimmers/models/vega-modal-open-state';
 import { VegaModalSectionPaddingState } from './slimmers/models/vega-modal-section-padding-state';
 import { VegaModalPaddingStateController } from './slimmers/controllers/vega-modal-padding-state-controller';
 /**
+ * The Modal component presents users with a self-contained task that must either be completed or dismissed. It is shown as a window overlaid on top of a page, disabling the content underneath.
+ *
  * @vegaVersion 1.0.6
  */
 export declare class VegaModal {

package/dist/types/components/vega-nav/vega-left-nav/slimmers/controllers/vega-left-nav-backdrop-manager.d.ts

@@ -9,6 +9,13 @@ export declare class VegaLeftNavBackdropManager extends SharedBackdropManager {
   static readonly backdropClassName: string;
   openState: VegaLeftNav['openState'];
   showAsOverlay: VegaLeftNav['showAsOverlay'];
+  private effectiveShowAsOverlay;
+  /**
+   * Set the overlay value used by backdrop visibility decisions.
+   *
+   * @param {boolean} showAsOverlay - Resolved overlay value from the controller.
+   */
+  setEffectiveOverlayValue(showAsOverlay: boolean): void;
   /**
    * Watch openState changes and update visibility intent.
    *

package/dist/types/components/vega-nav/vega-left-nav/slimmers/controllers/vega-left-nav-open-state-controller.d.ts

@@ -11,6 +11,7 @@ export declare class VegaLeftNavOpenStateController extends PageResizeObserverSl
   backdropManager: VegaLeftNavBackdropManager;
   private isVoiceOverClick;
   private triggerElement;
+  private lastSyncedOverlayValue;
   /**
    * The below method is e2e-test covered in
    * @see{module:vega-left-nav-e2e-open-by-default}
@@ -18,6 +19,11 @@ export declare class VegaLeftNavOpenStateController extends PageResizeObserverSl
   componentDidLoad(): void;
   /**
    * Component lifecycle - [componentDidRender]
+   *
+   * Runs after the first render to ensure all props (especially from React/Next.js)
+   * are fully hydrated before evaluating overlay-driven backdrop visibility.
+   * This prevents race conditions where showAsOverlay might still hold its default
+   * value during componentDidLoad when React/Next.js applies props after initial render.
    */
   componentDidRender(): void;
   /**
@@ -35,6 +41,17 @@ export declare class VegaLeftNavOpenStateController extends PageResizeObserverSl
    * @see{module:vega-left-nav-e2e-vega-click-backdrop}
    */
   setOpenState(openState: LeftNavOpenStateType): void;
+  /**
+   * Check whether the show-as-overlay attribute has been explicitly hydrated by React/Next.js.
+   *
+   * Returns true only for recognized hydrated tokens ('false', 'true', '').
+   * Returns false when the attribute is absent or unrecognized.
+   *
+   * This DOM-read approach is resilient to SSR re-instantiation because it relies on
+   * current host attributes rather than instance-private hydration flags.
+   */
+  private hasHydratedOverlayValue;
+  private getResolvedOverlayValue;
   private handleClickEvent;
   /**
    * Focuses the first focusable element within the left nav dialog when it is opened via VoiceOver.

package/dist/types/components/vega-page-notification/vega-page-notification.d.ts

@@ -2,6 +2,8 @@ import { VegaPageNotificationActionButtonConfig, VegaPageNotificationTypes } fro
 import { GlobalSlimmers } from '../../vega-slimmer/vega-slimmer-core';
 import { VegaComponentUsageRuntimeMetricsSlimmer } from '../../helpers/slimmers/component-usage-runtime-metrics';
 /**
+ * A Page Notification is a brief message that appears in the top right corner of a page in response to an action or event.
+ *
  * @vegaVersion 1.17.0
  */
 export declare class VegaPageNotification {

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

@@ -12,6 +12,8 @@ import { VegaPaginationPageSizeObserverController } from './slimmers/controllers
 import { VegaPaginationCurrentPageObserverController } from './slimmers/controllers/vega-pagination-current-page-observer-controller';
 import { VegaPaginationLayoutController } from './slimmers/controllers/vega-pagination-layout-controller';
 /**
+ * The Pagination component allows users to navigate through multiple pages of content, providing a structured way to access large sets of data.
+ *
  * @vegaVersion 1.3.0
  */
 export declare class VegaPagination {

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

@@ -6,6 +6,8 @@ import { VegaPopoverAppenderRenderer } from './slimmers/renderers/vega-popover-a
 import { VegaPopoverAppenderController } from './slimmers/controllers/vega-popover-appender-controller';
 import { VegaComponentUsageRuntimeMetricsSlimmer } from '../../helpers/slimmers/component-usage-runtime-metrics';
 /**
+ * A Popover is an overlaid window that displays rich content, and is visually tethered to the element that triggers it.
+ *
  * @vegaVersion 1.19.0
  */
 export declare class VegaPopover {

package/dist/types/components/vega-progress-tracker/vega-progress-tracker.d.ts

@@ -13,6 +13,8 @@ import { VegaProgressTrackerCurrentStepsController } from './slimmers/controller
 import { VegaProgressTrackerRenderModeController } from './slimmers/controllers/vega-progress-tracker-render-mode-controller';
 import { VegaProgressTrackerCurrentDirectionController } from './slimmers/controllers/vega-progress-tracker-current-direction-controller';
 /**
+ * The Progress Tracker guides users through a sequential process towards completing a specific goal.
+ *
  * @vegaVersion 1.0.7
  */
 export declare class VegaProgressTracker {

package/dist/types/components/vega-radio/vega-radio-group/vega-radio-group.d.ts

@@ -1,5 +1,5 @@
 import { EventEmitter } from '../../../stencil-public-runtime';
-import { FormFieldControllerSlimmer } from '../../../helpers/slimmers/form-field-controller-slimmer';
+import { FormFieldControllerSlimmer } from '../../../helpers/slimmers/form/form-field-controller-slimmer';
 import { GlobalSlimmers } from '../../../vega-slimmer/vega-slimmer-core';
 import { ChildNodesNotifyObserverSlimmer } from '../../../helpers/event-manager/slimmers/child-nodes-notify-observer-slimmer';
 import { ChildNodesEventPreventSlimmer } from '../../../helpers/event-manager/slimmers/child-nodes-event-prevent-slimmer';
@@ -45,6 +45,10 @@ export declare class VegaRadioGroup {
    * Specifies the name attribute for each radio button
    *    in the radio group.
    *
+   * Specifies the name attribute used to identify the form field during data submission.
+   *   It functions identically to the `data-vega-form` attribute but operates at a lower priority.
+   *
+   * @default ''
    * @vegaVersion 1.3.0
    */
   name: string;

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

@@ -4,6 +4,8 @@ import { EventEmitSlimmerBase } from '../../helpers/event-manager/slimmers/event
 import { VegaRadioShowErrorController } from './slimmers/controllers/vega-radio-show-error-controller';
 import { VegaComponentUsageRuntimeMetricsSlimmer } from '../../helpers/slimmers/component-usage-runtime-metrics';
 /**
+ * A Radio Button is used within a Radio Button Group to display a set of mutually exclusive options, where only one choice can be selected at a time.
+ *
  * @vegaVersion 1.0.7
  */
 export declare class VegaRadio {

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

@@ -14,3 +14,6 @@ export declare const HTML_VOID_TAGS: Set<string>;
  * This value is based on the paragraph line-height and padding of text content.
  */
 export declare const VegaRTEOneRowHeightPx: number;
+export declare const RTE_DEFAULT_LINK_TYPE_KEY: string;
+export declare const RTE_EMAIL_LINK_TYPE_KEY: string;
+export declare const RTE_SUPPORTED_LINK_TYPE_KEYS: string[];

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

@@ -1,3 +1,20 @@
+/**
+ * Configurable options for the link extension.
+ */
+export declare type VegaRTELinkType = {
+  /**
+   * Unique key for the link type option.
+   */
+  key: string;
+  /**
+   * Display label in the link type selector.
+   */
+  label: string;
+  /**
+   * Optional default protocol used when this link type is selected.
+   */
+  defaultProtocol?: string;
+};
 /**
  * Configurable options for the link extension.
  */
@@ -12,4 +29,21 @@ export declare type VegaRTELinkExtensionConfig = {
    * - `/` + `about` => `/about`
    */
   defaultProtocol?: string;
+  /**
+   * Optional set of link types shown in the link editor.
+   *
+   * When omitted, link editor uses a single URL type.
+   *
+   * For the built-in `email` type, leaving the email display text blank causes the
+   * saved link text to fall back to the normalized `mailto:` URL.
+   */
+  linkTypes?: VegaRTELinkType[];
+};
+/**
+ * Parsed parts of a mailto: URL used by the email link editor.
+ */
+export declare type MailtoUrlParts = {
+  emailAddress: string;
+  subject: string;
+  body: string;
 };

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

@@ -18,6 +18,13 @@ export declare function createStyleMapFromElement(element: HTMLElement): Annotat
  * @returns {string[]} Array of individual CSS property strings.
  */
 export declare function splitStyleProperties(styleAttr: string): string[];
+/**
+ * Simple escape HTML-sensitive characters so text can be rendered literally in HTML. Only escape &, <, and >.
+ *
+ * @param {string} text - Raw text content.
+ * @returns {string} Escaped text content.
+ */
+export declare function simpleEscapeHtml(text: string): string;
 /**
  * Escape HTML-sensitive characters so text can be rendered literally in HTML.
  *

package/dist/types/components/vega-rich-text-editor/slimmers/controllers/helper/input-event-handler/base-handler.d.ts

@@ -3,7 +3,7 @@ import { VegaRTEContent } from '../../../../dto/content-state';
 import { RTENode } from '../../../../dto/nodes/node.abstract';
 import { SelectionController } from '../../selection-controller';
 /** This code snippet is defining an abstract class named `BaseHandler` with an abstract method `execute`. */
-export declare abstract class BaseHandler {
+export declare abstract class BaseHandler<TEvent extends Event = InputEvent> {
   protected currentState: VegaRTEContent;
   protected selectionController: SelectionController;
   protected richTextEditorRef: HTMLVegaRichTextEditorElement;
@@ -13,9 +13,9 @@ export declare abstract class BaseHandler {
    * @param {VegaRTEContent} currentState - The current state of the VegaRTE content.
    * @param {SelectionController} selectionController - Manages the selection of items in the user interface.
    * @param {HTMLElement} richTextEditor - The current rich text editor component
-   * @param {InputEvent} [event] - It is used to pass an input event to the method for handling.
+   * @param {Event} [event] - It is used to pass an input event to the method for handling.
    */
-  execute(currentState: VegaRTEContent, selectionController: SelectionController, richTextEditor: HTMLVegaRichTextEditorElement, event?: InputEvent): void;
+  execute(currentState: VegaRTEContent, selectionController: SelectionController, richTextEditor: HTMLVegaRichTextEditorElement, event?: TEvent): void;
   /**
    * The function `isRootContainer` checks if an HTML element is a root container with a class of 'rich-text-content'.
    *
@@ -57,5 +57,5 @@ export declare abstract class BaseHandler {
    * @param {HTMLElement} richTextEditor - The current rich text editor component
    */
   private setCurrentRichTextEditor;
-  abstract handleEvent(event?: InputEvent): void;
+  abstract handleEvent(event?: TEvent): void;
 }