@globalpayments/vega 2.90.0 → 2.91.0

package/dist/collection/components/vega-rich-text-editor/constants/constant.js

@@ -70,3 +70,8 @@ export const HTML_VOID_TAGS = new Set([
   'track',
   'wbr',
 ]);
+/**
+ * The visual height in pixels of one row in the rich text editor.
+ * This value is based on the paragraph line-height and padding of text content.
+ */
+export const VegaRTEOneRowHeightPx = 22;

package/dist/collection/components/vega-rich-text-editor/slimmers/controllers/selection-controller.js

@@ -44,6 +44,7 @@ export class SelectionController extends AutoRunWhenReRenderTaskQueueSlimmer {
       const range = this.currentRange.toNativeRange();
       if (range) {
         this.setSelectionRange(range);
+        this.scrollCaretIntoView(range);
       }
     };
   }
@@ -167,6 +168,60 @@ export class SelectionController extends AutoRunWhenReRenderTaskQueueSlimmer {
     const richTextContentRef = this.vegaRichTextEditorRenderer.getRichTextContentRef();
     return ShadowSelectionPolyfill.getSelection(richTextContentRef.shadowRoot);
   }
+  /**
+   * Scroll the editor's scrollable viewport so the caret stays visible.
+   * Setting the selection range programmatically does not trigger the browser's
+   * native auto-scroll, so when the cursor is moved (e.g. after inserting a
+   * function block) it can land outside the visible area of a fixed-height
+   * (rows) editor. This keeps the caret within view.
+   *
+   * Note: This method performs getBoundingClientRect() reads and is called during
+   * the re-render task path every time the saved selection is restored.
+   *
+   * @param {Range} range - The range that was applied to the selection.
+   */
+  scrollCaretIntoView(range) {
+    const viewport = this.vegaRichTextEditorRenderer.getRichTextContentRef();
+    const caretRect = this.getCaretRect(range);
+    if (!viewport || !caretRect) {
+      return;
+    }
+    const viewportRect = viewport.getBoundingClientRect();
+    if (viewportRect.width === 0 ||
+      viewportRect.height === 0 ||
+      (caretRect.top === 0 && caretRect.bottom === 0 && caretRect.left === 0 && caretRect.right === 0)) {
+      return;
+    }
+    if (caretRect.bottom > viewportRect.bottom) {
+      viewport.scrollTop += caretRect.bottom - viewportRect.bottom;
+    }
+    else if (caretRect.top < viewportRect.top) {
+      viewport.scrollTop -= viewportRect.top - caretRect.top;
+    }
+  }
+  /**
+   * Get the bounding rect of the caret for the given range.
+   * A collapsed range inside an empty node can return an empty rect, so in that
+   * case fall back to the nearest element's bounding rect.
+   *
+   * @param {Range} range - The range to measure.
+   * @returns {Nullable<DOMRect>} The caret bounding rect, or null if it cannot be resolved.
+   */
+  getCaretRect(range) {
+    // getBoundingClientRect is unavailable in non-DOM (test) environments.
+    if (typeof range.getBoundingClientRect !== 'function') {
+      return null;
+    }
+    const rangeRect = range.getBoundingClientRect();
+    if (rangeRect.height > 0) {
+      return rangeRect;
+    }
+    const startContainer = range.startContainer;
+    const element = startContainer.nodeType === Node.TEXT_NODE
+      ? startContainer.parentElement
+      : startContainer;
+    return element ? element.getBoundingClientRect() : null;
+  }
   /**
    * Save the current selection range detail
    */

package/dist/collection/components/vega-rich-text-editor/slimmers/renderers/vega-rich-text-editor-renderer.js

@@ -10,6 +10,7 @@ import { createEnterKeyHandlerToTriggerClick } from '../../../../utils/accessibi
 import ChangeManager from '../../../../helpers/change-manager/change-manager';
 import domNodeSubjectFactory from '../../../../helpers/change-manager/subject/dom-node-subject/dom-node-subject-factory';
 import { VegaInternalComponentDidRender } from '../../../../helpers/event-manager/event-id/vega-internal-event-id';
