@globalpayments/vega 2.87.0 → 2.89.0

package/dist/collection/components/vega-combo-box/vega-combo-box.js

@@ -4,7 +4,7 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
   else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
-import { Component, Prop, Element, Method, Watch, Event } from '@stencil/core';
+import { Component, Prop, Element, Method, Watch, Event, State } from '@stencil/core';
 import { RequiredFieldRule } from '../../helpers/validator/rules/required-field-rule';
 import { sanitizeVegaComponent } from '../../utils/component';
 import { isArrayOfType, isDropdownSourceItemType } from '../../types/type-guard';
@@ -23,6 +23,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
  */
@@ -35,6 +36,7 @@ export class VegaComboBox {
     this.sourceController = new VegaComboBoxSourceController();
     this.renderer = new VegaComboBoxRenderer();
     this.dropdownRenderer = new VegaComboBoxDropdownRenderer();
+    this.pageResizeSlimmer = new PageResizeObserverSlimmer();
     this.formFieldController = new FormFieldControllerSlimmer({
       propertyRules: [
         {
@@ -73,6 +75,16 @@ export class VegaComboBox {
      * @vegaVersion 1.11.0
      */
     this.required = false;
+    /**
+     * 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
+     */
+    this.optional = false;
     /**
      * Specifies the source data used to populate the
      *    dropdown menu associated with the combo box.
@@ -172,6 +184,9 @@ export class VegaComboBox {
   watchValidationRules() {
     methodPlaceholder();
   }
+  watchContainerMaxHeight() {
+    methodPlaceholder();
+  }
   /**
    * Invoke this method to close the dropdown menu associated with the combo box.
    *
@@ -246,6 +261,30 @@ export class VegaComboBox {
       "reflect": true,
       "defaultValue": "false"
     },
+    "optional": {
+      "type": "boolean",
+      "mutable": false,
+      "complexType": {
+        "original": "boolean",
+        "resolved": "boolean",
+        "references": {}
+      },
+      "required": false,
+      "optional": false,
+      "docs": {
+        "tags": [{
+            "name": "default",
+            "text": "false"
+          }, {
+            "name": "vegaVersion",
+            "text": "2.88.0"
+          }],
+        "text": "Indicates whether the field should be presented as optional.\n\nThis property only takes effect when `required` is `false`.\nWhen `true`, an \"optional\" label is displayed next to the field label."
+      },
+      "attribute": "optional",
+      "reflect": true,
+      "defaultValue": "false"
+    },
     "source": {
       "type": "unknown",
       "mutable": true,
@@ -444,6 +483,35 @@ export class VegaComboBox {
       "reflect": false,
       "defaultValue": "'medium'"
     },
+    "containerMaxHeight": {
+      "type": "any",
+      "mutable": false,
+      "complexType": {
+        "original": "ResponsiveType<MaxHeightType>",
+        "resolved": "number | string | { S?: MaxHeightType; M?: MaxHeightType; L?: MaxHeightType; XL?: MaxHeightType; default?: MaxHeightType; }",
+        "references": {
+          "ResponsiveType": {
+            "location": "import",
+            "path": "../../types/ui.type"
+          },
+          "MaxHeightType": {
+            "location": "import",
+            "path": "../../types/ui.type"
+          }
+        }
+      },
+      "required": false,
+      "optional": false,
+      "docs": {
+        "tags": [{
+            "name": "vegaVersion",
+            "text": "2.89.0"
+          }],
+        "text": "Specifies the maximum height of the combo box container,\n   including selected chips and input area.\n\nWhen set, vertical scrolling will be enabled once the\n   container content exceeds the configured height.\n\nNote: values smaller than the input minimum height (26px)\n   are floored to keep the input usable. Use\n   `vegaDropdownProps.maxHeight` to control the dropdown\n   menu height independently."
+      },
+      "attribute": "container-max-height",
+      "reflect": true
+    },
     "vegaDropdownProps": {
       "type": "unknown",
       "mutable": false,
@@ -490,6 +558,9 @@ export class VegaComboBox {
       "defaultValue": "true"
     }
   }; }
+  static get states() { return {
+    "currentBreakpoint": {}
+  }; }
   static get events() { return [{
       "method": "vegaChange",
       "name": "vegaChange",
@@ -658,6 +729,9 @@ export class VegaComboBox {
     }, {
       "propName": "validationRules",
       "methodName": "watchValidationRules"
+    }, {
+      "propName": "containerMaxHeight",
+      "methodName": "watchContainerMaxHeight"
     }]; }
 }
 __decorate([
@@ -681,6 +755,9 @@ __decorate([
 __decorate([
   InjectVegaSlimmer()
 ], VegaComboBox.prototype, "dropdownRenderer", void 0);
+__decorate([
+  InjectVegaSlimmer()
+], VegaComboBox.prototype, "pageResizeSlimmer", void 0);
 __decorate([
   InjectVegaSlimmer()
 ], VegaComboBox.prototype, "formFieldController", void 0);

package/dist/collection/components/vega-date-picker/slimmers/renderers/vega-date-picker-renderer.js

@@ -38,7 +38,7 @@ export class VegaDatePickerRenderer extends VegaSlimmer {
           DomNodeSubjectObserverFactory.addUniqueObserverToNode(e, VegaClick, async () => {
             await this.focusInput();
           });
-        }, isFieldRequired: this.required, disabled: this.disabled, label: this.label })));
+        }, isFieldRequired: this.required, disabled: this.disabled, optional: this.optional, label: this.label })));
     };
     /**
      * The below method is e2e-test covered in
@@ -90,6 +90,9 @@ __decorate([
 __decorate([
   MapToComponentField()
 ], VegaDatePickerRenderer.prototype, "required", void 0);
+__decorate([
+  MapToComponentField()
+], VegaDatePickerRenderer.prototype, "optional", void 0);
 __decorate([
   MapToComponentField()
 ], VegaDatePickerRenderer.prototype, "readOnly", void 0);

package/dist/collection/components/vega-date-picker/vega-date-picker-calendar/slimmers/controllers/vega-date-picker-calendar-size-controller.js

@@ -0,0 +1,46 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+  var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+  if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+  else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+  return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { MapToComponentField, MapToComponentMethod } from 'vega-slimmer/core';
+import responsiveFormatFacade from '../../../../../helpers/formatter/responsive-map-formatter/responsive-format-facade';
+import { PageResizeObserverSlimmer } from '../../../../../helpers/slimmers/page-resize-observer-slimmer';
+/**
+ * Controller for managing the size of the Vega date picker calendar.
+ */
+export class VegaDatePickerCalendarSizeController extends PageResizeObserverSlimmer {
+  constructor() {
+    super({
+      // eslint-disable-next-line jsdoc/require-jsdoc
+      callback: () => {
+        this.currentSize = this.getCurrentSize();
+      },
+    });
+  }
+  /**
+   * Updates the current size of the date picker calendar whenever the component is about to load or when the size prop changes.
+   */
+  updateCurrentSize() {
+    this.currentSize = this.getCurrentSize();
+  }
+  /**
+   * Returns the current size of the date picker calendar, formatted as a DatePickerCalendarSizeType.
+   *
+   * @returns {DatePickerCalendarSizeType} The current size of the date picker calendar.
+   */
+  getCurrentSize() {
+    return responsiveFormatFacade.formatCustom(this.size);
+  }
+}
+__decorate([
+  MapToComponentField()
+], VegaDatePickerCalendarSizeController.prototype, "size", void 0);
+__decorate([
+  MapToComponentField({ writable: true })
+], VegaDatePickerCalendarSizeController.prototype, "currentSize", void 0);
+__decorate([
+  MapToComponentMethod('componentWillLoad'),
+  MapToComponentMethod('watchSize')
+], VegaDatePickerCalendarSizeController.prototype, "updateCurrentSize", null);

package/dist/collection/components/vega-date-picker/vega-date-picker-calendar/slimmers/renderers/vega-date-picker-calendar-header-render.js

@@ -51,18 +51,19 @@ export class VegaDatePickerCalendarHeaderRenderer extends VegaSlimmer {
       }, size: this.getNavigationIconSize(), iconColor: isDisabled ? 'text-disabled' : 'text-link', disabled: isDisabled }));
   }
   renderToday() {
-    const hasLabel = this.isDualMonths && this.size !== 'small';
+    const hasLabel = this.isDualMonths && this.currentSize !== 'small';
     return (h("vega-button-link", { class: {
         'button-today': true,
         'with-label': hasLabel,
       }, "data-aria-label": this.translationSlimmer.t('Today'), label: hasLabel ? this.translationSlimmer.t('Today') : '', ref: (ref) => {
         DomNodeSubjectObserverFactory.addUniqueObserverToNode(ref, VegaClick, () => {
           this.currentPeriodController.updateCalendarPeriod(new MonthPeriod(this.today, true, this.timezone));
+          this.todayClickEventEmitter.emit(this.today.toString());
         });
-      }, size: this.size === 'large' ? 'default' : 'small', icon: VegaInternalIconManager.getIconKey('bulls-eye') }));
+      }, size: this.currentSize === 'large' ? 'default' : 'small', icon: VegaInternalIconManager.getIconKey('bulls-eye') }));
   }
   getNavigationIconSize() {
-    if (this.size === 'large')
+    if (this.currentSize === 'large')
       return 'small';
     return 'extra-small';
   }
