@globalpayments/vega 2.87.0 → 2.88.0

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

@@ -25,6 +25,10 @@ import { VegaRTELanguageExtension } from '../../components/vega-rich-text-editor
 import { VegaRTEPresetToolbarItems } from '../../components/vega-rich-text-editor/constants/constant';
 import { VegaRTEFunctionExtension } from '../../components/vega-rich-text-editor/extensions/functions/function-extension';
 import { VegaRTETableExtension } from '../../components/vega-rich-text-editor/extensions/table/table-extension';
+import { VegaRTESpecialCharactersExtension } from '../../components/vega-rich-text-editor/extensions/special-characters/special-characters-extension';
+import { VegaRTESpecialCharactersEssentials, VegaRTESpecialCharactersLatin, VegaRTESpecialCharactersMathematical, VegaRTESpecialCharactersArrows, VegaRTESpecialCharactersCurrency, VegaRTESpecialCharactersText, } from '../../components/vega-rich-text-editor/extensions/special-characters/constants/default-categories';
+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';
 /**
  * Default export function that will be used by stencil global script,
  * which will be invoked before library loaded.
@@ -196,8 +200,17 @@ function injectVegaRichTextEditorClassIntoGlobal() {
   globalThis.VegaRTETokenExtension = VegaRTETokenExtension;
   globalThis.VegaRTELanguageExtension = VegaRTELanguageExtension;
   globalThis.VegaRTEPresetToolbarItems = VegaRTEPresetToolbarItems;
+  globalThis.VegaRTEDefaultLineHeightOptions = VegaRTEDefaultLineHeightOptions;
   globalThis.VegaRTEFunctionExtension = VegaRTEFunctionExtension;
   globalThis.VegaRTETableExtension = VegaRTETableExtension;
+  globalThis.VegaRTESpecialCharactersExtension = VegaRTESpecialCharactersExtension;
+  globalThis.VegaRTESpecialCharactersEssentials = VegaRTESpecialCharactersEssentials;
+  globalThis.VegaRTESpecialCharactersLatin = VegaRTESpecialCharactersLatin;
+  globalThis.VegaRTESpecialCharactersMathematical = VegaRTESpecialCharactersMathematical;
+  globalThis.VegaRTESpecialCharactersArrows = VegaRTESpecialCharactersArrows;
+  globalThis.VegaRTESpecialCharactersCurrency = VegaRTESpecialCharactersCurrency;
+  globalThis.VegaRTESpecialCharactersText = VegaRTESpecialCharactersText;
+  globalThis.VegaRTELineHeightExtension = VegaRTELineHeightExtension;
 }
 /**
  * Inject VegaPublicValidationRules to global as a public api

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

@@ -1,4 +1,4 @@
-import { VegaExpand, VegaClick, VegaDropdownClick, VegaReset, VegaDropdownSearch, VegaClose, VegaActionButtonClick, VegaChange, VegaEventClick, VegaDateDblClick, VegaMoreActionClick, VegaDateClick, VegaEventEdit, VegaPageUpdate, VegaRemove, VegaCreate, VegaSearch, VegaMonthYearChange, VegaClear, VegaSelectionChange, 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, VegaClick, VegaDropdownClick, VegaReset, VegaDropdownSearch, VegaClose, VegaActionButtonClick, VegaChange, VegaEventClick, VegaDateDblClick, VegaMoreActionClick, VegaDateClick, VegaEventEdit, VegaPageUpdate, 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-header-button', [VegaClick, VegaDropdownClick, VegaReset, VegaDropdownSearch]],
@@ -22,7 +22,7 @@ const entries = [
   ['vega-color-swatch-picker', [VegaChange]],
   ['vega-combo-box', [VegaChange, VegaCreate, VegaSearch]],
   ['vega-date-picker', [VegaChange, VegaMonthYearChange]],
-  ['vega-date-picker-calendar', [VegaClear, VegaMonthYearChange, VegaSelectionChange]],
+  ['vega-date-picker-calendar', [VegaClear, VegaMonthYearChange, VegaSelectionChange, VegaTodayClick]],
   [
     'vega-dropdown',
     [

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

@@ -108,6 +108,7 @@ export const VegaPaste = new VegaEventID('vegaPaste', 'paste');
 export const HTMLNativeEventIds = [VegaChange, VegaClick, VegaFocus, VegaBlur, VegaPaste];
 export const VegaMonthYearChange = new VegaEventID('vegaMonthYearChange', 'monthYearChange');
 export const VegaSelectionChange = new VegaEventID('vegaSelectionChange', 'selectionChange');
+export const VegaTodayClick = new VegaEventID('vegaTodayClick', 'todayClick');
 export const VegaSuggestionItemClick = new VegaEventID('vegaSuggestionItemClick', 'suggestionItemClick');
 export const VegaNativeInputChange = new VegaEventID('vegaNativeInputChange', 'nativeInputChange');
 export const VegaSourceCodeChange = new VegaEventID('vegaSourceCodeChange', 'sourceCodeChange');

package/dist/collection/helpers/slimmers/component-value-history-controller-slimmer.abstract.js

@@ -8,6 +8,7 @@ export class ComponentValueHistoryControllerSlimmer extends KeyboardManagerSlimm
     super(() => this.getKeyboardShortcutOptions.call(this));
     this.redoStack = [];
     this.undoStack = [];
+    this.hasPendingHistory = false;
     this.registerHistoryDelay = 300;
     this.registerHistoryDebounced = debounce((state) => {
       this.internalRegisterHistory(state);
@@ -25,9 +26,27 @@ export class ComponentValueHistoryControllerSlimmer extends KeyboardManagerSlimm
       this.internalRegisterHistory(editorState);
     }
     else {
+      this.hasPendingHistory = true;
+      this.redoStack = [];
       this.registerHistoryDebounced(editorState);
     }
   }
+  /**
+   * Checks whether the undo stack has a previous state to restore.
+   *
+   * @returns {boolean} - True if undo is available.
+   */
+  canUndo() {
+    return this.undoStack.length > 1 || this.hasPendingHistory;
+  }
+  /**
+   * Checks whether the redo stack has a state to restore.
+   *
+   * @returns {boolean} - True if redo is available.
+   */
+  canRedo() {
+    return this.redoStack.length > 0;
+  }
   /**
    * Internal function to register history immediately.
    *
@@ -35,6 +54,7 @@ export class ComponentValueHistoryControllerSlimmer extends KeyboardManagerSlimm
    * @param {T} state - The state to record in history.
    */
   internalRegisterHistory(state) {
+    this.hasPendingHistory = false;
     this.redoStack = []; // clear redo stack when new action happens.
     this.undoStack.push(state);
   }
