@globalpayments/vega 2.89.0 → 2.91.0

package/dist/collection/components/vega-calendar/vega-calendar-period-switcher/vega-calendar-period-switcher.js

@@ -0,0 +1,309 @@
+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 { Component, h, Host, Prop, Element, Event, Watch } from '@stencil/core';
+import { Method, State } from '@stencil/core/internal';
+import { sanitizeVegaComponent } from '../../../utils/component';
+import { InjectVegaGlobalSlimmer, InjectVegaSlimmer, methodPlaceholder, } from 'vega-slimmer/core';
+import { VegaComponentUsageRuntimeMetricsSlimmer } from '../../../helpers/slimmers/component-usage-runtime-metrics';
+import { VegaChange } from '../../../helpers/event-manager/event-id/vega-event-id';
+import { getSystemTimezone } from '../../../helpers/calendar/utils';
+import { createEventEmitSlimmer, } from '../../../helpers/event-manager/slimmers/event-emit-slimmer';
+import { VegaCalendarPeriodCurrentPeriodController } from './slimmers/controllers/vega-calendar-period-current-period-controller';
+import { VegaCalendarPeriodRenderer } from './slimmers/renderers/vega-calendar-period-renderer';
+import { VegaCalendarPeriodStateController } from './slimmers/controllers/vega-calendar-period-state-controller';
+import { TranslationSlimmer } from '../../../helpers/slimmers/translation';
+/**
+ * @vegaVersion 2.91.0
+ */
+export class VegaCalendarPeriodSwitcher {
+  constructor() {
+    this.translationSlimmer = new TranslationSlimmer();
+    this.changeEventEmitter = createEventEmitSlimmer(VegaCalendarPeriodSwitcher, VegaChange);
+    this.globalSlimmer = {};
+    this.vegaComponentUsageRuntimeMetricsSlimmer = new VegaComponentUsageRuntimeMetricsSlimmer();
+    this.currentPeriodController = new VegaCalendarPeriodCurrentPeriodController();
+    this.stateController = new VegaCalendarPeriodStateController();
+    this.renderer = new VegaCalendarPeriodRenderer();
+    /**
+     * Specifies the current view mode of the calendar period switcher.
+     *
+     * @vegaVersion 2.91.0
+     */
+    /* eslint-disable-next-line @stencil/strict-mutable */
+    this.viewMode = 'month';
+    /**
+     * Specifies the IANA time zone or Etc/GMT±n format.
+     *  It accepts values such as "America/New_York" or "Etc/GMT+12".
+     *  If not set, the component defaults to the system's time zone.
+     *  For a complete list of IANA time zones, see Time Zone DB(https://timezonedb.com/time-zones).
+     *
+     * @vegaVersion 2.91.0
+     */
+    this.timezone = getSystemTimezone();
+    /**
+     * Determines whether weekends are displayed in the calendar period switcher.
+     *
+     * @vegaVersion 2.91.0
+     */
+    this.showWeekends = true;
+  }
+  /**
+   * Tracks changes to the current period state.
+   *
+   * @param {CalendarPeriod} newValue Specifies the new calendar period.
+   * @param {CalendarPeriod} oldValue Specifies the old calendar period.
+   */
+  watchCurrentPeriodChange(newValue, oldValue) {
+    methodPlaceholder(newValue, oldValue);
+  }
+  watchViewModeChange() {
+    methodPlaceholder();
+  }
+  watchTimezoneChange() {
+    methodPlaceholder();
+  }
+  watchShowWeekendsChange() {
+    methodPlaceholder();
+  }
+  /**
+   * Invoke this method to set the current calendar period.
+   * Use `VegaCalendarPeriodFactory.fromDate` to create a `VegaCalendarPeriodType` from a date if needed.
+   *
+   * @vegaVersion 2.91.0
+   */
+  async setCurrentPeriod(period) {
+    methodPlaceholder(period);
+  }
+  /**
+   * Invoke this method to get the current calendar period.
+   *
+   * @vegaVersion 2.91.0
+   */
+  async getCurrentPeriod() {
+    return methodPlaceholder();
+  }
+  render() {
+    return sanitizeVegaComponent(h(Host, null, this.renderer.render()), this.host);
+  }
+  static get is() { return "vega-calendar-period-switcher"; }
+  static get encapsulation() { return "shadow"; }
+  static get originalStyleUrls() { return {
+    "$": ["vega-calendar-period-switcher.scss"]
+  }; }
+  static get styleUrls() { return {
+    "$": ["vega-calendar-period-switcher.css"]
+  }; }
+  static get properties() { return {
+    "viewMode": {
+      "type": "string",
+      "mutable": true,
+      "complexType": {
+        "original": "VegaCalendarViewModeType",
+        "resolved": "\"day\" | \"month\" | \"week\"",
+        "references": {
+          "VegaCalendarViewModeType": {
+            "location": "import",
+            "path": "../types"
+          }
+        }
+      },
+      "required": false,
+      "optional": false,
+      "docs": {
+        "tags": [{
+            "name": "vegaVersion",
+            "text": "2.91.0"
+          }],
+        "text": "Specifies the current view mode of the calendar period switcher."
+      },
+      "attribute": "view-mode",
+      "reflect": false,
+      "defaultValue": "'month'"
+    },
+    "timezone": {
+      "type": "string",
+      "mutable": false,
+      "complexType": {
+        "original": "string",
+        "resolved": "string",
+        "references": {}
+      },
+      "required": false,
+      "optional": false,
+      "docs": {
+        "tags": [{
+            "name": "vegaVersion",
+            "text": "2.91.0"
+          }],
+        "text": "Specifies the IANA time zone or Etc/GMT\u00B1n format.\n It accepts values such as \"America/New_York\" or \"Etc/GMT+12\".\n If not set, the component defaults to the system's time zone.\n For a complete list of IANA time zones, see Time Zone DB(https://timezonedb.com/time-zones)."
+      },
+      "attribute": "timezone",
+      "reflect": false,
+      "defaultValue": "getSystemTimezone()"
+    },
+    "showWeekends": {
+      "type": "boolean",
+      "mutable": false,
+      "complexType": {
+        "original": "boolean",
+        "resolved": "boolean",
+        "references": {}
+      },
+      "required": false,
+      "optional": false,
+      "docs": {
+        "tags": [{
+            "name": "vegaVersion",
+            "text": "2.91.0"
+          }],
+        "text": "Determines whether weekends are displayed in the calendar period switcher."
+      },
+      "attribute": "show-weekends",
+      "reflect": false,
+      "defaultValue": "true"
+    }
+  }; }
+  static get states() { return {
+    "currentPeriod": {}
+  }; }
+  static get events() { return [{
+      "method": "vegaChange",
+      "name": "vegaChange",
+      "bubbles": true,
+      "cancelable": true,
+      "composed": true,
+      "docs": {
+        "tags": [{
+            "name": "vegaVersion",
+            "text": "2.91.0"
+          }],
+        "text": "An event emitter notifying that the calendar period has changed."
+      },
+      "complexType": {
+        "original": "VegaCalendarPeriodType",
+        "resolved": "{ currentPeriod: VegaCalendarCurrentPeriodType; viewMode: VegaCalendarViewModeType; }",
+        "references": {
+          "VegaCalendarPeriodType": {
+            "location": "import",
+            "path": "../types"
+          }
+        }
+      }
+    }, {
+      "method": "change",
+      "name": "change",
+      "bubbles": true,
+      "cancelable": true,
+      "composed": true,
+      "docs": {
+        "tags": [{
+            "name": "eventSemantics",
+            "text": "namespace:native"
+          }, {
+            "name": "vegaVersion",
+            "text": "2.91.0"
+          }],
+        "text": "An event emitter notifying that the calendar period has changed."
+      },
+      "complexType": {
+        "original": "VegaCalendarPeriodType",
+        "resolved": "{ currentPeriod: VegaCalendarCurrentPeriodType; viewMode: VegaCalendarViewModeType; }",
+        "references": {
+          "VegaCalendarPeriodType": {
+            "location": "import",
+            "path": "../types"
+          }
+        }
+      }
+    }]; }
+  static get methods() { return {
+    "setCurrentPeriod": {
+      "complexType": {
+        "signature": "(period: VegaCalendarPeriodType) => Promise<void>",
+        "parameters": [{
+            "tags": [],
+            "text": ""
+          }],
+        "references": {
+          "Promise": {
+            "location": "global"
+          },
+          "VegaCalendarPeriodType": {
+            "location": "import",
+            "path": "../types"
+          }
+        },
+        "return": "Promise<void>"
+      },
+      "docs": {
+        "text": "Invoke this method to set the current calendar period.\nUse `VegaCalendarPeriodFactory.fromDate` to create a `VegaCalendarPeriodType` from a date if needed.",
+        "tags": [{
+            "name": "vegaVersion",
+            "text": "2.91.0"
+          }]
+      }
+    },
+    "getCurrentPeriod": {
+      "complexType": {
+        "signature": "() => Promise<VegaCalendarPeriodType>",
+        "parameters": [],
+        "references": {
+          "Promise": {
+            "location": "global"
+          },
+          "VegaCalendarPeriodType": {
+            "location": "import",
+            "path": "../types"
+          }
+        },
+        "return": "Promise<VegaCalendarPeriodType>"
+      },
+      "docs": {
+        "text": "Invoke this method to get the current calendar period.",
+        "tags": [{
+            "name": "vegaVersion",
+            "text": "2.91.0"
+          }]
+      }
+    }
+  }; }
+  static get elementRef() { return "host"; }
+  static get watchers() { return [{
+      "propName": "currentPeriod",
+      "methodName": "watchCurrentPeriodChange"
+    }, {
+      "propName": "viewMode",
+      "methodName": "watchViewModeChange"
+    }, {
+      "propName": "timezone",
+      "methodName": "watchTimezoneChange"
+    }, {
+      "propName": "showWeekends",
+      "methodName": "watchShowWeekendsChange"
+    }]; }
+}
+__decorate([
+  InjectVegaSlimmer()
+], VegaCalendarPeriodSwitcher.prototype, "translationSlimmer", void 0);
+__decorate([
+  InjectVegaSlimmer()
+], VegaCalendarPeriodSwitcher.prototype, "changeEventEmitter", void 0);
+__decorate([
+  InjectVegaGlobalSlimmer()
+], VegaCalendarPeriodSwitcher.prototype, "globalSlimmer", void 0);
+__decorate([
+  InjectVegaSlimmer()
+], VegaCalendarPeriodSwitcher.prototype, "vegaComponentUsageRuntimeMetricsSlimmer", void 0);
+__decorate([
+  InjectVegaSlimmer()
+], VegaCalendarPeriodSwitcher.prototype, "currentPeriodController", void 0);
+__decorate([
+  InjectVegaSlimmer()
+], VegaCalendarPeriodSwitcher.prototype, "stateController", void 0);
+__decorate([
+  InjectVegaSlimmer()
+], VegaCalendarPeriodSwitcher.prototype, "renderer", void 0);

