@globalpayments/vega 2.95.0 → 2.97.0

package/dist/types/components/vega-backdrop/slimmers/controller/vega-backdrop-visible-controller.d.ts

@@ -7,6 +7,15 @@ export declare class VegaBackdropVisibleController extends VegaSlimmer {
   host: VegaBackdrop['host'];
   visible: VegaBackdrop['visible'];
   duration: VegaBackdrop['duration'];
+  private hasBeenVisible;
+  /**
+   * Clean up listeners when backdrop is disconnected.
+   */
+  disconnectedCallback(): void;
+  /**
+   * Set deterministic hidden defaults before first paint to avoid flash.
+   */
+  componentWillLoad(): void;
   /**
    * During the loading process of the component, the background style is updated.
    */
@@ -20,4 +29,16 @@ export declare class VegaBackdropVisibleController extends VegaSlimmer {
    * If visible is false, the backdrop will be hidden and backdrop display will be none after the duration.
    */
   private updateBackdropStyle;
+  /**
+   * Checks whether opacity transition is enabled on the backdrop element.
+   *
+   * @returns {boolean} True when opacity transitions are active.
+   */
+  private hasOpacityTransition;
+  /**
+   * Hides the backdrop display after opacity transition completes.
+   *
+   * @param {TransitionEvent} event - Browser transition event.
+   */
+  private handleOpacityTransitionEnd;
 }

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

@@ -1,6 +1,6 @@
 import { EventEmitter } from '../../../stencil-public-runtime';
 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 { ChildNodesNotifyObserverSlimmer } from '../../../helpers/event-manager/slimmers/child-nodes-notify-observer-slimmer';
 import { ChildNodesEventPreventSlimmer } from '../../../helpers/event-manager/slimmers/child-nodes-event-prevent-slimmer';
 import { EventEmitSlimmerBase } from '../../../helpers/event-manager/slimmers/event-emit-slimmer';
@@ -73,6 +73,14 @@ export declare class VegaCheckboxGroup {
    * @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;
   /**
    * Provides a supplementary prompt message that
    *    assists users in selecting the appropriate

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

@@ -1,6 +1,6 @@
 import { EventEmitter } from '../../stencil-public-runtime';
 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 { VegaCheckboxShowErrorController } from './slimmers/controllers/vega-checkbox-show-error-controller';
 import { VegaComponentUsageRuntimeMetricsSlimmer } from '../../helpers/slimmers/component-usage-runtime-metrics';
@@ -101,6 +101,14 @@ export declare class VegaCheckbox {
    * @vegaVersion 1.3.0
    */
   required: 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 of the checkbox component.
    *

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

@@ -1,6 +1,6 @@
 import { EventEmitter } from '../../stencil-public-runtime';
 import { FormFieldValidationRule } from '../../helpers/validator/rules/form-field-validation-rule';
-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 { EventEmitSlimmerBase } from '../../helpers/event-manager/slimmers/event-emit-slimmer';
 import { VegaComponentUsageRuntimeMetricsSlimmer } from '../../helpers/slimmers/component-usage-runtime-metrics';
@@ -53,6 +53,14 @@ export declare class VegaColorPicker {
    * @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 label or title for the color picker.
    *

package/dist/types/components/vega-color-swatch/vega-color-swatch-picker/vega-color-swatch-picker.d.ts

@@ -2,7 +2,7 @@ import { EventEmitter } from '../../../stencil-public-runtime';
 import { VegaComponentUsageRuntimeMetricsSlimmer } from '../../../helpers/slimmers/component-usage-runtime-metrics';
 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 { ColorSwatchPickerRenderer } from './slimmers/renderers/color-swatch-picker-renderer';
 import { EventEmitSlimmerBase } from '../../../helpers/event-manager/slimmers/event-emit-slimmer';
 import { ColorSwatchGridRenderer } from './slimmers/renderers/color-swatch-grid-renderer';
@@ -65,6 +65,14 @@ export declare class VegaColorSwatchPicker {
    * @vegaVersion 2.84.0
    */
   required: 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 of the color swatch picker.
    *

package/dist/types/components/vega-combo-box/vega-combo-box.d.ts

@@ -5,7 +5,7 @@ import { VegaComboBoxSize, VegaDropdownPropsForComboBox } from './types';
 import { MaxHeightType, ResponsiveType } from '../../types/ui.type';
 import { BreakpointsTokenType } from '../../types/design-token.type';
 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 { ChildNodesEventPreventSlimmer } from '../../helpers/event-manager/slimmers/child-nodes-event-prevent-slimmer';
 import { EventEmitSlimmerBase } from '../../helpers/event-manager/slimmers/event-emit-slimmer';
 import { VegaComponentUsageRuntimeMetricsSlimmer } from '../../helpers/slimmers/component-usage-runtime-metrics';
@@ -64,6 +64,14 @@ export declare class VegaComboBox {
    * @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 the source data used to populate the
    *    dropdown menu associated with the combo box.
@@ -208,19 +216,19 @@ export declare class VegaComboBox {
    */
   search: EventEmitter<string>;
   /**
-   * An event emitter notifying that the Select All option in the dropdown has been clicked.
+   * An event emitter only fired when the Select All checkbox in the dropdown has been clicked.
    *
-   * The event's `detail` property is `true` when all items become selected,
-   * and `false` when Select All is cleared.
+   * The event's `detail` property is `true` when the Select All checkbox is clicked to select all items,
+   *    and `false` when the Select All checkbox is clicked to clear all selected items.
    *
    * @vegaVersion 2.95.0
    */
   vegaDropdownSelectAllClick: EventEmitter<boolean>;
   /**
-   * An event emitter notifying that the Select All option in the dropdown has been clicked.
+   * An event emitter only fired when the Select All checkbox in the dropdown has been clicked.
    *
-   * The event's `detail` property is `true` when all items become selected,
-   * and `false` when Select All is cleared.
+   * The event's `detail` property is `true` when the Select All checkbox is clicked to select all items,
+   *    and `false` when the Select All checkbox is clicked to clear all selected items.
    *
    * @eventSemantics namespace:native
    * @vegaVersion 2.95.0

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

@@ -2,7 +2,7 @@ import { EventEmitter } from '../../stencil-public-runtime';
 import { FormFieldValidationRule } from '../../helpers/validator/rules/form-field-validation-rule';
 import { DatePickerModeType, DatePickerMonthYearTypes, DatePickerValueType, DropdownConfigForDatePicker } 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 { VegaDatePickerRenderer } from './slimmers/renderers/vega-date-picker-renderer';
 import { VegaDatePickerSingleInputRenderer } from './slimmers/renderers/vega-date-picker-single-input-renderer';
 import { VegaDatePickerRangeInputRenderer } from './slimmers/renderers/vega-date-picker-range-input-renderer';
@@ -87,6 +87,14 @@ export declare class VegaDatePicker {
    * @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 of the date picker component.
    *

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

@@ -1,8 +1,8 @@
 /**
  * Detail payload emitted by `vegaDropdownSelectAllClick` / `dropdownSelectAllClick`.
  *
- * `true` means all selectable items are now selected.
- * `false` means Select All has been cleared.
+ * `true` means the Select All checkbox was clicked to select all items.
+ * `false` means the Select All checkbox was clicked to clear all selected items.
  */
 export type VegaDropdownSelectAllClickEventDetail = boolean;
 

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

@@ -281,10 +281,33 @@ export declare class VegaDropdown {
    */
   searchTriggerBy: VegaDropdownSearchTriggerByType;
   /**
-   * Determines whether the dropdown position is calculated relative to the screen.
+   * Determines whether the dropdown uses viewport-based positioning (`position: fixed`) or container-based positioning (`position: absolute`).
    *
-   * @VegaWarning - It will overrides the positionRelativeTo and matchContainerHeight properties, rendering them ineffective.
-   * 			    - Currently, when set to true, the position calculation may be inaccurate if the popover is placed inside a scrollable container within a shadowRoot (e.g., inside a vega-modal with scrollable content).
+   * **Technical Implementation:**
+   *
+   * - When `false` (default): The dropdown content box renders with `position: absolute` and its coordinates are calculated relative to the nearest positioned ancestor. Combined with `positionRelativeTo`, you can specify which ancestor to measure from, which ensures the menu scrolls together with that ancestor.
+   *
+   * - When `true`: The dropdown content box renders with `position: fixed` and its coordinates are calculated from the viewport. The menu is visually anchored to the trigger element via JavaScript and moves with it on scroll, even though it is not part of the document flow. `positionRelativeTo` has no effect in this mode.
+   *
+   * When to set `isScreenPosition` to `true`:
+   *
+   * - Dropdowns that need to break out of container constraints (non-Shadow-DOM only):
+   *    When you want the dropdown to appear outside its container's boundaries (e.g., to avoid being clipped by a parent's
+   *    `overflow: hidden` or small dimensions), viewport-based positioning allows it to render freely.
+   *    This only works for regular (non-Shadow-DOM) containers. Shadow DOM boundaries cannot be escaped with `position: fixed`.
+   *
+   * - Dropdowns in fixed or sticky positioned containers:
+   *    When the dropdown trigger is inside a fixed or sticky positioned container, viewport-based positioning ensures correct alignment.
+   *
+   * When to keep `isScreenPosition` as `false` (default):
+   *
+   * - Simple layouts where the dropdown and its trigger are not inside scrollable containers
+   * - When you want the dropdown to scroll naturally with its container (using `position: absolute`)
+   * - When you need `positionRelativeTo` to control which ancestor the dropdown is positioned relative to
+   * - When `matchContainerHeight` is needed (this property is overridden when `isScreenPosition` is `true`)
+   *
+   * @VegaWarning - Setting this to `true` override the `positionRelativeTo` and `matchContainerHeight` properties, rendering them ineffective.
+   * 			    - Currently, when set to `true`, the position calculation may be inaccurate if the popover is placed inside a scrollable container within a shadowRoot (e.g., inside a vega-modal with scrollable content).
    * @vegaVersion 2.36.0
    */
   isScreenPosition: boolean;
@@ -341,19 +364,19 @@ export declare class VegaDropdown {
    */
   dropdownClick: EventEmitter<string>;
   /**
-   * An event emitter notifying that the Select All option has been clicked.
+   * An event emitter only fired when the Select All checkbox has been clicked.
    *
-   * The event's `detail` property is `true` when all items become selected,
-   * and `false` when Select All is cleared.
+   * The event's `detail` property is `true` when the Select All checkbox is clicked to select all items,
+   *    and `false` when the Select All checkbox is clicked to clear all selected items.
    *
    * @vegaVersion 2.93.0
    */
   vegaDropdownSelectAllClick: EventEmitter<boolean>;
   /**
-   * An event emitter notifying that the Select All option has been clicked.
+   * An event emitter only fired when the Select All checkbox has been clicked.
    *
-   * The event's `detail` property is `true` when all items become selected,
-   * and `false` when Select All is cleared.
+   * The event's `detail` property is `true` when the Select All checkbox is clicked to select all items,
+   *    and `false` when the Select All checkbox is clicked to clear all selected items.
    * @eventSemantics namespace:native
    * @vegaVersion 2.93.0
    */

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

@@ -9,7 +9,7 @@ import { VegaFileUploaderFileStatusRenderer } from './slimmers/renderers/vega-fi
 import { EventEmitSlimmerBase } from '../../helpers/event-manager/slimmers/event-emit-slimmer';
 import { VegaFileUploaderValueController } from './slimmers/controllers/vega-file-uploader-value-controller';
 import { FormFieldValidationRule } from '../../helpers/validator/rules/form-field-validation-rule';
-import { FormFieldControllerSlimmer } from '../../helpers/slimmers/form-field-controller-slimmer';
+import { FormFieldControllerSlimmer } from '../../helpers/slimmers/form/form-field-controller-slimmer';
 import { DropFileAcceptFilterSlimmer } from '../../helpers/slimmers/drop-file-accept-filter-slimmer';
 import { TranslationSlimmer } from '../../helpers/slimmers/translation';
 import { VegaFileUploaderFileLimitController } from './slimmers/controllers/vega-file-uploader-file-limit-controller';
@@ -103,6 +103,14 @@ export declare class VegaFileUploader {
    * @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;
   /**
    * Defines custom validation rules for the File Uploader field.
    *

package/dist/types/components/vega-form/slimmers/controllers/vega-form-field-controller.d.ts

@@ -58,10 +58,11 @@ export declare class VegaFormFieldController extends VegaSlimmer {
    */
   setIsTouched(isTouched: boolean): void;
   /**
-   * It returns the value of data-vega-form that the given element is associated with.
+   * It returns the form field key that the given element is associated with.
+   * Returns the value of data-vega-form if present, otherwise returns the value of the name attribute.
    *
    * @param {HTMLElement} element - The element that is being validated.
-   * @returns {string} The name of the field.
+   * @returns {string} The form field key.
    */
   getFormFieldName(element: HTMLElement): string;
   /**

package/dist/types/components/vega-form/slimmers/renderers/native-form-renderer.d.ts

@@ -6,6 +6,7 @@ import { VegaForm } from '../../vega-form';
 export declare class NativeFormRenderer extends VegaSlimmer {
   method: VegaForm['method'];
   action: VegaForm['action'];
+  name: VegaForm['name'];
   private nativeFormRef;
   getNativeFormRef(): HTMLFormElement;
   render(): HTMLFormElement;

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

@@ -99,6 +99,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-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';
@@ -112,6 +112,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/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';
@@ -157,7 +157,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,7 +1,7 @@
 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';
@@ -35,6 +35,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,7 +7,7 @@ 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';
 /**
  * @vegaVersion 2.29.0
@@ -175,6 +175,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,7 +6,7 @@ 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';
 /**
@@ -116,6 +116,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,7 +7,7 @@ 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';
@@ -70,6 +70,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';
@@ -105,6 +105,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';
@@ -88,6 +88,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.
@@ -269,19 +277,19 @@ export declare class VegaInputSelect {
    */
   searchTrigger: EventEmitter<VegaDropdownSearchTriggerEventDetail>;
   /**
-   * An event emitter notifying that the Select All option in the dropdown has been clicked.
+   * An event emitter only fired when the Select All checkbox in the dropdown has been clicked.
    *
-   * The event's `detail` property is `true` when all items become selected,
-   * and `false` when Select All is cleared.
+   * The event's `detail` property is `true` when the Select All checkbox is clicked to select all items,
+   *    and `false` when the Select All checkbox is clicked to clear all selected items.
    *
    * @vegaVersion 2.95.0
    */
   vegaDropdownSelectAllClick: EventEmitter<boolean>;
   /**
-   * An event emitter notifying that the Select All option in the dropdown has been clicked.
+   * An event emitter only fired when the Select All checkbox in the dropdown has been clicked.
    *
-   * The event's `detail` property is `true` when all items become selected,
-   * and `false` when Select All is cleared.
+   * The event's `detail` property is `true` when the Select All checkbox is clicked to select all items,
+   *    and `false` when the Select All checkbox is clicked to clear all selected items.
    *
    * @eventSemantics namespace:native
    * @vegaVersion 2.95.0

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.