@@ -60,7 +80,7 @@ export class ComponentValueHistoryControllerSlimmer extends KeyboardManagerSlimm
          */
         callback: (e) => {
           e.preventDefault();
-          if (this.undoStack.length > 0) {
+          if (this.canUndo()) {
             void this.undo();
           }
         } }),
@@ -72,7 +92,7 @@ export class ComponentValueHistoryControllerSlimmer extends KeyboardManagerSlimm
          */
         callback: (e) => {
           e.preventDefault();
-          if (this.redoStack.length > 0) {
+          if (this.canRedo()) {
             void this.redo();
           }
         } }),

package/dist/collection/helpers/theme/controllers/action-color-accessibility-validator.js

@@ -0,0 +1,34 @@
+// Thin wrapper around `vega-color-token-contrast-checker/core`. The
+// runtime package is theme-system-agnostic; this file wires it up to vega-stencil's
+// concrete inputs:
+//   • `LightModeColorTokens` (the static surface-token table generated by vega-design)
+//   • `VegaColorSchemaOverridingController.generateOverrideThemes(...)` (the
+//     actionColor-derived override list)
+//
+// The checker encapsulates everything actionColor-related (hex validation,
+// suggestion search, contrast-cap patching) — wiring is just the two consumer-
+// supplied dependencies above.
+//
+// LAZY-LOADING CONTRACT: This module is dynamic-imported by
+// `internal-theme-manager.ts` so the contrast-check code path is split out of the
+// main bundle. Keep the import graph below light — anything that bloats the bundle
+// should live behind another dynamic import or in the runtime package itself.
+import { VegaColorTokenContrastChecker } from 'vega-color-token-contrast-checker/core';
+import { LightModeColorTokens } from '../../../constants/tokens/themes/v2-new-brand/light-mode-color-tokens';
+import { VegaColorSchemaOverridingController } from './color-schema-overriding-controller';
+/**
+ * Process-lifetime singleton: a {@link VegaColorTokenContrastChecker} pre-bound
+ * to vega-stencil's design-token table and override-themes generator. Consumers
+ * call `.validate(overrideColors)` and `.computeContrastCapPatches(overrideColors)`
+ * directly — no per-call configuration needed.
+ */
+export const vegaAccessibilityValidator = new VegaColorTokenContrastChecker({
+  fixedSurfaceTokens: LightModeColorTokens,
+  /**
+   * Generate override theme arrays from the supplied override colors.
+   *
+   * @param {VegaThemeOverrideColors} overrideColors The override colors input.
+   * @returns {ReturnType<typeof VegaColorSchemaOverridingController.generateOverrideThemes>} The override theme arrays.
+   */
+  generateOverrideThemes: (overrideColors) => VegaColorSchemaOverridingController.generateOverrideThemes(overrideColors),
+});

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