package/dist/collection/components/vega-calendar/vega-calendar.css

@@ -62,21 +62,12 @@
   width: 100%;
   box-sizing: border-box;
 }
-.calendar-switch-panel .calendar-date-switch-container {
-  display: flex;
-  gap: 8px;
-  align-items: center;
-  flex-direction: row;
-}
 .calendar-switch-panel .calendar-view-switch-container {
   display: flex;
   gap: 16px;
   align-items: center;
   flex-direction: row;
 }
-.calendar-switch-panel .calendar-current-date {
-  padding-left: 8px;
-}
 
 .calendar-view {
   width: 100%;

package/dist/collection/components/vega-calendar/vega-calendar.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, h, Element, Host, State, Prop, Watch, Event } from '@stencil/core';
+import { Component, h, Element, Host, State, Prop, Watch, Event, Method } from '@stencil/core';
 import { sanitizeVegaComponent } from '../../utils/component';
 import { InjectVegaGlobalSlimmer, InjectVegaSlimmer, methodPlaceholder, } from 'vega-slimmer/core';
 import { VegaCalendarRenderer } from './slimmers/common/renderers/vega-calendar-renderer';
@@ -82,6 +82,7 @@ export class VegaCalendar {
     this.changeEventPrevent = new ChildNodesEventPreventSlimmer([VegaChange], () => this.switchPanelRenderer.getSwitchPanelRef());
     this.timeFormatNotifySlimmer = createSubStateNotifySlimmer(VegaCalendar, 'timeFormat', 'watchTimeFormat');
     this.showEventColorBarNotifySlimmer = createSubStateNotifySlimmer(VegaCalendar, 'showEventColorBar', 'watchShowEventColorBar');
+    this.currentPeriodNotifySlimmer = createSubStateNotifySlimmer(VegaCalendar, 'currentPeriod', 'watchCurrentPeriodChange');
     /**
      * This postOperationDate will record the time after the operation, which will affect the calculation of day/week/month, making the generated interval accurate
      *
@@ -216,6 +217,23 @@ export class VegaCalendar {
   watchTimezoneChange() {
     methodPlaceholder();
   }
+  /**
+   * Invoke this method to set the current calendar period.
+   * Use `VegaCalendarPeriodFactory.fromDate` to create a `VegaCalendarPeriodType` from a date if needed.
+   *
+   * @vegaVersion 2.91.0
+   */
+  async setCurrentPeriod(period) {
+    methodPlaceholder(period);
+  }
+  /**
+   * Invoke this method to get the current calendar period.
+   *
+   * @vegaVersion 2.91.0
+   */
+  async getCurrentPeriod() {
+    return methodPlaceholder();
+  }
   render() {
     return sanitizeVegaComponent(h(Host, null, this.renderer.render()), this.host);
   }
@@ -825,6 +843,57 @@ export class VegaCalendar {
         "references": {}
       }
     }]; }
