@globalpayments/vega 2.87.0 → 2.89.0

package/dist/types/components/vega-accordion/slimmers/vega-accordion-renderer.d.ts

@@ -4,6 +4,7 @@ export declare class VegaAccordionRenderer extends VegaSlimmer {
   drawsBackground: VegaAccordion['drawsBackground'];
   prefixIcon: VegaAccordion['prefixIcon'];
   accordionTitle: VegaAccordion['accordionTitle'];
+  titleBackgroundColor: VegaAccordion['titleBackgroundColor'];
   expandIconAlign: VegaAccordion['expandIconAlign'];
   expand: VegaAccordion['expand'];
   iconPosition: VegaAccordion['iconPosition'];

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

@@ -1,6 +1,7 @@
 import { EventEmitter } from '../../stencil-public-runtime';
 import { GlobalSlimmers } from '../../vega-slimmer/vega-slimmer-core';
 import { ResponsiveType } from '../../types/ui.type';
+import { BackgroundColorsTokenType } from '../../types/design-token.type';
 import { VegaAccordionRenderer } from './slimmers/vega-accordion-renderer';
 import { VegaAccordionExpandController } from './slimmers/vega-accordion-expand-controller';
 import { EventEmitSlimmerBase } from '../../helpers/event-manager/slimmers/event-emit-slimmer';
@@ -42,6 +43,19 @@ export declare class VegaAccordion {
    * @vegaVersion 1.3.0
    */
   accordionTitle: string;
+  /**
+   * Specifies the background color of the accordion header row
+   *    (prefix icon, title and expand icon).
+   *
+   * When unset, the header has no background of its own.
+   *
+   * @VegaWarning Note: To ensure sufficient visual contrast and maintain accessibility standards,
+   *    avoid choosing a background color that closely matches the expand icon color
+   *    (such as `bg-action`), as it may make the icon difficult to perceive.
+   *
+   * @vegaVersion 2.88.0
+   */
+  titleBackgroundColor: BackgroundColorsTokenType;
   /**
    * Specifies the placement of the expand icon in the accordion.
    *

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

@@ -14,12 +14,15 @@ export declare class VegaCheckboxGroup {
   protected readonly globalSlimmers: GlobalSlimmers;
   protected readonly formFieldController: FormFieldControllerSlimmer<string[]>;
   protected checkboxValueChangeObserver: ChildNodesNotifyObserverSlimmer<boolean>;
+  protected checkboxUserInteractionObserver: ChildNodesNotifyObserverSlimmer<boolean>;
   protected checkboxEventPrevent: ChildNodesEventPreventSlimmer;
   protected changeEventEmitter: EventEmitSlimmerBase;
+  protected userChangeEventEmitter: EventEmitSlimmerBase;
   protected vegaComponentUsageRuntimeMetricsSlimmer: VegaComponentUsageRuntimeMetricsSlimmer<HTMLVegaCheckboxGroupElement>;
   private vegaFlexElement;
   private inputContainerRef;
   private vegaCheckboxArray;
+  private userInteractionPending;
   host: HTMLVegaCheckboxGroupElement;
   /**
    * Specifies the label or title for the checkbox group.
@@ -36,7 +39,7 @@ export declare class VegaCheckboxGroup {
    * @vegaVersion 1.0.7
    */
   value: string[];
-  watchValue(): Promise<void>;
+  watchValue(newValue: string[], oldValue: string[]): Promise<void>;
   /**
    * Specifies all properties of a `vega-flex` component,
    *    accessible as an object.
@@ -96,6 +99,33 @@ export declare class VegaCheckboxGroup {
    * @vegaVersion 1.0.10
    */
   vegaChange: EventEmitter<string[]>;
+  /** An event emitter notifying changes in the value of the checkbox group
+   *    triggered exclusively by user interaction (mouse click or keyboard
+   *    activation) on a nested checkbox.
+   *
+   * Unlike `vegaChange`, this event does NOT fire when the `value` prop
+   *    is reassigned programmatically. Use this event when you want to
+   *    react only to real user input (e.g., analytics, derived
+   *    "select all" state).
+   *
+   * @remarks Calling `event.preventDefault()` is a no-op — it does not roll
+   *    back `value` nor suppress the paired `vegaChange` event.
+   *    `cancelable: true` is retained only for parity with `vegaChange`.
+   *
+   * @see{module:vega-checkbox-group-user-change}
+   * @see{module:vega-checkbox-group-user-change-programmatic}
+   * @see{module:vega-checkbox-group-user-change-no-double}
+   * @vegaVersion 2.89.0
+   */
+  vegaUserChange: EventEmitter<string[]>;
+  /** An event emitter notifying changes in the value
+   *    of any nested checkbox within the checkbox group,
+   *    triggered exclusively by user interaction (mouse click or keyboard activation).
+   *
+   * @eventSemantics namespace:native
+   * @vegaVersion 2.89.0
+   */
+  userChange: EventEmitter<string[]>;
   /** An event emitter notifying changes in the value
    *    of any nested checkbox within the checkbox group,
    *    whether triggered programmatically or through
@@ -106,6 +136,16 @@ export declare class VegaCheckboxGroup {
    */
   change: EventEmitter<string[]>;
   componentDidLoad(): void;
+  /**
+   * Check the value prop to avoid unnecessary updates when the new value
+   * is element-wise equal to the old value (same elements, different array reference).
+   *
+   * @param {unknown} newValue - The new prop value.
+   * @param {unknown} oldValue - The old prop value.
+   * @param {string} name - The property name.
+   * @returns {boolean} Return false to skip the current update flow.
+   */
+  componentShouldUpdate(newValue: unknown, oldValue: unknown, name: string): boolean;
   /**
    * The below method is e2e-test covered in
    * @see{module:vega-checkbox-group-dark-change-background-color }

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

@@ -15,12 +15,15 @@ export declare class VegaCheckbox {
   protected ariaAttributesValueMapper: AriaAttributesValueMapper;
   protected readonly formFieldController: FormFieldControllerSlimmer<boolean | string>;
   protected changeEventEmitter: EventEmitSlimmerBase;
+  protected userChangeEventEmitter: EventEmitSlimmerBase;
   protected dropdownEventPrevent: ChildNodesEventPreventSlimmer;
   protected vegaComponentUsageRuntimeMetricsSlimmer: VegaComponentUsageRuntimeMetricsSlimmer<HTMLVegaCheckboxElement>;
   private labelElement;
   private inputContainerRef;
   private inputRef;
   private groupDisabledObserver;
+  private labelClickPending;
+  private isUserInteraction;
   host: HTMLVegaCheckboxElement;
   /**
    * Indicates whether the parent checkbox group is disabled.
@@ -111,6 +114,34 @@ export declare class VegaCheckbox {
    * @vegaVersion 1.0.10
    */
   vegaChange: EventEmitter<string | boolean>;
+  /**
+   * An event emitter notifying changes in the value of the checkbox
+   *    triggered exclusively by user interaction (mouse click or keyboard activation).
+   *
+   * Unlike `vegaChange`, this event does NOT fire when the `checked` or `value`
+   *    prop is reassigned programmatically. Use this event when you want to react
+   *    only to real user input (e.g., analytics, derived "select all" state).
+   *
+   * @remarks Calling `event.preventDefault()` is a no-op — it does not roll
+   *    back `checked`/`value` nor suppress the paired `vegaChange` event.
+   *    `cancelable: true` is retained only for parity with `vegaChange`.
+   *
+   * @see{module:vega-checkbox-user-change}
+   * @see{module:vega-checkbox-user-change-keyboard}
+   * @see{module:vega-checkbox-user-change-keyboard-enter}
+   * @see{module:vega-checkbox-user-change-programmatic}
+   * @see{module:vega-checkbox-user-change-containment}
+   * @vegaVersion 2.89.0
+   */
+  vegaUserChange: EventEmitter<string | boolean>;
+  /**
+   * An event emitter notifying changes in the value of the checkbox
+   *    triggered exclusively by user interaction (mouse click or keyboard activation).
+   *
+   * @eventSemantics namespace:native
+   * @vegaVersion 2.89.0
+   */
+  userChange: EventEmitter<string | boolean>;
   /**
    * An event emitter notifying changes in the value of the checkbox,
    *    whether triggered programmatically or through user interaction.
@@ -121,6 +152,16 @@ export declare class VegaCheckbox {
   change: EventEmitter<string | boolean>;
   disconnectedCallback(): void;
   componentWillLoad(): void;
+  /**
+   * Prevents redundant updates when the checked prop is set
+   *    to the same value (e.g., from parent re-renders in React).
+   *
+   * @param {unknown} newValue - The new prop value.
+   * @param {unknown} oldValue - The old prop value.
+   * @param {string} name - The property name.
+   * @returns {boolean} Return false to skip the current update flow.
+   */
+  componentShouldUpdate(newValue: unknown, oldValue: unknown, name: string): boolean;
   componentDidRender(): void;
   /**
    * Invoke this method to set the value of the checkbox.
@@ -174,5 +215,24 @@ export declare class VegaCheckbox {
    * This function unregister a group disabled observer if it exists.
    */
   private unRegisterGroupDisabledObserver;
+  private onInputKeyDown;
+  /**
+   * Suppresses the duplicate `click` event that bubbles to the host when the
+   *    browser performs the label's default activation behavior. Clicking the
+   *    label area dispatches one click on the label (which bubbles to the
+   *    host), and the browser then synthesizes a second click on the wrapped
+   *    `<input>`, which also bubbles through the label to the host — causing
+   *    the consumer's `onClick` to fire twice.
+   *
+   * We tag the original label-area click with `labelClickPending = true` and,
+   *    when the synthetic input click bubbles back through the label, call
+   *    `stopPropagation()` to prevent the duplicate from leaving the host.
+   *    The input still toggles natively (no `preventDefault`), so `change`
+   *    fires once and `vegaChange` is emitted exactly once via the normal
+   *    `@Watch('checked')` path. This avoids the spurious same-value emission
+   *    that an optimistic local toggle would cause in React controlled
+   *    components, where the parent re-renders the same `checked` value.
+   */
+  private onLabelClick;
   private onSelectedIconClick;
 }

package/dist/types/components/vega-code-block/vega-code-block.d.ts

@@ -62,6 +62,7 @@ export declare class VegaCodeBlock {
   /**
    * Specifies whether to display the copy button in the code block.
    *
+   * @VegaWarning Only has effect when `readOnly` is `true`.
    * @vegaVersion 2.50.0
    */
   showCopyButton: boolean;

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

@@ -43,6 +43,16 @@ export declare class VegaColorPicker {
    * @vegaVersion 1.13.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 the label or title for the color picker.
    *

package/dist/types/components/vega-combo-box/slimmers/renderers/vega-combo-box-dropdown-renderer.d.ts

@@ -8,6 +8,7 @@ export declare class VegaComboBoxDropdownRenderer extends VegaSlimmer {
   private source;
   private disabled;
   private size;
+  private containerMaxHeight;
   private vegaDropdownProps;
   private label;
   private placeholder;

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

@@ -2,6 +2,7 @@ import { VegaSlimmer } from '../../../../vega-slimmer/vega-slimmer-core';
 import { VegaComboBox } from '../../vega-combo-box';
 export declare class VegaComboBoxRenderer extends VegaSlimmer {
   private required;
+  private optional;
   private hint;
   private disabled;
   private dropdownRenderer;

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

@@ -2,6 +2,8 @@ import { EventEmitter } from '../../stencil-public-runtime';
 import { FormFieldValidationRule } from '../../helpers/validator/rules/form-field-validation-rule';
 import { DropdownSourceItem } from '../vega-dropdown/types';
 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 { ChildNodesEventPreventSlimmer } from '../../helpers/event-manager/slimmers/child-nodes-event-prevent-slimmer';
@@ -13,6 +15,7 @@ import { VegaComboBoxRenderer } from './slimmers/renderers/vega-combo-box-render
 import { VegaComboBoxKeyboardController } from './slimmers/controllers/vega-combo-box-keyboard-controller';
 import { VegaComboBoxItemsSlotController } from './slimmers/controllers/vega-combo-box-items-slot-controller';
 import { VegaComboBoxSourceController } from './slimmers/controllers/vega-combo-box-source-controller';
+import { PageResizeObserverSlimmer } from '../../helpers/slimmers/page-resize-observer-slimmer';
 /**
  * @vegaVersion 1.11.0
  */
@@ -24,6 +27,7 @@ export declare class VegaComboBox {
   protected sourceController: VegaComboBoxSourceController;
   protected renderer: VegaComboBoxRenderer;
   protected dropdownRenderer: VegaComboBoxDropdownRenderer;
+  protected readonly pageResizeSlimmer: PageResizeObserverSlimmer;
   protected readonly formFieldController: FormFieldControllerSlimmer<string[]>;
   protected changeEventEmit: EventEmitSlimmerBase;
   protected createEventEmit: EventEmitSlimmerBase;
@@ -31,6 +35,7 @@ export declare class VegaComboBox {
   protected dropdownEventPrevent: ChildNodesEventPreventSlimmer;
   protected vegaComponentUsageRuntimeMetricsSlimmer: VegaComponentUsageRuntimeMetricsSlimmer<HTMLVegaComboBoxElement>;
   host: HTMLVegaComboBoxElement;
+  currentBreakpoint: BreakpointsTokenType;
   /**
    * Specifies the label or title for the combo box.
    *
@@ -47,6 +52,16 @@ export declare class VegaComboBox {
    * @vegaVersion 1.11.0
    */
   required: boolean;
+  /**
+   * Indicates whether the field should be presented as optional.
+   *
+   * This property only takes effect when `required` is `false`.
+   * When `true`, an "optional" label is displayed next to the field label.
+   *
+   * @default false
+   * @vegaVersion 2.88.0
+   */
+  optional: boolean;
   /**
    * Specifies the source data used to populate the
    *    dropdown menu associated with the combo box.
@@ -112,6 +127,22 @@ export declare class VegaComboBox {
    * @vegaVersion 1.11.0
    */
   size: VegaComboBoxSize;
+  /**
+   * Specifies the maximum height of the combo box container,
+   *    including selected chips and input area.
+   *
+   * When set, vertical scrolling will be enabled once the
+   *    container content exceeds the configured height.
+   *
+   * Note: values smaller than the input minimum height (26px)
+   *    are floored to keep the input usable. Use
+   *    `vegaDropdownProps.maxHeight` to control the dropdown
+   *    menu height independently.
+   *
+   * @vegaVersion 2.89.0
+   */
+  containerMaxHeight: ResponsiveType<MaxHeightType>;
+  watchContainerMaxHeight(): void;
   /**
    * Specifies partial properties of the `vega-dropdown` component
    *    that are used to configure the dropdown menu

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

@@ -6,6 +6,7 @@ export declare class VegaDatePickerRenderer extends VegaSlimmer {
   mode: VegaDatePicker['mode'];
   label: VegaDatePicker['label'];
   required: VegaDatePicker['required'];
+  optional: VegaDatePicker['optional'];
   readOnly: VegaDatePicker['readOnly'];
   autoValidation: VegaDatePicker['autoValidation'];
   host: VegaDatePicker['host'];

package/dist/types/components/vega-date-picker/vega-date-picker-calendar/slimmers/controllers/vega-date-picker-calendar-size-controller.d.ts

@@ -0,0 +1,20 @@
+import { VegaDatePickerCalendar } from '../../vega-date-picker-calendar';
+import { PageResizeObserverSlimmer } from '../../../../../helpers/slimmers/page-resize-observer-slimmer';
+/**
+ * Controller for managing the size of the Vega date picker calendar.
+ */
+export declare class VegaDatePickerCalendarSizeController extends PageResizeObserverSlimmer {
+  protected size: VegaDatePickerCalendar['size'];
+  protected currentSize: VegaDatePickerCalendar['currentSize'];
+  constructor();
+  /**
+   * Updates the current size of the date picker calendar whenever the component is about to load or when the size prop changes.
+   */
+  protected updateCurrentSize(): void;
+  /**
+   * Returns the current size of the date picker calendar, formatted as a DatePickerCalendarSizeType.
+   *
+   * @returns {DatePickerCalendarSizeType} The current size of the date picker calendar.
+   */
+  private getCurrentSize;
+}

package/dist/types/components/vega-date-picker/vega-date-picker-calendar/slimmers/renderers/vega-date-picker-calendar-header-render.d.ts

@@ -7,9 +7,10 @@ export declare class VegaDatePickerCalendarHeaderRenderer extends VegaSlimmer {
   private currentPeriodController;
   private maxCalendarDate;
   private minCalendarDate;
-  private size;
+  private currentSize;
   private timezone;
   private isDualMonths;
+  private todayClickEventEmitter;
   render(): HTMLElement;
   private renderSwitcher;
   private renderPrevIcon;

package/dist/types/components/vega-date-picker/vega-date-picker-calendar/slimmers/renderers/vega-date-picker-calendar-year-month-switcher-renderer.d.ts

@@ -10,7 +10,7 @@ export declare class VegaDatePickerCalendarYearMonthSwitcherRenderer extends Veg
   maxCalendarDate: VegaDatePickerCalendar['maxCalendarDate'];
   yearMonthDropdownProps: VegaDatePickerCalendar['yearMonthDropdownProps'];
   currentPeriod: VegaDatePickerCalendar['currentPeriod'];
-  size: VegaDatePickerCalendar['size'];
+  currentSize: VegaDatePickerCalendar['currentSize'];
   mode: VegaDatePickerCalendar['mode'];
   isDualMonths: VegaDatePickerCalendar['isDualMonths'];
   render(): HTMLElement;

package/dist/types/components/vega-date-picker/vega-date-picker-calendar/slimmers/renderers/vega-date-picker-month-item-renderer.d.ts

@@ -13,7 +13,6 @@ export declare class VegaDatePickerMonthItemRenderer extends VegaSlimmer {
   staticHeight: VegaDatePickerCalendar['staticHeight'];
   mode: VegaDatePickerCalendar['mode'];
   fillContainer: VegaDatePickerCalendar['fillContainer'];
-  size: VegaDatePickerCalendar['size'];
   isDualMonths: VegaDatePickerCalendar['isDualMonths'];
   isDateDisabled: VegaDatePickerCalendar['isDateDisabled'];
   dateIndicator: VegaDatePickerCalendar['dateIndicator'];

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

@@ -14,10 +14,12 @@ import { VegaDatePickerCalendarSelectionController } from './slimmers/controller
 import { Nullable } from '../../../types/general';
 import { VegaDatePickerCalendarMinMaxDateController } from './slimmers/controllers/vega-date-picker-calendar-min-max-date-controller';
 import { VegaDatePickerCalendarAllowRepickController } from './slimmers/controllers/vega-date-picker-calendar-allow-repick-controller';
+import { ResponsiveType } from '../../../types/ui.type';
 import { DisabledDate } from '../../vega-calendar/types';
 import { CalendarSelection } from './dto/calendar-selection';
 import { VegaDatePickerCalendarHeaderRenderer } from './slimmers/renderers/vega-date-picker-calendar-header-render';
 import { VegaDatePickerCalendarIsDualMonthsController } from './slimmers/controllers/vega-date-picker-calendar-is-dual-months-controller';
+import { VegaDatePickerCalendarSizeController } from './slimmers/controllers/vega-date-picker-calendar-size-controller';
 /**
  * @vegaVersion 2.0.0
  */
@@ -35,10 +37,13 @@ export declare class VegaDatePickerCalendar {
   protected yearMonthSwitcherRender: VegaDatePickerCalendarYearMonthSwitcherRenderer;
   protected allowRepickController: VegaDatePickerCalendarAllowRepickController;
   protected vegaComponentUsageRuntimeMetricsSlimmer: VegaComponentUsageRuntimeMetricsSlimmer<HTMLVegaDatePickerCalendarElement>;
+  protected readonly calendarSizeController: VegaDatePickerCalendarSizeController;
   protected clearEventEmitter: EventEmitSlimmerBase;
   protected monthYearChangeEventEmitter: EventEmitSlimmerBase;
   protected vegaSelectionChangeEventEmitter: EventEmitSlimmerBase;
+  protected todayClickEventEmitter: EventEmitSlimmerBase;
   host: HTMLVegaDatePickerCalendarElement;
+  currentSize: DatePickerCalendarSizeType;
   isMobileDevice: boolean;
   today: CalendarDate;
   currentPeriod: MonthPeriod;
@@ -52,11 +57,13 @@ export declare class VegaDatePickerCalendar {
   watchMinCalendarDate(): void;
   isDualMonths: boolean;
   /**
-   * Renders the calendar picker in different sizes. Defaults to regular size
+   * Renders the calendar picker in different sizes. Defaults to regular size.
+   *    Responsive sizing is supported starting with version 2.88.0.
    *
    * @vegaVersion 2.72.0
    */
-  size: DatePickerCalendarSizeType;
+  size: ResponsiveType<DatePickerCalendarSizeType>;
+  watchSize(): void;
   /**
    * Specifies whether to allow the calendar picker to fill the width and height of its parent container.
    *    As default, the calendar picker has a max width and height limit based on the size and mode variant.
@@ -207,6 +214,19 @@ export declare class VegaDatePickerCalendar {
    * @vegaVersion 2.72.0
    */
   selectionChange: EventEmitter<string | string[]>;
+  /**
+   * An event emitter notifying the today button is clicked in the date picker.
+   *
+   * @vegaVersion 2.88.0
+   */
+  vegaTodayClick: EventEmitter<string>;
+  /**
+   * An event emitter notifying the today button is clicked in the date picker.
+   *
+   * @eventSemantics namespace:native
+   * @vegaVersion 2.88.0
+   */
+  todayClick: EventEmitter<string>;
   /**
    * Invoke this method to reset calendar to its initial state,
    * 	it include reset to current value and reset the current period.

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

@@ -77,6 +77,16 @@ export declare class VegaDatePicker {
    * @vegaVersion 1.3.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 the validation status of the date picker component.
    *

package/dist/types/components/vega-field-label/slimmers/renderers/vega-field-label-label-announcement-renderer.d.ts

@@ -0,0 +1,21 @@
+import { VegaSlimmer } from '../../../../vega-slimmer/vega-slimmer-core';
+import { Nullable } from '../../../../types/general';
+export declare class VegaFieldLabelLabelAnnouncementRenderer extends VegaSlimmer {
+  private label;
+  private isFieldRequired;
+  private optional;
+  private disabled;
+  private translationSlimmer;
+  /**
+   * Render a label announcement.
+   *
+   * @returns {Nullable<HTMLElement>}
+   */
+  render(): Nullable<HTMLElement>;
+  /**
+   * Generate a screen-reader-friendly announcement string that concatenates the label text with the field's required/optional and disabled states.
+   *
+   * @returns {string} The generated announcement string.
+   */
+  private generateAnnouncement;
+}

package/dist/types/components/vega-field-label/vega-field-label.d.ts

@@ -5,6 +5,8 @@ import { VegaComponentUsageRuntimeMetricsSlimmer } from '../../helpers/slimmers/
 import { LabelSuffixButtonConfig, LabelSuffixButtonProps } from './types';
 import { VegaFieldLabelSuffixElementRenderer } from './slimmers/renderers/vega-field-label-suffix-element-renderer';
 import { Nullable } from '../../types/general';
+import { TranslationSlimmer } from '../../helpers/slimmers/translation/translation-slimmer';
+import { VegaFieldLabelLabelAnnouncementRenderer } from './slimmers/renderers/vega-field-label-label-announcement-renderer';
 /**
  * @vegaVersion 1.10.0
  */
@@ -14,6 +16,8 @@ export declare class VegaFieldLabel {
   protected suffixButtonClickEventEmitter: EventEmitSlimmerBase;
   protected vegaComponentUsageRuntimeMetricsSlimmer: VegaComponentUsageRuntimeMetricsSlimmer<HTMLVegaFieldLabelElement>;
   protected suffixElementRenderer: VegaFieldLabelSuffixElementRenderer;
+  protected labelAnnouncementRenderer: VegaFieldLabelLabelAnnouncementRenderer;
+  protected translationSlimmer: TranslationSlimmer<HTMLVegaFieldLabelElement>;
   host: HTMLVegaFieldLabelElement;
   /**
    * @deprecated Please use `suffixButtonConfig` instead
@@ -58,6 +62,16 @@ export declare class VegaFieldLabel {
    * @vegaVersion 1.10.0
    */
   disabled: boolean;
+  /**
+   * Indicates whether the field should be presented as optional.
+   *
+   * This property only takes effect when `isFieldRequired` is `false`.
+   * When `true`, an "optional" label is displayed next to the field label.
+   *
+   * @default false
+   * @vegaVersion 2.88.0
+   */
+  optional: boolean;
   /**
    * An event emitter notifying that the field label has been clicked.
    *

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

@@ -3,6 +3,7 @@ import { VegaFileUploader } from '../../vega-file-uploader';
 /** renders a file uploader component with specified properties. */
 export declare class VegaFileUploaderRenderer extends VegaSlimmer {
   protected required: VegaFileUploader['required'];
+  protected optional: VegaFileUploader['optional'];
   protected disabled: VegaFileUploader['disabled'];
   protected label: VegaFileUploader['label'];
   protected hint: VegaFileUploader['hint'];

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

@@ -93,6 +93,16 @@ export declare class VegaFileUploader {
    * @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.88.0
+   */
+  optional: boolean;
   /**
    * Defines custom validation rules for the File Uploader field.
    *

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

@@ -12,6 +12,7 @@ export declare class VegaImageUploaderRenderer extends VegaSlimmer {
   status: VegaImageUploader['status'];
   label: VegaImageUploader['label'];
   required: VegaImageUploader['required'];
+  optional: VegaImageUploader['optional'];
   width: VegaImageUploader['width'];
   height: VegaImageUploader['height'];
   hint: VegaImageUploader['hint'];

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

@@ -102,6 +102,16 @@ export declare class VegaImageUploader {
    * @vegaVersion 1.14.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 the validation status.
    *

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

@@ -8,6 +8,7 @@ export declare class VegaInputRenderer extends VegaSlimmer {
   private hint;
   private labelSuffixButtonProps;
   private labelSuffixButtonConfig;
+  private optional;
   private labelButtonClickEventEmitter;
   private inputContainerRenderer;
   private inputSuggestionsRenderer;

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

@@ -254,6 +254,16 @@ export declare class VegaInput {
    * @vegaVersion 1.0.5
    */
   required: boolean;
+  /**
+   * Indicates whether the field should be presented as optional.
+   *
+   * This property only takes effect when `required` is `false`.
+   * When `true`, an "optional" label is displayed next to the field label.
+   *
+   * @default false
+   * @vegaVersion 2.88.0
+   */
+  optional: boolean;
   /**
    * Sets the minimum allowable numeric value for the input.
    *

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

@@ -7,6 +7,7 @@ export declare class VegaInputNumericRenderer extends VegaSlimmer {
   private disabled;
   private placeholder;
   private label;
+  private optional;
   private hint;
   private required;
   private thousandComma;

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

@@ -165,6 +165,16 @@ export declare class VegaInputNumeric {
    * @vegaVersion 2.29.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;
   /**
    * 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/slimmers/renderers/vega-input-passcode-renderer.d.ts

@@ -12,6 +12,7 @@ export declare class VegaInputPasscodeRenderer extends VegaSlimmer {
   protected inputType: VegaInputPasscode['inputType'];
   protected vegaInputValues: VegaInputPasscode['vegaInputValues'];
   protected valueController: VegaInputPasscode['valueController'];
+  protected optional: VegaInputPasscode['optional'];
   private vegaInputRefs;
   private currentIndex;
   private inputPasscodeContainerRef;