@globalpayments/vega 2.87.0 → 2.89.0

package/dist/collection/components/vega-toggle-switch/vega-toggle-switch.js

@@ -63,6 +63,16 @@ export class VegaToggleSwitch {
      * @vegaVersion 2.25.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 whether the toggle switch is disabled.
      *
@@ -148,7 +158,7 @@ export class VegaToggleSwitch {
   }
   renderLabelDom() {
     return this.label ? (h("div", { class: "vega-flex-basis-0 vega-flex-grow" },
-      h("vega-field-label", { onClick: this.toggleSwitch, disabled: this.disabled, label: this.label, isFieldRequired: this.required }))) : null;
+      h("vega-field-label", { onClick: this.toggleSwitch, disabled: this.disabled, label: this.label, isFieldRequired: this.required, optional: this.optional }))) : null;
   }
   static get is() { return "vega-toggle-switch"; }
   static get encapsulation() { return "shadow"; }
@@ -263,6 +273,30 @@ export class VegaToggleSwitch {
       "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"
+    },
     "disabled": {
       "type": "boolean",
       "mutable": false,

package/dist/collection/constants/runtime-metrics-payload-definition/public-api/ThemeManager/runtime-metrics-payload-definition.js

@@ -3,7 +3,7 @@ export const ThemeManagerRuntimeMetricsPayloadDefinition = [
     payloadKey: 'IS_OVERRIDECOLORS_METHOD_CALLED',
     payloadDescription: 'Indicate if the method overrideColors of public API ThemeManager is called',
     /**
-     * Indicate whether the method is collected when the method been called .
+     * Indicate whether the method is collected when the method has been called.
      *
      * @param {string} scope - The class name of public api
      * @param {string} methodName - The method name called by the public api
@@ -11,7 +11,7 @@ export const ThemeManagerRuntimeMetricsPayloadDefinition = [
      */
     canAccept: (scope, methodName) => scope === 'ThemeManager' && methodName === 'overrideColors',
     /**
-     * The function checks if the method is be called.
+     * The function checks if the method has been called.
      *
      * @returns {boolean} A boolean value
      */
@@ -23,7 +23,7 @@ export const ThemeManagerRuntimeMetricsPayloadDefinition = [
     payloadKey: 'IS_RESET_METHOD_CALLED',
     payloadDescription: 'Indicate if the method reset of public API ThemeManager is called',
     /**
-     * Indicate whether the method is collected when the method been called .
+     * Indicate whether the method is collected when the method has been called.
      *
      * @param {string} scope - The class name of public api
      * @param {string} methodName - The method name called by the public api
@@ -31,7 +31,7 @@ export const ThemeManagerRuntimeMetricsPayloadDefinition = [
      */
     canAccept: (scope, methodName) => scope === 'ThemeManager' && methodName === 'reset',
     /**
-     * The function checks if the method is be called.
+     * The function checks if the method has been called.
      *
      * @returns {boolean} A boolean value
      */
@@ -43,7 +43,7 @@ export const ThemeManagerRuntimeMetricsPayloadDefinition = [
     payloadKey: 'IS_TOGGLEDARKMODE_METHOD_CALLED',
     payloadDescription: 'Indicate if the method toggleDarkMode of public API ThemeManager is called',
     /**
-     * Indicate whether the method is collected when the method been called .
+     * Indicate whether the method is collected when the method has been called.
      *
      * @param {string} scope - The class name of public api
      * @param {string} methodName - The method name called by the public api
@@ -51,7 +51,7 @@ export const ThemeManagerRuntimeMetricsPayloadDefinition = [
      */
     canAccept: (scope, methodName) => scope === 'ThemeManager' && methodName === 'toggleDarkMode',
     /**
-     * The function checks if the method is be called.
+     * The function checks if the method has been called.
      *
      * @returns {boolean} A boolean value
      */
@@ -63,7 +63,7 @@ export const ThemeManagerRuntimeMetricsPayloadDefinition = [
     payloadKey: 'IS_ISDARKMODE_METHOD_CALLED',
     payloadDescription: 'Indicate if the method isDarkMode of public API ThemeManager is called',
     /**
-     * Indicate whether the method is collected when the method been called .
+     * Indicate whether the method is collected when the method has been called.
      *
      * @param {string} scope - The class name of public api
      * @param {string} methodName - The method name called by the public api
@@ -71,7 +71,7 @@ export const ThemeManagerRuntimeMetricsPayloadDefinition = [
      */
     canAccept: (scope, methodName) => scope === 'ThemeManager' && methodName === 'isDarkMode',
     /**
-     * The function checks if the method is be called.
+     * The function checks if the method has been called.
      *
      * @returns {boolean} A boolean value
      */
@@ -83,7 +83,7 @@ export const ThemeManagerRuntimeMetricsPayloadDefinition = [
     payloadKey: 'IS_APPLY_BRANDING_METHOD_CALLED',
     payloadDescription: 'Indicate if the method applyBranding of public API ThemeManager is called',
     /**
-     * Indicate whether the method is collected when the method been called .
+     * Indicate whether the method is collected when the method has been called.
      *
      * @param {string} scope - The class name of public api
      * @param {string} methodName - The method name called by the public api
@@ -91,7 +91,27 @@ export const ThemeManagerRuntimeMetricsPayloadDefinition = [
      */
     canAccept: (scope, methodName) => scope === 'ThemeManager' && methodName === 'applyBranding',
     /**
-     * The function checks if the method is be called.
+     * The function checks if the method has been called.
+     *
+     * @returns {boolean} A boolean value
+     */
+    payloadValue: () => {
+      return true;
+    },
+  },
+  {
+    payloadKey: 'IS_VALIDATECOLORACCESSIBILITY_METHOD_CALLED',
+    payloadDescription: 'Indicate if the method validateColorAccessibility of public API ThemeManager is called',
+    /**
+     * Indicate whether the method is collected when the method has been called.
+     *
+     * @param {string} scope - The class name of public api
+     * @param {string} methodName - The method name called by the public api
+     * @returns {boolean} A boolean value
+     */
+    canAccept: (scope, methodName) => scope === 'ThemeManager' && methodName === 'validateColorAccessibility',
+    /**
+     * The function checks if the method has been called.
      *
      * @returns {boolean} A boolean value
      */

package/dist/collection/constants/ui.js

@@ -44,6 +44,7 @@ export const TextAlign = ['start', 'end', 'left', 'right', 'center', 'justify'];
 // eslint-disable-next-line @typescript-eslint/typedef
 export const VegaNativeEventName = [
   'change',
+  'userChange',
   'click',
   'focus',
   'blur',
@@ -105,6 +106,7 @@ export const VegaNativeEventName = [
   'sourceCodeChange',
   'rowDragDrop',
   'eventEdit',
+  'todayClick',
 ];
 // eslint-disable-next-line @typescript-eslint/typedef
 export const CssStates = ['default', 'hover', 'active', 'focus-visible'];

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

@@ -25,6 +25,11 @@ 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 { VegaRTEHorizontalLineExtension } from '../../components/vega-rich-text-editor/extensions/horizontal-line/horizontal-line-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 +201,18 @@ function injectVegaRichTextEditorClassIntoGlobal() {
   globalThis.VegaRTETokenExtension = VegaRTETokenExtension;
   globalThis.VegaRTELanguageExtension = VegaRTELanguageExtension;
   globalThis.VegaRTEPresetToolbarItems = VegaRTEPresetToolbarItems;
+  globalThis.VegaRTEDefaultLineHeightOptions = VegaRTEDefaultLineHeightOptions;
   globalThis.VegaRTEFunctionExtension = VegaRTEFunctionExtension;
   globalThis.VegaRTETableExtension = VegaRTETableExtension;
+  globalThis.VegaRTEHorizontalLineExtension = VegaRTEHorizontalLineExtension;
+  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/change-manager/subject/static-subject/static-subject-title.js

@@ -15,6 +15,7 @@ export const TABLE_ROW_CLICK = new StaticSubject('TABLE_ROW_CLICK');
 export const FIELD_ERROR_MESSAGE_CHANGE = new StaticSubject('FIELD_ERROR_MESSAGE_CHANGE');
 export const DROPDOWN_ITEM_CLICK = new StaticSubject('DROPDOWN_ITEM_CLICK');
 export const CHECKBOX_VALUE_CHANGE = new StaticSubject('CHECKBOX_VALUE_CHANGE');
+export const CHECKBOX_USER_INTERACTION = new StaticSubject('CHECKBOX_USER_INTERACTION');
 export const RADIO_VALUE_CHANGE = new StaticSubject('RADIO_VALUE_CHANGE');
 export const FORM_ELEMENT_VALUE_CHANGE = new StaticSubject('FORM_ELEMENT_VALUE_CHANGE');
 export const FORM_ELEMENT_VALIDATE = new StaticSubject('FORM_EMEMENT_VALIDATE');

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, 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-header-button', [VegaClick, VegaDropdownClick, VegaReset, VegaDropdownSearch]],
@@ -13,8 +13,8 @@ const entries = [
     [VegaChange, VegaEventClick, VegaDateDblClick, VegaMoreActionClick, VegaDateClick, VegaEventEdit],
   ],
   ['vega-carousel', [VegaPageUpdate]],
-  ['vega-checkbox', [VegaChange]],
-  ['vega-checkbox-group', [VegaChange]],
+  ['vega-checkbox', [VegaChange, VegaUserChange]],
+  ['vega-checkbox-group', [VegaChange, VegaUserChange]],
   ['vega-chip', [VegaClose, VegaClick]],
   ['vega-code-block', [VegaChange, VegaRemove]],
   ['vega-color-picker', [VegaChange]],
@@ -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

@@ -53,6 +53,7 @@ export class VegaEventID {
   }
 }
 export const VegaChange = new VegaEventID('vegaChange', 'change');
+export const VegaUserChange = new VegaEventID('vegaUserChange', 'userChange');
 export const VegaClick = new VegaEventID('vegaClick', 'click');
 export const VegaFocus = new VegaEventID('vegaFocus', 'focus');
 export const VegaBlur = new VegaEventID('vegaBlur', 'blur');
@@ -108,6 +109,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,15 @@ export const staticTranslations = {
   'Color {0}': 'Color {0}',
   'Apply': 'Apply',
   'Enter color': 'Enter color',
+  'Horizontal line': 'Horizontal line',
+  'Special Characters': 'Special Characters',
+  'All': 'All',
+  'Latin': 'Latin',
+  'Mathematical': 'Mathematical',
+  'Arrows': 'Arrows',
+  'Currency': 'Currency',
+  'Required': 'Required',
+  'Disabled': 'Disabled',
+  'Optional': 'Optional',
 };
 export default staticTranslations;