@@ -12,13 +12,20 @@ class InternalThemeManager {
     this.currentBranding = 'heartland';
   }
   /**
-   * It takes the colors you passed in, parses them into the correct format, and then applies them to the theme
+   * It takes the colors you passed in, parses them into the correct format, and then applies them to the theme.
+   *
+   * When `overrideColors.overrideTokenMap` is provided (typically the `contrastCapPatches`
+   * returned by `validateColorAccessibility()`), matching tokens in the generated theme are replaced
+   * with the patched values before applying.
    *
    * @param {VegaThemeOverrideColors} overrideColors - OverrideColors - This is the object that you pass to the function.
    */
   overrideColors(overrideColors) {
     const overrideThemes = VegaColorSchemaOverridingController.generateOverrideThemes(overrideColors);
-    VegaColorSchemaOverridingController.applyTheme(overrideThemes);
+    const finalThemes = overrideColors.overrideTokenMap
+      ? this.applyTokenMapPatches(overrideThemes, overrideColors.overrideTokenMap)
+      : overrideThemes;
+    VegaColorSchemaOverridingController.applyTheme(finalThemes);
   }
   /**
    * It removes all the custom override theme styles from the DOM
@@ -71,5 +78,35 @@ class InternalThemeManager {
     this.currentBranding = options;
     ChangeManager.notify(GP_BRAND_CHANGE, options);
   }
+  /**
+   * Validate a full `VegaThemeOverrideColors` payload against WCAG 2.1 AA thresholds
+   * without applying any theme changes.
+   *
+   * Reports each failing token (those fixable by choosing a different `actionColor`) with
+   * its actual and required contrast ratios. Also returns `contrastCapPatches` — a map of
+   * token-level repairs for tokens whose formula hard-caps contrast below the threshold.
+   * Pass the patches back via `overrideColors({ ..., overrideTokenMap: result.contrastCapPatches })`
+   * to apply them at override time.
+   *
+   * @param {VegaThemeOverrideColors} overrideColors The same input accepted by `overrideColors()`
+   * @returns {Promise<ActionColorAccessibilityResult>} Per-token contrast report with patches
+   */
+  async validateColorAccessibility(overrideColors) {
+    const validatorModule = await import('./controllers/action-color-accessibility-validator');
+    return validatorModule.vegaAccessibilityValidator.validate(overrideColors);
+  }
+  /**
+   * Replace tokens in the generated theme array with values from the provided patch map.
+   *
+   * @param {OverrideColor[]} themes - Generated override theme entries.
+   * @param {Record<string, string>} patchMap - Token name → patched CSS value map.
+   * @returns {OverrideColor[]} Theme array with matching tokens patched.
+   */
+  applyTokenMapPatches(themes, patchMap) {
+    if (Object.keys(patchMap).length === 0) {
+      return themes;
+    }
+    return themes.map((theme) => patchMap[theme.name] !== undefined ? { name: theme.name, value: patchMap[theme.name] } : theme);
+  }
 }
 export const VegaInternalThemeManager = new InternalThemeManager();

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