+import { VegaRTEOneRowHeightPx } from '../../constants/constant';
 export class VegaRichTextEditorRenderer extends VegaSlimmer {
   constructor() {
     super(...arguments);
@@ -17,11 +18,19 @@ export class VegaRichTextEditorRenderer extends VegaSlimmer {
       return h("vega-text", { text: this.hint });
     };
     this.renderTextContent = () => {
+      const defaultHeight = `${5 * VegaRTEOneRowHeightPx}px`;
+      /**
+       * When rows is set to a value less than 2, it defaults to 5 rows
+       * to ensure the editor remains usable with adequate visible space.
+       */
+      const containerStyle = this.rows !== undefined
+        ? { height: this.rows >= 2 ? `${this.rows * VegaRTEOneRowHeightPx}px` : defaultHeight }
+        : { minHeight: defaultHeight };
       return (h("div", { class: {
           'rich-text-editor-container': true,
           'disabled': this.disabled,
           'vega-hidden': this.sourceView,
-        }, style: { minHeight: `${this.rows * 24}px` }, onClick: this.richTextContentFocus, role: "textbox", tabIndex: !this.disabled ? -1 : 0, onKeyDown: createEnterKeyHandlerToTriggerClick(), ref: (node) => (this.richTextContainerRef = node) },
+        }, style: containerStyle, onClick: this.richTextContentFocus, role: "textbox", tabIndex: !this.disabled ? -1 : 0, onKeyDown: createEnterKeyHandlerToTriggerClick(), ref: (node) => (this.richTextContainerRef = node) },
         h("vega-rich-text-content", { ref: (ref) => (this.richTextContentRef = ref), content: this.value, extensions: this.extensions }),
         this.renderCharacterCounter()));
     };

package/dist/collection/components/vega-rich-text-editor/vega-rich-text-editor.css

@@ -58,11 +58,11 @@
   border-radius: 8px;
   color: rgba(var(--v-text-primary, 32, 54, 69, 1));
   margin-top: 12px;
-  overflow: auto;
+  overflow: hidden;
   resize: vertical;
   padding-top: 12px;
   padding-right: 16px;