+  static get methods() { return {
+    "setCurrentPeriod": {
+      "complexType": {
+        "signature": "(period: VegaCalendarPeriodType) => Promise<void>",
+        "parameters": [{
+            "tags": [],
+            "text": ""
+          }],
+        "references": {
+          "Promise": {
+            "location": "global"
+          },
+          "VegaCalendarPeriodType": {
+            "location": "import",
+            "path": "./types"
+          }
+        },
+        "return": "Promise<void>"
+      },
+      "docs": {
+        "text": "Invoke this method to set the current calendar period.\nUse `VegaCalendarPeriodFactory.fromDate` to create a `VegaCalendarPeriodType` from a date if needed.",
+        "tags": [{
+            "name": "vegaVersion",
+            "text": "2.91.0"
+          }]
+      }
+    },
+    "getCurrentPeriod": {
+      "complexType": {
+        "signature": "() => Promise<VegaCalendarPeriodType>",
+        "parameters": [],
+        "references": {
+          "Promise": {
+            "location": "global"
+          },
+          "VegaCalendarPeriodType": {
+            "location": "import",
+            "path": "./types"
+          }
+        },
+        "return": "Promise<VegaCalendarPeriodType>"
+      },
+      "docs": {
+        "text": "Invoke this method to get the current calendar period.",
+        "tags": [{
+            "name": "vegaVersion",
+            "text": "2.91.0"
+          }]
+      }
+    }
+  }; }
   static get elementRef() { return "host"; }
   static get watchers() { return [{
       "propName": "currentPeriod",
@@ -957,3 +1026,6 @@ __decorate([
 __decorate([
   InjectVegaSlimmer()
 ], VegaCalendar.prototype, "showEventColorBarNotifySlimmer", void 0);
+__decorate([
+  InjectVegaSlimmer()
+], VegaCalendar.prototype, "currentPeriodNotifySlimmer", void 0);

package/dist/collection/components/vega-checkbox/vega-checkbox-group/vega-checkbox-group.css

@@ -51,20 +51,19 @@
   display: none;
 }
 
-.vega-label {
+vega-field-label {
   margin-bottom: 16px;
+  display: block;
 }
-
-.vega-label label {
+vega-field-label::part(container) {
   font-family: "Inter", sans-serif;
   font-size: 18px;
   font-weight: 500;
   line-height: 30px;
   letter-spacing: 0px;
-  color: rgba(var(--v-text-primary, 32, 54, 69, 1));
 }
 @media screen and (min-width: 768px) and (max-width: 1023px) {
-  .vega-label label {
+  vega-field-label::part(container) {
     font-family: "Inter", sans-serif;
     font-size: 16px;
     font-weight: 500;
@@ -73,7 +72,7 @@
   }
 }
 @media screen and (min-width: 1024px) and (max-width: 1439px) {
-  .vega-label label {
+  vega-field-label::part(container) {
     font-family: "Inter", sans-serif;
     font-size: 16px;
     font-weight: 500;
@@ -82,7 +81,7 @@
   }
 }
 @media screen and (min-width: 1440px) and (max-width: 9999px) {
-  .vega-label label {
+  vega-field-label::part(container) {
     font-family: "Inter", sans-serif;
     font-size: 16px;
     font-weight: 500;
@@ -90,10 +89,8 @@
     letter-spacing: 0px;
   }
 }
-
-.vega-require {
-  color: rgba(var(--v-text-error, 189, 41, 71, 1));
-  margin-left: 4px;
+vega-field-label::part(label) {
+  word-break: normal;
 }
 
 .vega-hint {

package/dist/collection/components/vega-checkbox/vega-checkbox-group/vega-checkbox-group.js

@@ -83,6 +83,16 @@ export class VegaCheckboxGroup {
      * @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.90.0
+     */
+    this.optional = false;
     /**
      * Provides a supplementary prompt message that
      *    assists users in selecting the appropriate
@@ -195,13 +205,7 @@ export class VegaCheckboxGroup {
       this.renderHintDom()), this.host);
   }
   renderLabelDom() {
-    return (this.label && (h("div", { class: "vega-label" },
-      h("label", { "aria-label": this.label },
-        this.label,
-        this.renderRequireDom()))));
-  }
-  renderRequireDom() {
-    return this.required ? h("span", { class: "vega-require" }, "*") : null;
+    return (this.label && (h("vega-field-label", { label: this.label, isFieldRequired: this.required, optional: this.optional, disabled: this.disabled })));
   }
   renderHintDom() {
     return (this.hint && (h("div", { class: "vega-hint" },
@@ -361,6 +365,30 @@ export class VegaCheckboxGroup {
       "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.90.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"
+    },
     "hint": {
       "type": "string",
       "mutable": false,

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

@@ -507,7 +507,7 @@ export class VegaComboBox {
             "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."
+        "text": "Specifies the maximum height of the combo box container.\n   When the content exceeds this limit, vertical scrolling is enabled."
       },
       "attribute": "container-max-height",
       "reflect": true

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

@@ -104,8 +104,8 @@ export class VegaFieldLabel {
         disabled: this.disabled,
       }, onClick: this.handleClick },
       this.labelAnnouncementRenderer.render(),
-      h("label", { "aria-hidden": "true" },
-        h("span", { class: "vega-field-label" }, this.label),
+      h("label", { "aria-hidden": "true", part: "container" },
+        h("span", { class: "vega-field-label", part: "label" }, this.label),
         !this.isFieldRequired && this.optional && (h("span", { class: "optional" },
           "(",
           this.translationSlimmer.t('Optional'),

package/dist/collection/components/vega-font/slimmers/controllers/vega-font-classes-controller.js

@@ -7,6 +7,7 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 import { VegaSlimmer, MapToComponentField } from 'vega-slimmer/core';
 import { arrayToClassString } from '../../../../utils/ui';
 import { formatAndValidResponsiveToken, formatAndValidTextColor, formatAndValidTypographyToken, } from '../../../../utils/design-token';
+import { FeatureFlag } from '../../../../helpers/feature-control/feature-flag-controller';
 /** The VegaFontClassesController class is responsible for generating CSS classes based on the font properties and settings. */
 export class VegaFontClassesController extends VegaSlimmer {
   /**
@@ -29,6 +30,12 @@ export class VegaFontClassesController extends VegaSlimmer {
     if (this.textAlign) {
       hostClasses.push(formatAndValidResponsiveToken(this.textAlign, 'textAlign'));
     }
+    // Opt-in legacy letter-spacing override. The class is harmless on variants without
+    // a matching rule in typography.legacy-letter-spacing.scss (no selector match → no style),
+    // so this stays correct even if new variants gain negative spacing tokens in the future.
+    if (FeatureFlag.isEnabled('VEGA_FONT.LEGACY_LETTER_SPACING')) {
+      hostClasses.push('legacy-letter-spacing');
+    }
     return arrayToClassString(hostClasses);
   }
 }