@@ -14,10 +14,21 @@ import { VegaInternalThemeManager } from './internal-theme-manager';
  */
 class ThemeManager {
   constructor() {
-    this.vegaPublicAPIRuntimeMetricsSlimmer = createPublicAPIRuntimeMetricsSlimmer(ThemeManager, ['overrideColors', 'reset', 'toggleDarkMode', 'isDarkMode', 'applyBranding'], ThemeManagerRuntimeMetricsPayloadDefinition);
+    this.vegaPublicAPIRuntimeMetricsSlimmer = createPublicAPIRuntimeMetricsSlimmer(ThemeManager, [
+      'overrideColors',
+      'reset',
+      'toggleDarkMode',
+      'isDarkMode',
+      'applyBranding',
+      'validateColorAccessibility',
+    ], ThemeManagerRuntimeMetricsPayloadDefinition);
   }
   /**
-   * It takes the colors you passed in, parses them into the correct format, and then applies them to the theme
+   * It takes the colors you passed in, parses them into the correct format, and then applies them to the theme.
+   *
+   * When `overrideColors.overrideTokenMap` is provided (typically the `contrastCapPatches`
+   * returned by `validateColorAccessibility()`), matching tokens in the generated theme are replaced
+   * with the patched values before applying.
    *
    * @param {VegaThemeOverrideColors} overrideColors - OverrideColors - This is the object that you pass to the function.
    * @vegaVersion 1.20.0
@@ -63,6 +74,26 @@ class ThemeManager {
   applyBranding(options) {
     VegaInternalThemeManager.applyBranding(options);
   }
+  /**
+   * Validate a full override-color payload against WCAG 2.1 AA thresholds (light mode only)
+   * without applying any theme changes.
+   *
+   * Returns per-token contrast details, a suggested accessible `actionColor`, and
+   * `contrastCapPatches` — token-level repairs for tokens whose formula hard-caps contrast
+   * below the threshold. Pass the patches back via
+   * `overrideColors({ ..., overrideTokenMap: result.contrastCapPatches })` to apply them.
+   *
+   * Note: Only `actionColor`-driven tokens are validated. `sidebarColor` tokens are not
+   * evaluated by this method. The `actionColor` value must be a 3- or 6-digit hex string
+   * (with optional leading `#`).
+   *
+   * @param {VegaThemeOverrideColors} overrideColors The same payload passed to `overrideColors()`
+   * @returns {Promise<ActionColorAccessibilityResult>} Per-token contrast report with patches
+   * @vegaVersion 2.88.0
+   */
+  async validateColorAccessibility(overrideColors) {
+    return VegaInternalThemeManager.validateColorAccessibility(overrideColors);
+  }
 }
 __decorate([
   InjectVegaTelemetrySlimmer()

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

@@ -106,6 +106,7 @@ export const staticTranslations = {
   'Center Align': 'Center Align',
   'Right Align': 'Right Align',
   'Justified': 'Justified',
+  'Line Height': 'Line Height',
   'Bullets': 'Bullets',
   'Numbers': 'Numbers',
   'More Indent': 'More Indent',
@@ -173,5 +174,12 @@ export const staticTranslations = {
   'Color {0}': 'Color {0}',
   'Apply': 'Apply',
   'Enter color': 'Enter color',
+  'Special Characters': 'Special Characters',
+  'All': 'All',
+  'Latin': 'Latin',
+  'Mathematical': 'Mathematical',
+  'Arrows': 'Arrows',
+  'Currency': 'Currency',
+  '(Optional)': '(Optional)',
 };
 export default staticTranslations;