-  padding-bottom: 32px;
+  padding-bottom: 12px;
   padding-left: 16px;
 }
 :host .rich-text-editor-container:hover {

package/dist/collection/components/vega-rich-text-editor/vega-rich-text-editor.js

@@ -176,12 +176,6 @@ export class VegaRichTextEditor {
      * @vegaVersion 2.34.0
      */
     this.hint = '';
-    /**
-     * Specifies editable section rows for the rich text editor
-     *
-     * @vegaVersion 2.34.0
-     */
-    this.rows = 4;
     /**
      * Specifies the value of the rich text editor, which can be either VegaRTEContent or VegaRTEContentBlock.
      * It is recommended to use the VegaRTEContent type.
@@ -443,17 +437,16 @@ export class VegaRichTextEditor {
         "references": {}
       },
       "required": false,
-      "optional": false,
+      "optional": true,
       "docs": {
         "tags": [{
             "name": "vegaVersion",
             "text": "2.34.0"
           }],
-        "text": "Specifies editable section rows for the rich text editor"
+        "text": "Specifies editable section rows for the rich text editor.\nWhen not set, the editor uses stretching behavior with a default visual height of 5 rows.\nWhen set, the editor height is fixed and content overflow is scrollable.\nThe value accepts integers \u2265 2; for optimal display, values below 2 are internally normalized to 5 rows."
       },
       "attribute": "rows",
-      "reflect": false,
-      "defaultValue": "4"
+      "reflect": false
     },
     "value": {
       "type": "unknown",

package/dist/collection/constants/tokens/typography.js

@@ -8,28 +8,28 @@ export const Typography = {
     "font-size:42px",
     "font-weight:700",
     "line-height:50px",
-    "letter-spacing:0.42px"
+    "letter-spacing:-0.42px"
   ],
   "M:v-font-h1": [
     "@apply v-font-inter",
     "font-size:42px",
     "font-weight:700",
     "line-height:50px",
-    "letter-spacing:2.52px"
+    "letter-spacing:-0.67px"
   ],
   "L:v-font-h1": [
     "@apply v-font-inter",
     "font-size:48px",
     "font-weight:700",
     "line-height:56px",
-    "letter-spacing:0.96px"
+    "letter-spacing:-1.06px"
   ],
   "XL:v-font-h1": [
     "@apply v-font-inter",
     "font-size:60px",
     "font-weight:700",
     "line-height:70px",
-    "letter-spacing:1.8px"
+    "letter-spacing:-1.8px"
   ],
   "v-font-h2": [
     "@apply v-font-inter",
@@ -50,42 +50,42 @@ export const Typography = {
     "font-size:36px",
     "font-weight:700",
     "line-height:44px",
-    "letter-spacing:1.8px"
+    "letter-spacing:-0.18px"
   ],
   "XL:v-font-h2": [
     "@apply v-font-inter",
     "font-size:42px",
     "font-weight:700",
     "line-height:52px",
-    "letter-spacing:0.42px"
+    "letter-spacing:-0.42px"
   ],
   "v-font-h3": [
     "@apply v-font-inter",
     "font-size:28px",
     "font-weight:500",
     "line-height:36px",
-    "letter-spacing:0.28px"
+    "letter-spacing:-0.28px"
   ],
   "M:v-font-h3": [
     "@apply v-font-inter",
     "font-size:28px",
     "font-weight:500",
     "line-height:36px",
-    "letter-spacing:0.28px"
+    "letter-spacing:-0.28px"
   ],
   "L:v-font-h3": [
     "@apply v-font-inter",
     "font-size:28px",
     "font-weight:500",
     "line-height:36px",
-    "letter-spacing:0.28px"
+    "letter-spacing:-0.28px"
   ],
   "XL:v-font-h3": [
     "@apply v-font-inter",
     "font-size:32px",
     "font-weight:500",
     "line-height:44px",
-    "letter-spacing:0.32px"
+    "letter-spacing:-0.32px"
   ],
   "v-font-h4": [
     "@apply v-font-inter",

package/dist/collection/constants/ui.js

@@ -107,6 +107,7 @@ export const VegaNativeEventName = [
   'rowDragDrop',
   'eventEdit',
   'todayClick',
+  'additionalLinkClick',
 ];
 // eslint-disable-next-line @typescript-eslint/typedef
 export const CssStates = ['default', 'hover', 'active', 'focus-visible'];

package/dist/collection/global/scripts/before-vega-load.js

@@ -31,6 +31,7 @@ import { VegaRTESpecialCharactersEssentials, VegaRTESpecialCharactersLatin, Vega
 import { VegaRTELineHeightExtension } from '../../components/vega-rich-text-editor/extensions/line-height/line-height-extension';
 import { VegaRTEDefaultLineHeightOptions } from '../../components/vega-rich-text-editor/extensions/line-height/constants';
 import { VegaRTELinkExtension } from '../../components/vega-rich-text-editor/extensions/link/link-extension';
+import { VegaCalendarPeriodFactory } from '../../helpers/calendar';
 /**
  * Default export function that will be used by stencil global script,
  * which will be invoked before library loaded.
@@ -58,6 +59,7 @@ export default function () {
   applyBrandingFromClientGlobal();
   injectSetNonceIntoGlobal();
   patchHeadInsertBeforeWithNonce();
+  injectVegaCalendarPeriodFactoryIntoGlobal();
 }
 /**
  * Disable feature flags from the client global defined lists.
@@ -216,6 +218,12 @@ function injectVegaRichTextEditorClassIntoGlobal() {
   globalThis.VegaRTELineHeightExtension = VegaRTELineHeightExtension;
   globalThis.VegaRTELinkExtension = VegaRTELinkExtension;
 }
+/**
+ * Inject VegaCalendarPeriodFactory to global as a public api.
+ */
+function injectVegaCalendarPeriodFactoryIntoGlobal() {
+  globalThis.VegaCalendarPeriodFactory = VegaCalendarPeriodFactory;
+}
 /**
  * Inject VegaPublicValidationRules to global as a public api
  */

package/dist/collection/helpers/calendar/calendar-period/day-period.js

@@ -1,6 +1,7 @@
 import { CalendarPeriod } from './calendar-period.abstract';
 import { CalendarDate } from '../calendar-date';
 import { DateDirection, getClosestWorkday } from '../../../components/vega-calendar/utils';
+import { VegaInternalTranslation } from '../../translation/internal-translation-controller';
 /**
  * Period of day.
  */
@@ -47,6 +48,14 @@ export class DayPeriod extends CalendarPeriod {
     }
     return this.createBy(calendarDate);
   }
+  /**
+   * @inheritDoc
+   */
+  getViewDateSummary() {
+    const currentDate = this.current;
+    const monthName = VegaInternalTranslation.t(currentDate.getMonthName());
+    return `${currentDate.date} ${monthName}, ${currentDate.year}`;
+  }
   /**
    * @inheritDoc
    */

package/dist/collection/helpers/calendar/calendar-period/internal-calendar-period-factory.js

@@ -0,0 +1,76 @@
+import { CalendarDate } from '../calendar-date';
+import { DayPeriod } from './day-period';
+import { MonthPeriod } from './month-period';
+import { WeekPeriod } from './week-period';
+/**
+ * Factory class for creating CalendarPeriod instances and converting them to VegaCalendarPeriodType.
+ */
+export class InternalCalendarPeriodConverter {
+  /**
+   * Create a CalendarPeriod instance based on the specified view mode and date string.
+   *
+   * @param {string} dateString - The date string to base the period on, in 'MM/DD/YYYY' format
+   * @param {'month'|'week'|'day'} [viewMode='month'] - The view mode for the period, defaults to 'month'
+   * @param {string} [timezone] - Optional timezone for the period calculation
+   * @param {boolean} [showWeekends=true] - Whether to show weekends in the period, It's flag for calendar component, will effect the calendar view only.
+   * @returns {CalendarPeriod} The created CalendarPeriod instance
+   */
+  static createCalendarPeriod(dateString, viewMode = 'month', timezone, showWeekends = true) {
+    const calendarDate = CalendarDate.fromString(dateString, 'MM/DD/YYYY', timezone);
+    let period;
+    switch (viewMode) {
+      case 'week':
+        period = new WeekPeriod(calendarDate, showWeekends, timezone);
+        break;
+      case 'day':
+        period = new DayPeriod(calendarDate, showWeekends, timezone);
+        break;
+      default:
+        period = new MonthPeriod(calendarDate, showWeekends, timezone);
+    }
+    return period;
+  }
+  /**
+   * Convert a VegaCalendarPeriodType to calendar period
+   *
+   * @param {VegaCalendarPeriodType} periodType - The converted period type
+   * @param {string} [timezone] - Optional timezone for the period calculation
+   * @param {boolean} [showWeekends=true] - Whether to show weekends in the period, It's flag for calendar component, will effect the calendar view only.
+   * @returns {CalendarPeriod} - The period to convert
+   */
+  static fromCalendarPeriodType(periodType, timezone, showWeekends = true) {
+    const { currentPeriod, viewMode } = periodType;
+    const { year, month, startDate } = currentPeriod;
+    let targetDate = `${month}/01/${year}`;
+    if (viewMode === 'day' || viewMode === 'week') {
+      targetDate = `${startDate.month}/${startDate.date}/${startDate.year}`;
+    }
+    return InternalCalendarPeriodConverter.createCalendarPeriod(targetDate, viewMode, timezone, showWeekends);
+  }
+  /**
+   * Convert a period to VegaCalendarPeriodType
+   *
+   * @param {CalendarPeriod} period - The period to convert
+   * @returns {VegaCalendarPeriodType} The converted period type
+   */
+  static toCalendarPeriodType(period) {
+    const { current, startDate, endDate } = period;
+    return {
+      viewMode: period.type,
+      currentPeriod: {
+        year: current.year,
+        month: current.month,
+        startDate: {
+          date: startDate.date,
+          month: startDate.month,
+          year: startDate.year,
+        },
+        endDate: {
+          date: endDate.date,
+          month: endDate.month,
+          year: endDate.year,
+        },
+      },
+    };
+  }
+}

package/dist/collection/helpers/calendar/calendar-period/month-period.js

@@ -1,6 +1,7 @@
 import { CalendarPeriod } from './calendar-period.abstract';
 import { CalendarDate } from '../calendar-date';
 import { getWeekdays } from '../utils';
+import { VegaInternalTranslation } from '../../translation/internal-translation-controller';
 /**
  * Period of month
  */
@@ -67,6 +68,14 @@ export class MonthPeriod extends CalendarPeriod {
     const previous = new Date(year, month, previousDay);
     return this.createBy(CalendarDate.from(previous));
   }
+  /**
+   * @inheritDoc
+   */
+  getViewDateSummary() {
+    const currentDate = this.current;
+    const monthName = VegaInternalTranslation.t(this.current.getMonthName());
+    return `${monthName}, ${currentDate.year}`;
+  }
   /**
    * @inheritDoc
    */

package/dist/collection/helpers/calendar/calendar-period/vega-calendar-period-factory.js

@@ -0,0 +1,19 @@
+import { InternalCalendarPeriodConverter } from './internal-calendar-period-factory';
+/**
+ * Factory class for creating CalendarPeriod instances.
+ */
+export class VegaCalendarPeriodFactory {
+  /**
+   * Create a VegaCalendarCurrentPeriodType based on the specified view mode and date.
+   *
+   * @param {string} dateString - The date string to base the period on, in 'MM/DD/YYYY' format
+   * @param {'month'|'week'|'day'} [viewMode='month'] - The view mode for the period, defaults to 'month'
+   * @param {string} [timezone] - Optional timezone for the period calculation
+   * @param {boolean} [showWeekends=true] - Whether to show weekends in the period, It's flag for calendar component, will effect the calendar view only.
+   * @returns {VegaCalendarPeriodType} The period information containing year, month, startDate and endDate
+   */
+  static fromDate(dateString, viewMode = 'month', timezone, showWeekends = true) {
+    const period = InternalCalendarPeriodConverter.createCalendarPeriod(dateString, viewMode, timezone, showWeekends);
+    return InternalCalendarPeriodConverter.toCalendarPeriodType(period);
+  }
+}

package/dist/collection/helpers/calendar/calendar-period/week-period.js

@@ -1,5 +1,7 @@
 import { CalendarPeriod } from './calendar-period.abstract';
 import { CalendarDate } from '../calendar-date';
+import { VegaInternalTranslation } from '../../translation/internal-translation-controller';
+import { WeekViewGenerator } from '../calendar-view-generator/week-view-generator';
 /**
  * Period of the week
  */
@@ -8,6 +10,7 @@ export class WeekPeriod extends CalendarPeriod {
     super(WeekPeriod.DISPLAY_DATE_COUNT, current, timezone);
     this._type = 'week';
     this._showWeekends = true;
+    this.weekViewGenerator = new WeekViewGenerator();
     this._showWeekends = showWeekends === false ? false : true;
   }
   /**
@@ -26,6 +29,17 @@ export class WeekPeriod extends CalendarPeriod {
     currentDate.setDate(currentDate.getDate() - 7);
     return this.createBy(CalendarDate.from(currentDate));
   }
+  /**
+   * @inheritDoc
+   */
+  getViewDateSummary() {
+    const calendarView = this.weekViewGenerator.generate(this);
+    const weekItems = calendarView.dateItems[0];
+    const start = weekItems[0];
+    const end = weekItems[weekItems.length - 1];
+    const [startMonthName, endMonthName] = [start, end].map((item) => VegaInternalTranslation.t(item.getMonthName()));
+    return `${start.date} ${startMonthName}${start.year === end.year ? '' : ', ' + start.year} - ${end.date} ${endMonthName}, ${end.year}`;
+  }
   /**
    * @inheritDoc
    */

package/dist/collection/helpers/calendar/index.js

@@ -6,6 +6,7 @@ export { CalendarPeriod } from './calendar-period/calendar-period.abstract';
 export { DayPeriod } from './calendar-period/day-period';
 export { WeekPeriod } from './calendar-period/week-period';
 export { MonthPeriod } from './calendar-period/month-period';
+export { VegaCalendarPeriodFactory } from './calendar-period/vega-calendar-period-factory';
 export { CalendarDate } from './calendar-date';
 export { CalendarDateTime } from './calendar-date-time';
 export { CalendarTime } from './calendar-time';

package/dist/collection/helpers/common/wait-for-vega-handler.js

@@ -12,7 +12,7 @@ import { createPublicAPIRuntimeMetricsSlimmer } from '../slimmers/runtime-metric
  */
 class WaitForVegaHandler {
   constructor() {
-    this.vegaPublicAPIRuntimeMetricsSlimmer = createPublicAPIRuntimeMetricsSlimmer(WaitForVegaHandler, ['handle'], WaitForVegaPayloadDefinition);
+    this.vegaPublicAPIRuntimeMetricsSlimmer = createPublicAPIRuntimeMetricsSlimmer(WaitForVegaHandler, ['handle'], WaitForVegaPayloadDefinition, 'WaitForVegaHandler');
   }
   /* istanbul ignore next */
   /**

package/dist/collection/helpers/dialog/vega-dialog-controller.js

@@ -24,7 +24,7 @@ import { VegaDialogRuntimeMetricsPayloadDefinition } from '../../constants/runti
  */
 class VegaDialogController {
   constructor() {
-    this.vegaPublicAPIRuntimeMetricsSlimmer = createPublicAPIRuntimeMetricsSlimmer(VegaDialogController, ['open'], VegaDialogRuntimeMetricsPayloadDefinition);
+    this.vegaPublicAPIRuntimeMetricsSlimmer = createPublicAPIRuntimeMetricsSlimmer(VegaDialogController, ['open'], VegaDialogRuntimeMetricsPayloadDefinition, 'VegaDialogController');
   }
   /**
    *

package/dist/collection/helpers/event-manager/event-id/component-event-id-map.js

@@ -1,6 +1,7 @@
-import { VegaExpand, VegaClick, VegaDropdownClick, VegaReset, VegaDropdownSearch, VegaClose, VegaActionButtonClick, VegaChange, VegaEventClick, VegaDateDblClick, VegaMoreActionClick, VegaDateClick, VegaEventEdit, VegaPageUpdate, VegaUserChange, VegaRemove, VegaCreate, VegaSearch, VegaMonthYearChange, VegaClear, VegaSelectionChange, VegaTodayClick, VegaDropdownShow, VegaDropdownHide, VegaSearchTrigger, VegaLabelButtonClick, VegaSelectFileChange, VegaRetry, VegaPreview, VegaFormSubmit, VegaFormReset, VegaValidate, VegaCancel, VegaNativeInputChange, VegaFocus, VegaBlur, VegaSuggestionItemClick, VegaPaste, VegaComplete, VegaCountryChange, VegaShow, VegaHide, VegaToggleStatus, VegaOpen, VegaStateUpdate, VegaGroupClick, VegaMenuClick, VegaActionClick, VegaPageSizeChange, VegaPopoverShow, VegaPopoverHide, VegaCurrentStepUpdate, VegaImageInserted, VegaSourceCodeChange, VegaSelectChange, VegaSelectAllChange, VegaRowClick, VegaRowExpand, VegaRowDragDrop, VegaRowSelect, VegaRowSelectAll, } from './vega-event-id';
+import { VegaExpand, VegaAdditionalLinkClick, VegaClick, VegaDropdownClick, VegaReset, VegaDropdownSearch, VegaClose, VegaActionButtonClick, VegaChange, VegaEventClick, VegaDateDblClick, VegaMoreActionClick, VegaDateClick, VegaEventEdit, VegaPageUpdate, VegaUserChange, VegaRemove, VegaCreate, VegaSearch, VegaMonthYearChange, VegaClear, VegaSelectionChange, VegaTodayClick, VegaDropdownShow, VegaDropdownHide, VegaSearchTrigger, VegaLabelButtonClick, VegaSelectFileChange, VegaRetry, VegaPreview, VegaFormSubmit, VegaFormReset, VegaValidate, VegaCancel, VegaNativeInputChange, VegaFocus, VegaBlur, VegaSuggestionItemClick, VegaPaste, VegaComplete, VegaCountryChange, VegaShow, VegaHide, VegaToggleStatus, VegaOpen, VegaStateUpdate, VegaGroupClick, VegaMenuClick, VegaActionClick, VegaPageSizeChange, VegaPopoverShow, VegaPopoverHide, VegaCurrentStepUpdate, VegaImageInserted, VegaSourceCodeChange, VegaSelectChange, VegaSelectAllChange, VegaRowClick, VegaRowExpand, VegaRowDragDrop, VegaRowSelect, VegaRowSelectAll, } from './vega-event-id';
 const entries = [
   ['vega-accordion', [VegaExpand]],
+  ['vega-app-footer', [VegaAdditionalLinkClick]],
   ['vega-app-header-button', [VegaClick, VegaDropdownClick, VegaReset, VegaDropdownSearch]],
   ['vega-banner', [VegaClose, VegaActionButtonClick]],
   ['vega-breadcrumb', [VegaClick]],
@@ -12,6 +13,7 @@ const entries = [
     'vega-calendar',
     [VegaChange, VegaEventClick, VegaDateDblClick, VegaMoreActionClick, VegaDateClick, VegaEventEdit],
   ],
+  ['vega-calendar-period-switcher', [VegaChange]],
   ['vega-carousel', [VegaPageUpdate]],
   ['vega-checkbox', [VegaChange, VegaUserChange]],
   ['vega-checkbox-group', [VegaChange, VegaUserChange]],

package/dist/collection/helpers/event-manager/event-id/vega-event-id.js

@@ -114,3 +114,4 @@ export const VegaSuggestionItemClick = new VegaEventID('vegaSuggestionItemClick'
 export const VegaNativeInputChange = new VegaEventID('vegaNativeInputChange', 'nativeInputChange');
 export const VegaSourceCodeChange = new VegaEventID('vegaSourceCodeChange', 'sourceCodeChange');
 export const VegaEventEdit = new VegaEventID('vegaEventEdit', 'eventEdit');
+export const VegaAdditionalLinkClick = new VegaEventID('vegaAdditionalLinkClick', 'additionalLinkClick');

package/dist/collection/helpers/event-manager/event-id/vega-internal-event-id.js

@@ -73,3 +73,4 @@ export const VegaInternalCodeBlockBlur = new VegaInternalEventID('codeBlockBlur'
 export const VegaInternalRTEExtensionTableCellsSelectionAnchor = new VegaInternalEventID('rteExtensionTableCellsSelectionAnchor');
 export const VegaInternalRTEExtensionTableCellSelectionChange = new VegaInternalEventID('rteExtensionTableCellSelectionChange');
 export const VegaInternalCalendarPreviewActionClick = new VegaInternalEventID('calendarPreviewActionClick');
+export const VegaInternalCurrentPeriodChange = new VegaInternalEventID('currentPeriodChange');

package/dist/collection/helpers/event-manager/vega-event-manager.js

@@ -14,7 +14,7 @@ import { VegaEventManagerRuntimeMetricsPayloadDefinition } from '../../constants
  */
 class VegaEventManager {
   constructor() {
-    this.vegaPublicAPIRuntimeMetricsSlimmer = createPublicAPIRuntimeMetricsSlimmer(VegaEventManager, ['setSemantics', 'getSemantics', 'getEnabledEventIdsByComponent'], VegaEventManagerRuntimeMetricsPayloadDefinition);
+    this.vegaPublicAPIRuntimeMetricsSlimmer = createPublicAPIRuntimeMetricsSlimmer(VegaEventManager, ['setSemantics', 'getSemantics', 'getEnabledEventIdsByComponent'], VegaEventManagerRuntimeMetricsPayloadDefinition, 'VegaEventManager');
   }
   /**
    * The function sets the semantics configuration for event management.

package/dist/collection/helpers/feature-control/feature-flags-map.js

@@ -215,5 +215,17 @@ const FeatureFlagsMap = {
     createdAtVersion: '2.76.0',
     disabledByDefault: false,
   },
+  'VEGA_FONT.LEGACY_LETTER_SPACING': {
+    description: `Feature flag to restore the legacy (positive) letter-spacing values on \`vega-font\` variants h1/h2/h3 as an opt-in safety net. The new (negative) values are now the default and reflect the source design tokens; enable this flag only if a consumer needs the legacy rendering during transition.`,
+    createdTimestamp: 1750564800000,
+    createdAtVersion: '2.91.0',
+    disabledByDefault: true,
+  },
+  'VEGA_REQUIRED_FIELD_RULE.TRIM_WHITESPACE': {
+    description: `Feature flag to enable trimming whitespace in required field validation. When enabled, strings containing only whitespace will be treated as empty and fail required validation.`,
+    createdTimestamp: 1749772800000,
+    createdAtVersion: '2.91.0',
+    disabledByDefault: true,
+  },
 };
 export default Object.freeze(FeatureFlagsMap);

package/dist/collection/helpers/icon/icon-manager.js

@@ -12,7 +12,7 @@ import { createPublicAPIRuntimeMetricsSlimmer } from '../slimmers/runtime-metric
  */
 class IconManager {
   constructor() {
-    this.vegaPublicAPIRuntimeMetricsSlimmer = createPublicAPIRuntimeMetricsSlimmer(IconManager, ['register', 'getIcon', 'hasIcon'], VegaIconManagerRuntimeMetricsPayloadDefinition);
+    this.vegaPublicAPIRuntimeMetricsSlimmer = createPublicAPIRuntimeMetricsSlimmer(IconManager, ['register', 'getIcon', 'hasIcon'], VegaIconManagerRuntimeMetricsPayloadDefinition, 'IconManager');
     this.icons = new Map();
   }
   /**

package/dist/collection/helpers/loading-indicator/vega-loader-controller.js

@@ -15,7 +15,7 @@ import { LogUtility } from '../../utils/log';
  */
 class VegaLoaderController {
   constructor() {
-    this.vegaPublicAPIRuntimeMetricsSlimmer = createPublicAPIRuntimeMetricsSlimmer(VegaLoaderController, ['load', 'close'], VegaLoaderRuntimeMetricsPayloadDefinition);
+    this.vegaPublicAPIRuntimeMetricsSlimmer = createPublicAPIRuntimeMetricsSlimmer(VegaLoaderController, ['load', 'close'], VegaLoaderRuntimeMetricsPayloadDefinition, 'VegaLoaderController');
   }
   /**
    * Create a loading indicator and append it to the container

package/dist/collection/helpers/notify/vega-notify-controller.js

@@ -33,7 +33,7 @@ class VegaNotifyController {
         target: () => this.container,
       },
     ]);
-    this.vegaPublicAPIRuntimeMetricsSlimmer = createPublicAPIRuntimeMetricsSlimmer(VegaNotifyController, ['open', 'close', 'closeAll'], VegaNotifyRuntimeMetricsPayloadDefinition);
+    this.vegaPublicAPIRuntimeMetricsSlimmer = createPublicAPIRuntimeMetricsSlimmer(VegaNotifyController, ['open', 'close', 'closeAll'], VegaNotifyRuntimeMetricsPayloadDefinition, 'VegaNotifyController');
   }
   /**
    * It creates a new notification element, adds it to the container, and returns the notification's ID

package/dist/collection/helpers/public-api.js

@@ -15,3 +15,4 @@ export { waitForVega } from './common';
 export { VegaSkeletonLoader } from './skeleton-loader/vega-skeleton-loader-controller';
 export { VegaTranslation, en as VegaTranslationResourceEN } from './translation';
 export { setVegaNonce } from './csp/vega-nonce-manager';
+export { VegaCalendarPeriodFactory } from './calendar';

package/dist/collection/helpers/skeleton-loader/vega-skeleton-loader-controller.js

@@ -13,7 +13,7 @@ import { createPublicAPIRuntimeMetricsSlimmer } from '../slimmers/runtime-metric
  */
 class VegaSkeletonLoaderController {
   constructor() {
-    this.vegaPublicAPIRuntimeMetricsSlimmer = createPublicAPIRuntimeMetricsSlimmer(VegaSkeletonLoaderController, ['load', 'unLoad', 'unLoadAll'], VegaSkeletonRuntimeMetricsPayloadDefinition);
+    this.vegaPublicAPIRuntimeMetricsSlimmer = createPublicAPIRuntimeMetricsSlimmer(VegaSkeletonLoaderController, ['load', 'unLoad', 'unLoadAll'], VegaSkeletonRuntimeMetricsPayloadDefinition, 'VegaSkeletonLoaderController');
     this.loaderMap = new Map();
   }
   /**

package/dist/collection/helpers/slimmers/runtime-metrics/create-public-api-runtime-metrics-slimmer.js

@@ -11,13 +11,14 @@ import { VegaPublicAPIRuntimeMetricsSlimmerBase } from './public-api-runtime-met
  * @param {unknown[]} [initData] - The `initData` parameter allows you to
  * pass an array of initial data to be used during the initialization of the component usage runtime
  * metrics slimmer.
+ * @param {string} [publicAPIName] - Stable public API name to emit in telemetry.
  * @returns {VegaPublicAPIRuntimeMetricsSlimmerBase} The function creates a dynamic public api runtime metrics slimmer.
  */
-export function createPublicAPIRuntimeMetricsSlimmer(mapFromClass, watchMethodNames, initData) {
+export function createPublicAPIRuntimeMetricsSlimmer(mapFromClass, watchMethodNames, initData, publicAPIName = mapFromClass.name) {
   const methodsMap = [];
   watchMethodNames.map((watchMethodName) => methodsMap.push({
     mapFrom: watchMethodName,
     mapTo: 'sendPublicAPIPayloadToTelemetry',
   }));
-  return createDynamicSlimmer(mapFromClass, VegaPublicAPIRuntimeMetricsSlimmerBase, [], methodsMap, [mapFromClass.name, initData]);
+  return createDynamicSlimmer(mapFromClass, VegaPublicAPIRuntimeMetricsSlimmerBase, [], methodsMap, [publicAPIName, initData]);
 }

package/dist/collection/helpers/theme/theme-manager.js

@@ -21,7 +21,7 @@ class ThemeManager {
       'isDarkMode',
       'applyBranding',
       'validateColorAccessibility',
-    ], ThemeManagerRuntimeMetricsPayloadDefinition);
+    ], ThemeManagerRuntimeMetricsPayloadDefinition, 'ThemeManager');
   }
   /**
    * It takes the colors you passed in, parses them into the correct format, and then applies them to the theme.

package/dist/collection/helpers/translation/locales/en.js

@@ -136,6 +136,9 @@ export const staticTranslations = {
   'Paragraph': 'Paragraph',
   'Reset Selection': 'Reset Selection',
   'Select Language': 'Select Language',
+  'Select language': 'Select language',
+  'Tokens': 'Tokens',
+  'Insert token': 'Insert token',
   'Functions': 'Functions',
   'Insert function': 'Insert function',
   'Conditional': 'Conditional',
@@ -188,5 +191,7 @@ export const staticTranslations = {
   'Required': 'Required',
   'Disabled': 'Disabled',
   'Optional': 'Optional',
+  'Previous': 'Previous',
+  'Next': 'Next',
 };
 export default staticTranslations;