@@ -97,10 +98,13 @@ __decorate([
 ], VegaDatePickerCalendarHeaderRenderer.prototype, "minCalendarDate", void 0);
 __decorate([
   MapToComponentField()
-], VegaDatePickerCalendarHeaderRenderer.prototype, "size", void 0);
+], VegaDatePickerCalendarHeaderRenderer.prototype, "currentSize", void 0);
 __decorate([
   MapToComponentField()
 ], VegaDatePickerCalendarHeaderRenderer.prototype, "timezone", void 0);
 __decorate([
   MapToComponentField()
 ], VegaDatePickerCalendarHeaderRenderer.prototype, "isDualMonths", void 0);
+__decorate([
+  MapToComponentField()
+], VegaDatePickerCalendarHeaderRenderer.prototype, "todayClickEventEmitter", void 0);

package/dist/collection/components/vega-date-picker/vega-date-picker-calendar/slimmers/renderers/vega-date-picker-calendar-year-month-switcher-renderer.js

@@ -99,13 +99,13 @@ export class VegaDatePickerCalendarYearMonthSwitcherRenderer extends VegaSlimmer
   }
   renderCurrentMonth() {
     const label = this.translationSlimmer.t(this.currentPeriod.current.getMonthName());
-    return this.size === 'small' && this.showYearMonthDropdowns ? (h("vega-button-link", { class: "small-month-item-name", size: "small", label: label })) : (h("div", { class: "month-item-name", role: this.showYearMonthDropdowns ? 'button' : undefined, tabIndex: this.showYearMonthDropdowns ? 0 : undefined, "aria-label": this.showYearMonthDropdowns ? label : undefined, onKeyDown: this.showYearMonthDropdowns ? createEnterKeyHandlerToTriggerClick() : undefined },
+    return this.currentSize === 'small' && this.showYearMonthDropdowns ? (h("vega-button-link", { class: "small-month-item-name", size: "small", label: label })) : (h("div", { class: "month-item-name", role: this.showYearMonthDropdowns ? 'button' : undefined, tabIndex: this.showYearMonthDropdowns ? 0 : undefined, "aria-label": this.showYearMonthDropdowns ? label : undefined, onKeyDown: this.showYearMonthDropdowns ? createEnterKeyHandlerToTriggerClick() : undefined },
       h("span", null, label),
       this.renderDropdownSwitchIcon()));
   }
   renderCurrentYear() {
     const label = this.currentPeriod.current.year.toString();
-    return this.size === 'small' && this.showYearMonthDropdowns ? (h("vega-button-link", { class: "small-month-item-year", size: "small", label: label })) : (h("div", { class: "month-item-year", role: this.showYearMonthDropdowns ? 'button' : undefined, tabIndex: this.showYearMonthDropdowns ? 0 : undefined, "aria-label": this.showYearMonthDropdowns ? label : undefined, onKeyDown: this.showYearMonthDropdowns ? createEnterKeyHandlerToTriggerClick() : undefined },
+    return this.currentSize === 'small' && this.showYearMonthDropdowns ? (h("vega-button-link", { class: "small-month-item-year", size: "small", label: label })) : (h("div", { class: "month-item-year", role: this.showYearMonthDropdowns ? 'button' : undefined, tabIndex: this.showYearMonthDropdowns ? 0 : undefined, "aria-label": this.showYearMonthDropdowns ? label : undefined, onKeyDown: this.showYearMonthDropdowns ? createEnterKeyHandlerToTriggerClick() : undefined },
       h("span", null, label),
       this.renderDropdownSwitchIcon()));
   }
@@ -156,7 +156,7 @@ __decorate([
 ], VegaDatePickerCalendarYearMonthSwitcherRenderer.prototype, "currentPeriod", void 0);
 __decorate([
   MapToComponentField()
-], VegaDatePickerCalendarYearMonthSwitcherRenderer.prototype, "size", void 0);
+], VegaDatePickerCalendarYearMonthSwitcherRenderer.prototype, "currentSize", void 0);
 __decorate([
   MapToComponentField()
 ], VegaDatePickerCalendarYearMonthSwitcherRenderer.prototype, "mode", void 0);

package/dist/collection/components/vega-date-picker/vega-date-picker-calendar/slimmers/renderers/vega-date-picker-month-item-renderer.js

@@ -127,9 +127,6 @@ __decorate([
 __decorate([
   MapToComponentField()
 ], VegaDatePickerMonthItemRenderer.prototype, "fillContainer", void 0);
-__decorate([
-  MapToComponentField()
-], VegaDatePickerMonthItemRenderer.prototype, "size", void 0);
 __decorate([
   MapToComponentField()
 ], VegaDatePickerMonthItemRenderer.prototype, "isDualMonths", void 0);

package/dist/collection/components/vega-date-picker/vega-date-picker-calendar/vega-date-picker-calendar.js

@@ -14,7 +14,7 @@ import { VegaDatePickerCalendarCurrentPeriodController } from './slimmers/contro
 import { VegaDatePickerCalendarTodayController } from './slimmers/controllers/vega-date-picker-calendar-today-controller';
 import { sanitizeVegaComponent } from '../../../utils/component';
 import { VegaDatePickerMonthItemRenderer } from './slimmers/renderers/vega-date-picker-month-item-renderer';
-import { VegaClear, VegaMonthYearChange, VegaSelectionChange, } from '../../../helpers/event-manager/event-id/vega-event-id';
+import { VegaClear, VegaMonthYearChange, VegaSelectionChange, VegaTodayClick, } from '../../../helpers/event-manager/event-id/vega-event-id';
 import { createEventEmitSlimmer, } from '../../../helpers/event-manager/slimmers/event-emit-slimmer';
 import { VegaDatePickerCalendarSelectionController } from './slimmers/controllers/vega-date-picker-calendar-selection-controller';
 import { VegaDatePickerCalendarMinMaxDateController } from './slimmers/controllers/vega-date-picker-calendar-min-max-date-controller';
@@ -23,6 +23,7 @@ import { DeviceType } from '../../../types/ui.type';
 import { getDeviceType } from '../../../utils/ui';
 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
  */
@@ -41,12 +42,16 @@ export class VegaDatePickerCalendar {
     this.yearMonthSwitcherRender = new VegaDatePickerCalendarYearMonthSwitcherRenderer();
     this.allowRepickController = new VegaDatePickerCalendarAllowRepickController();
     this.vegaComponentUsageRuntimeMetricsSlimmer = new VegaComponentUsageRuntimeMetricsSlimmer();
+    this.calendarSizeController = new VegaDatePickerCalendarSizeController();
     this.clearEventEmitter = createEventEmitSlimmer(VegaDatePickerCalendar, VegaClear);
     this.monthYearChangeEventEmitter = createEventEmitSlimmer(VegaDatePickerCalendar, VegaMonthYearChange);
     this.vegaSelectionChangeEventEmitter = createEventEmitSlimmer(VegaDatePickerCalendar, VegaSelectionChange);
+    this.todayClickEventEmitter = createEventEmitSlimmer(VegaDatePickerCalendar, VegaTodayClick);
+    this.currentSize = 'regular';
     this.isMobileDevice = getDeviceType() === DeviceType.MOBILE;
     /**
-     * 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
      */
@@ -140,6 +145,9 @@ export class VegaDatePickerCalendar {
   watchMinCalendarDate() {
     methodPlaceholder();
   }
+  watchSize() {
+    methodPlaceholder();
+  }
   watchMode() {
     methodPlaceholder();
   }
@@ -176,7 +184,7 @@ export class VegaDatePickerCalendar {
   }
   render() {
     return sanitizeVegaComponent(h(Host, { class: {
-        [this.size]: true,
+        [this.currentSize]: true,
         [this.mode]: true,
         'fill-container': this.fillContainer,
         'mobile': this.isMobileDevice,
@@ -196,9 +204,13 @@ export class VegaDatePickerCalendar {
       "type": "string",
       "mutable": false,
       "complexType": {
-        "original": "DatePickerCalendarSizeType",
-        "resolved": "\"large\" | \"regular\" | \"small\"",
+        "original": "ResponsiveType<DatePickerCalendarSizeType>",
+        "resolved": "\"large\" | \"regular\" | \"small\" | { S?: DatePickerCalendarSizeType; M?: DatePickerCalendarSizeType; L?: DatePickerCalendarSizeType; XL?: DatePickerCalendarSizeType; default?: DatePickerCalendarSizeType; }",
         "references": {
+          "ResponsiveType": {
+            "location": "import",
+            "path": "../../../types/ui.type"
+          },
           "DatePickerCalendarSizeType": {
             "location": "import",
             "path": "../types"
@@ -212,7 +224,7 @@ export class VegaDatePickerCalendar {
             "name": "vegaVersion",
             "text": "2.72.0"
           }],
-        "text": "Renders the calendar picker in different sizes. Defaults to regular size"
+        "text": "Renders the calendar picker in different sizes. Defaults to regular size.\n   Responsive sizing is supported starting with version 2.88.0."
       },
       "attribute": "size",
       "reflect": false,
@@ -539,6 +551,7 @@ export class VegaDatePickerCalendar {
     }
   }; }
   static get states() { return {
+    "currentSize": {},
     "isMobileDevice": {},
     "today": {},
     "currentPeriod": {},
@@ -675,6 +688,45 @@ export class VegaDatePickerCalendar {
         "resolved": "string | string[]",
         "references": {}
       }
+    }, {
+      "method": "vegaTodayClick",
+      "name": "vegaTodayClick",
+      "bubbles": true,
+      "cancelable": true,
+      "composed": true,
+      "docs": {
+        "tags": [{
+            "name": "vegaVersion",
+            "text": "2.88.0"
+          }],
+        "text": "An event emitter notifying the today button is clicked in the date picker."
+      },
+      "complexType": {
+        "original": "string",
+        "resolved": "string",
+        "references": {}
+      }
+    }, {
+      "method": "todayClick",
+      "name": "todayClick",
+      "bubbles": true,
+      "cancelable": true,
+      "composed": true,
+      "docs": {
+        "tags": [{
+            "name": "eventSemantics",
+            "text": "namespace:native"
+          }, {
+            "name": "vegaVersion",
+            "text": "2.88.0"
+          }],
+        "text": "An event emitter notifying the today button is clicked in the date picker."
+      },
+      "complexType": {
+        "original": "string",
+        "resolved": "string",
+        "references": {}
+      }
     }]; }
   static get methods() { return {
     "reset": {
@@ -736,6 +788,9 @@ export class VegaDatePickerCalendar {
     }, {
       "propName": "minCalendarDate",
       "methodName": "watchMinCalendarDate"
+    }, {
+      "propName": "size",
+      "methodName": "watchSize"
     }, {
       "propName": "mode",
       "methodName": "watchMode"
@@ -795,6 +850,9 @@ __decorate([
 __decorate([
   InjectVegaSlimmer()
 ], VegaDatePickerCalendar.prototype, "vegaComponentUsageRuntimeMetricsSlimmer", void 0);
+__decorate([
+  InjectVegaSlimmer()
+], VegaDatePickerCalendar.prototype, "calendarSizeController", void 0);
 __decorate([
   InjectVegaSlimmer()
 ], VegaDatePickerCalendar.prototype, "clearEventEmitter", void 0);
@@ -804,3 +862,6 @@ __decorate([
 __decorate([
   InjectVegaSlimmer()
 ], VegaDatePickerCalendar.prototype, "vegaSelectionChangeEventEmitter", void 0);
+__decorate([
+  InjectVegaSlimmer()
+], VegaDatePickerCalendar.prototype, "todayClickEventEmitter", void 0);

package/dist/collection/components/vega-date-picker/vega-date-picker.js

@@ -110,6 +110,16 @@ export class VegaDatePicker {
      * @vegaVersion 1.3.0
      */
     this.required = false;
+    /**
+     * 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
+     */
+    this.optional = false;
     /**
      * Specifies the validation status of the date picker component.
      *
@@ -390,6 +400,30 @@ export class VegaDatePicker {
       "reflect": true,
       "defaultValue": "false"
     },
+    "optional": {
+      "type": "boolean",
+      "mutable": false,
+      "complexType": {
+        "original": "boolean",
+        "resolved": "boolean",
+        "references": {}
+      },
+      "required": false,
+      "optional": false,
+      "docs": {
+        "tags": [{
+            "name": "default",
+            "text": "false"
+          }, {
+            "name": "vegaVersion",
+            "text": "2.89.0"
+          }],
+        "text": "Indicates whether the field should be presented as optional.\n\nThis property only takes effect when `required` is `false`.\nWhen `true`, an \"optional\" label is displayed next to the field label."
+      },
+      "attribute": "optional",
+      "reflect": true,
+      "defaultValue": "false"
+    },
     "isValid": {
       "type": "boolean",
       "mutable": true,

package/dist/collection/components/vega-field-label/slimmers/renderers/vega-field-label-label-announcement-renderer.js

@@ -0,0 +1,69 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+  var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+  if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+  else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+  return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { h } from '@stencil/core';
+import { VegaSlimmer, MapToComponentField } from 'vega-slimmer/core';
+/*
+ * Screen-reader-only announcement.
+ *
+ * VoiceOver cannot reliably derive the full field state from the
+ * visible label alone because:
+ *   - "Required" is represented visually by a decorative "*" — AT
+ *     users would hear the raw asterisk character, not a meaningful word.
+ *   - "Disabled" has no visible text marker at all.
+ *
+ * This span provides a single, predictable AT announcement that
+ * concatenates the label text with the plain-English states
+ * (e.g. "Email, Required, Disabled"), ensuring VoiceOver reads
+ * exactly what the user needs to know.
+ *
+ * The visible <label> below is hidden from AT (`aria-hidden="true"`)
+ * to prevent duplicate announcements and to stop VoiceOver from
+ * vocalising the decorative "*" as part of the label text.
+ */
+export class VegaFieldLabelLabelAnnouncementRenderer extends VegaSlimmer {
+  /**
+   * Render a label announcement.
+   *
+   * @returns {Nullable<HTMLElement>}
+   */
+  render() {
+    return this.label && h("span", { class: "aria-announcement" }, this.generateAnnouncement());
+  }
+  /**
+   * 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.
+   */
+  generateAnnouncement() {
+    let announcement = this.label;
+    if (this.isFieldRequired) {
+      announcement += `, ${this.translationSlimmer.t('Required')}`;
+    }
+    else if (this.optional) {
+      announcement += `, ${this.translationSlimmer.t('Optional')}`;
+    }
+    if (this.disabled) {
+      announcement += `, ${this.translationSlimmer.t('Disabled')}`;
+    }
+    return announcement;
+  }
+}
+__decorate([
+  MapToComponentField()
+], VegaFieldLabelLabelAnnouncementRenderer.prototype, "label", void 0);
+__decorate([
+  MapToComponentField()
+], VegaFieldLabelLabelAnnouncementRenderer.prototype, "isFieldRequired", void 0);
+__decorate([
+  MapToComponentField()
+], VegaFieldLabelLabelAnnouncementRenderer.prototype, "optional", void 0);
+__decorate([
+  MapToComponentField()
+], VegaFieldLabelLabelAnnouncementRenderer.prototype, "disabled", void 0);
+__decorate([
+  MapToComponentField()
+], VegaFieldLabelLabelAnnouncementRenderer.prototype, "translationSlimmer", void 0);

package/dist/collection/components/vega-field-label/vega-field-label.css

@@ -69,4 +69,53 @@ label:first-of-type {
   display: inline-block;
   margin-left: 4px;
   vertical-align: top;
+}
+
+.optional {
+  margin-left: 4px;
+  font-family: "Inter", sans-serif;
+  font-size: 16px;
+  font-weight: 500;
+  line-height: 22px;
+  letter-spacing: 0px;
+  color: rgba(var(--v-text-secondary, 107, 116, 125, 1));
+}
+@media screen and (min-width: 768px) and (max-width: 1023px) {
+  .optional {
+    font-family: "Inter", sans-serif;
+    font-size: 16px;
+    font-weight: 500;
+    line-height: 22px;
+    letter-spacing: 0px;
+  }
+}
+@media screen and (min-width: 1024px) and (max-width: 1439px) {
+  .optional {
+    font-family: "Inter", sans-serif;
+    font-size: 16px;
+    font-weight: 500;
+    line-height: 22px;
+    letter-spacing: 0px;
+  }
+}
+@media screen and (min-width: 1440px) and (max-width: 9999px) {
+  .optional {
+    font-family: "Inter", sans-serif;
+    font-size: 16px;
+    font-weight: 500;
+    line-height: 22px;
+    letter-spacing: 0px;
+  }
+}
+
+.aria-announcement {
+  position: absolute;
+  width: 1px;
+  height: 1px;
+  padding: 0;
+  margin: -1px;
+  overflow: hidden;
+  clip: rect(0, 0, 0, 0);
+  white-space: nowrap;
+  border: 0;
 }