@globalpayments/vega 2.41.0 → 2.42.0

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

@@ -48,7 +48,7 @@ export class VegaPublicAPIRuntimeMetricsSlimmerBase extends VegaSlimmer {
    * The `CurrentlyInvokedMethodName` is a public API method name, it comes from the `InjectVegaTelemetrySlimmer` definition and assignment
    *
    * @param {unknown[]} [args] - The `args` parameter passed in when the slimmer method is executed
-   * @returns {Record<string, unknown>} The `getPublicAPIMetricsPayload` method returns an object with the following
+   * @returns {Nullable<Record<string, unknown>>} The `getPublicAPIMetricsPayload` method returns an object with the following
    * structure:
    * {
    * 	publicAPIName: string, // The public api name

package/dist/collection/helpers/theme/controllers/color-schema-overriding-controller.js

@@ -64,7 +64,7 @@ class ColorSchemaOverridingController {
    *
    * @param {OverridableToken} overrideColorToken The token will be overridden
    * @param {VegaThemeOverrideColors} overrideColors the payload of override colors
-   * @returns {string} The css var value
+   * @returns {Nullable<string>} The css var value
    */
   parseCssVarValue(overrideColorToken, overrideColors) {
     var _a;

package/dist/collection/helpers/touch-helper/touch-listener.js

@@ -44,7 +44,7 @@ export class TouchListener {
    * @param {number} startY - The y-coordinate of the touch start event.
    * @param {number} endX - The x coordinate of the touch end event.
    * @param {number} endY - the y coordinate of the touch event.
-   * @returns {{ direction: TouchDirection; distance: number }} The direction and distance of the touch.
+   * @returns {TouchDirectionAndDistanceType} The direction and distance of the touch.
    */
   static getTouchDirectionAndDistance(startX, startY, endX, endY) {
     const delX = endX - startX;
@@ -66,7 +66,7 @@ export class TouchListener {
    * Get the coordinates of a touch event
    *
    * @param {TouchEvent} event - The event object that was passed to the handler.
-   * @returns {{ x: number; y: number }} The coordinates of the touch event.
+   * @returns {TouchEventCoordinatesType} The coordinates of the touch event.
    */
   static getTouchEventCoordinates(event) {
     return { x: event.changedTouches[0].screenX, y: event.changedTouches[0].screenY };

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

@@ -23,6 +23,7 @@ export const staticTranslations = {
   'Show': 'Show',
   'Go To': 'Go To',
   'Viewing {0}-{1} of {2}': 'Viewing {0}-{1} of {2}',
+  'Items Per Page': 'Items Per Page',
   'Upload': 'Upload',
   'Clear': 'Clear',
   'Today': 'Today',

package/dist/collection/helpers/translation/tests/internal-translation-controller.test.js

@@ -113,6 +113,7 @@ describe('VegaTranslationController', () => {
       'Show': 'Show',
       'Go To': 'Go To',
       'Viewing {0}-{1} of {2}': 'Viewing {0}-{1} of {2}',
+      'Items Per Page': 'Items Per Page',
       'Upload': 'Upload',
       'Clear': 'Clear',
       'Today': 'Today',

package/dist/collection/helpers/ui/element-appender.js

@@ -9,7 +9,7 @@ import InternalVegaZIndexManager from '../zindex/internal-vega-z-index-manager';
 import { LogUtility } from '../../utils/log';
 import { InjectVegaSlimmer, createDynamicSlimmer, methodPlaceholder } from 'vega-slimmer/core';
 import { PageResizeObserverSlimmer } from '../slimmers/page-resize-observer-slimmer';
-import { ElementAppenderContainerController } from '../slimmers/element-appender-container/element-appender-container-controller';
+import { ElementAppenderContainerController } from '../slimmers/element-appender/element-appender-container-controller';
 import { PositionCalculationController } from '../slimmers/position-calculation/position-calculation-controller';
 /**
  * This class is responsible for attaching the appendable element to the host element and adjusting its position

package/dist/collection/helpers/validator/form-field-controller.js

@@ -150,7 +150,8 @@ export class FormFieldController {
   /**
    * It returns an array of all the validation rules for the field
    *
-   * @returns {FormFieldValidationRule<number | string | boolean>[]} An array of FormFieldValidationRule<T>
+   * @typedef T generic type
+   * @returns {FormFieldValidationRule<T>[]} An array of FormFieldValidationRule<T>
    */
   getRules() {
     const additionalRules = [...this.additionalRules];
@@ -319,7 +320,7 @@ export class FormFieldController {
   /**
    * Get the input container element based on the options provided.
    *
-   * @returns {HTMLElement} the form field element input container element
+   * @returns {Nullable<HTMLElement>} the form field element input container element
    */
   getInputContainerElements() {
     return this.options && this.options.inputContainerGetter ? this.options.inputContainerGetter() : null;
@@ -451,9 +452,10 @@ export class FormFieldController {
    * If it does, it returns that additional rule, and the rule will be removed from the additional rules array.
    * otherwise, it returns the default rule.
    *
+   * @typedef T generic type
    * @param {InternalFormFieldValidationRule} defaultRule - The rule to be overridden.
    * @param {FormFieldValidationRule[]} additionalRules - The additional rules to be applied.
-   * @returns {FormFieldValidationRule} The overridden rule.
+   * @returns {FormFieldValidationRule<T>} The overridden rule.
    */
   overrideDefaultRuleByAdditionalRule(defaultRule, additionalRules) {
     if (defaultRule && additionalRules) {

package/dist/collection/polyfill/shadow-selection/shadow-selection-polyfill.js

@@ -68,7 +68,7 @@ export class ShadowSelectionPolyfill {
    * For browser which supported shadowroot.getSelection, we use shadowRoot.getselection().
    *
    * @param {ShadowRoot} shadow - A shadow.
-   * @returns {Selection} - The shadow selection.
+   * @returns {Nullable<Selection>} - The shadow selection.
    */
   getSelection(shadow) {
     if (this.supportShadowSelection) {

package/dist/collection/utils/api.js

@@ -5,9 +5,10 @@ export class ApiUtil {
   /**
    * It returns a promise that resolves to a JSON object of type T
    *
+   * @typedef T generic type
    * @param {string} url - The url to make the request to.
    * @param {HeadersInit} headers - HeadersInit
-   * @returns {Promise}A promise of type T
+   * @returns {Promise<T>}A promise of type T
    */
   static async get(url, headers) {
     return await ApiUtil.getResponseInJSON(url, 'GET', headers, undefined);
@@ -16,10 +17,11 @@ export class ApiUtil {
    * It takes a URL, a method, some headers, and some data, and returns a promise that resolves to the
    * response in JSON format
    *
+   * @typedef T generic type
    * @param {string} url - The URL to make the request to.
    * @param {unknown} data - The data to send to the server.
    * @param {HeadersInit} headers - HeadersInit
-   * @returns {Promise} A promise that resolves to the response in JSON format.
+   * @returns {Promise<T>} A promise that resolves to the response in JSON format.
    */
   static async post(url, data, headers) {
     return await ApiUtil.getResponseInJSON(url, 'POST', headers, JSON.stringify(data));
@@ -28,12 +30,13 @@ export class ApiUtil {
    * It takes a URL, a method, a set of headers, and an optional body, and returns a promise that
    * resolves to a JSON object
    *
+   * @typedef T generic type
    * @param {string} url - The URL to send the request to.
    * @param {string} method - The HTTP method to use.
    * @param {HeadersInit} headers - HeadersInit - This is the headers that will be sent with the
    * request.
    * @param {string} [body] - The body of the request.
-   * @returns {Promise} A promise that resolves to a JSON object.
+   * @returns {Promise<T>} A promise that resolves to a JSON object.
    */
   static async getResponseInJSON(url, method, headers, body) {
     if (headers) {

package/dist/collection/utils/array.js

@@ -75,7 +75,7 @@ export function getLongestTextLengthFromArray(textArray) {
  * revertArrayFromFlatArray([1,2,3,4,5,6],[])
  * @param {T[]} flatArr - an array of elements that have been flattened into a single array.
  * @param {T[]} lengthArr - `lengthArr` is an array of numbers that specifies the length of each sub-array that the `flatArr`
- * @returns {T[]|T[][]} The function `revertArrayFromFlatArray` returns either a single-dimensional array of type `T[]` or a two-dimensional array of type `T[][]`
+ * @returns {T[] | T[][]} The function `revertArrayFromFlatArray` returns either a single-dimensional array of type `T[]` or a two-dimensional array of type `T[][]`
  */
 export function convertArrayToNestedArray(flatArr, lengthArr) {
   if (lengthArr.length) {
@@ -133,7 +133,7 @@ export function sortArrayOrNestedArray(data, sortBy) {
  * @param {string[]} [existArray] - The `existArray` parameter is an optional array of strings that
  * represents the desired order of the elements in the `needSortArray`. If provided, the function will
  * sort the elements in `needSortArray` based on their position in `existArray`. If not provided, the default exist array will use the default order of the array
- * @returns {unknown[] | unknown[][]} The function `sortAsExistArray` returns a sorted array or nested array of type `T[] |
+ * @returns {T[] | T[][]} The function `sortAsExistArray` returns a sorted array or nested array of type `T[] |
  * T[][]`. The sorting is based on the order of elements in the `existArray` parameter, or if
  * `existArray` is not provided, it is based on the order of appearance of elements in the input array
  * or nested array. The sorting is done using the `sortArrayOrNested

package/dist/collection/utils/breakpoints.js

@@ -32,8 +32,9 @@ export const getCurrentBreakpoint = () => {
  *   XL: 'size-24',
  * }
  *
+ * @typedef T generic type
  * @param {ResponsiveType<ResponsiveScope>} breakpoints - responsive token
- * @returns {ResponsiveType<ResponsiveScope>} - completed breakpointss
+ * @returns {ResponsiveType<T>} - completed breakpointss
  */
 export const createCompleteResponsiveMap = (breakpoints) => {
   let responsiveScope;

package/dist/collection/utils/design-token.js

@@ -38,7 +38,7 @@ function formatTokenWithModes(token, modes) {
  * If the token is a valid spacing token, return the CSS class string. Otherwise, log an error message
  *
  * @param {unknown} token - The value that was passed into the function.
- * @returns {string} The the CSS class string of the padding token.
+ * @returns {Nullable<string>} The the CSS class string of the padding token.
  */
 export function formatAndValidPadding(token) {
   if (isSpacingTokenType(token)) {
@@ -53,7 +53,7 @@ export function formatAndValidPadding(token) {
  * a valid border style type, otherwise it logs an invalid value message.
  *
  * @param {unknown} token - The `token` parameter is a value that represents a border style type.
- * @returns {string} The function `formatAndValidBorderStyle` returns a string that is formatted as
+ * @returns {Nullable<string>} The function `formatAndValidBorderStyle` returns a string that is formatted as
  * `v-border-` if the `token` parameter is of a valid border style type. If the `token` is not
  * a valid border style type, it logs an invalid value message and does not return anything (implicitly
  * returns `undefined`).
@@ -71,7 +71,7 @@ export function formatAndValidBorderStyle(token) {
  * error message
  *
  * @param {unknown} token - The value passed in by the user.
- * @returns {string} The the CSS class string of the border radius token.
+ * @returns {Nullable<string>} The the CSS class string of the border radius token.
  */
 export function formatAndValidBorderRadius(token) {
   if (isBorderRadiusTokenType(token)) {
@@ -85,7 +85,7 @@ export function formatAndValidBorderRadius(token) {
  * If the token is a valid border color, return CSS class string of the border color. Otherwise, log an error message
  *
  * @param {unknown} token - The value passed in by the user.
- * @returns {string}  return the CSS class string of the border color
+ * @returns {Nullable<string>}  return the CSS class string of the border color
  */
 export function formatAndValidBorderColor(token) {
   if (isBorderColorTokenType(token)) {
@@ -99,7 +99,7 @@ export function formatAndValidBorderColor(token) {
  * If the token is a valid border, return CSS class string of the border. Otherwise, log an error message
  *
  * @param {unknown} token - The value passed in by the user.
- * @returns {string}  return the CSS class string of the border
+ * @returns {Nullable<string>}  return the CSS class string of the border
  */
 export function formatAndValidBorder(token) {
   if (isBorderTokenType(token)) {
@@ -114,7 +114,7 @@ export function formatAndValidBorder(token) {
  *
  * @param {unknown} token - The value of the token.
  * @param {TokenMode[]} withModes - TokenMode[] = []
- * @returns {string} CSS class string for the background color token with modes supported.
+ * @returns {Nullable<string>} CSS class string for the background color token with modes supported.
  */
 export function formatAndValidBackgroundColor(token, withModes = []) {
   if (isBackgroundColorTokenType(token)) {
@@ -130,7 +130,7 @@ export function formatAndValidBackgroundColor(token, withModes = []) {
  *
  * @param {unknown} token - The token to format.
  * @param {TokenMode[]} withModes - TokenMode[] = []
- * @returns {string} A CSS class string that is either a valid color or a valid color with modes.
+ * @returns {Nullable<string>} A CSS class string that is either a valid color or a valid color with modes.
  */
 export function formatAndValidTextColor(token, withModes = []) {
   if (isTextColorTokenType(token)) {
@@ -144,7 +144,7 @@ export function formatAndValidTextColor(token, withModes = []) {
  * If the token is a valid breakpoint, return CSS class string for the flex breakpoint. Otherwise, log an error
  *
  * @param {unknown} token - The value of the breakpoint.
- * @returns {string} CSS class string for the flex breakpoint.
+ * @returns {Nullable<string>} CSS class string for the flex breakpoint.
  */
 export function formatAndValidFlexBreakpoint(token) {
   if (isBreakpointsTokenType(token)) {
@@ -158,7 +158,7 @@ export function formatAndValidFlexBreakpoint(token) {
  * If the token is a breakpoint, return the breakpoint value. Otherwise, log an error and return 0
  *
  * @param {unknown} token - The value passed in by the user.
- * @returns {number} value of the breakpoint.
+ * @returns {Nullable<number>} value of the breakpoint.
  */
 export function formatAndValidBreakpointSize(token) {
   if (isBreakpointsTokenType(token)) {
@@ -173,7 +173,7 @@ export function formatAndValidBreakpointSize(token) {
  * error message
  *
  * @param {unknown} token - The value passed in by the user.
- * @returns {string} CSS class string for the given gap token.
+ * @returns {Nullable<string>} CSS class string for the given gap token.
  */
 export function formatAndValidGap(token) {
   if (isSpacingTokenType(token)) {
@@ -188,7 +188,7 @@ export function formatAndValidGap(token) {
  *
  * @param {string} token - The token to format.
  * @param {TokenMode[]} withModes - TokenMode[] = []
- * @returns {string} CSS class string of the shadow token with modes supported
+ * @returns {Nullable<string>} CSS class string of the shadow token with modes supported
  */
 export function formatAndValidShadow(token, withModes = []) {
   if (isShadowsTokenType(token)) {
@@ -204,7 +204,7 @@ export function formatAndValidShadow(token, withModes = []) {
  * @typedef Flag key of ManagedResponsiveScopeInput
  * @param {ResponsiveType<ManagedResponsiveScopeInput[Flag]>} token - The token to format.
  * @param {Flag} flag - The flag that the token is being formatted for.
- * @returns {Nullable<string>} A nullable string
+ * @returns {Nullable<ManagedResponsiveScopeOutput[Flag]>} A nullable string
  */
 export function formatAndValidResponsiveToken(token, flag) {
   if (token !== null && token !== undefined) {
@@ -215,7 +215,7 @@ export function formatAndValidResponsiveToken(token, flag) {
  * The function `formatAndValidTypographyToken` formats a typography token by adding a prefix and checks if it is a valid typography token.
  *
  * @param {string} token - The `token` parameter is a string that represents a typography token.
- * @returns {string} a string value.
+ * @returns {Nullable<string>} a string value.
  */
 export function formatAndValidTypographyToken(token) {
   if (isTypographyTokenType(token)) {

package/dist/collection/utils/local-storage.js

@@ -12,8 +12,9 @@ export function setItem(key, value) {
 /**
  * If the browser supports localStorage, return the value of the key, otherwise return null.
  *
+ * @typedef T generic type
  * @param {string} key - The key of the item you want to get.
- * @returns {string} A string
+ * @returns {T | null} A any type
  */
 export function getItem(key) {
   var _a;

package/dist/collection/utils/pagination.js

@@ -8,7 +8,7 @@ export const MINIMAL_PAGER_ITEM_COUNT = 7;
  * @param {number} current - the current page number
  * @param {number} total - the total number of pages
  * @param {number} [pagerCount=7] - the count of pager items, must be odd number
- * @returns {(number|string)[]} returns an array of page numbers and placeholders
+ * @returns {(number | string)[]} returns an array of page numbers and placeholders
  */
 export const generatePagerItems = (current, total, pagerCount = MINIMAL_PAGER_ITEM_COUNT) => {
   const ellipsisPlaceholder = '...';

package/dist/collection/utils/test-utils.js

@@ -5,7 +5,7 @@ import { DeviceType } from '../types/ui.type';
  * Get the viewport size for a given device type
  *
  * @param {'desktop' | 'mobile'} size - The device type.
- * @returns {{ width: number; height: number }} An object with the width and height of the viewport.
+ * @returns {ViewportType} An object with the width and height of the viewport.
  */
 export const getViewportByDeviceType = (size) => {
   switch (size) {
@@ -23,7 +23,7 @@ export const getViewportByDeviceType = (size) => {
  * Get the viewport size for device
  *
  * @param {TestDeviceType} device - device name
- * @returns {{ width: number; height: number }} Width and height of the viewport.
+ * @returns {ViewportType} Width and height of the viewport.
  */
 export const getViewportByDevice = (device) => {
   switch (device) {
@@ -37,7 +37,7 @@ export const getViewportByDevice = (device) => {
  * Get the viewport size by breakpoint.
  *
  * @param {'S' | 'M' | 'L' | 'XL'} size - The size of the viewport.
- * @returns {{ width: number; height: number }} An object with a width and height property.
+ * @returns {ViewportType} An object with a width and height property.
  */
 export const getViewportByBreakpoints = (size) => {
   return { width: Breakpoints[size], height: 812 };

package/dist/collection/utils/ui.js

@@ -33,7 +33,7 @@ export const getBrowserVisibleArea = () => {
  * @typedef T
  * @param {HTMLElement} el - The element to start searching from.
  * @param {keyof HTMLElementTagNameMap | string} selector - The selector to find the parent element with.
- * @returns {T | null} The first element that matches the selector.
+ * @returns {Nullable<T>} The first element that matches the selector.
  */
 export function findParent(el, selector) {
   if (!el)
@@ -205,7 +205,7 @@ export function getElementComputedStyle(element, styleName) {
  * Get the deep active element in shadow component
  *
  * @param {Document | ShadowRoot} root the root element
- * @returns {HTMLElement|null} active element
+ * @returns {Nullable<HTMLElement>} active element
  */
 export function getDeepActiveElementInShadow(root = document) {
   const activeEl = root.activeElement;

package/dist/esm/{app-globals-9ad844bb.js → app-globals-0aeb2171.js}

@@ -1,18 +1,18 @@
-import { F as FeatureFlag } from './feature-flag-controller-91e7eaa1.js';
-import { V as VegaLoader, a as VegaNotify, b as VegaDialog, c as VegaEventManager, d as VegaZIndexManager, e as VegaSkeletonLoader } from './vega-skeleton-loader-controller-964db62f.js';
-import { V as VegaThemeManager, a as VegaRTEContent } from './content-state-5646be9f.js';
+import { F as FeatureFlag } from './feature-flag-controller-723f1ff5.js';
+import { V as VegaLoader, a as VegaNotify, b as VegaDialog, c as VegaEventManager, d as VegaZIndexManager, e as VegaSkeletonLoader } from './vega-skeleton-loader-controller-722a41c2.js';
+import { V as VegaThemeManager, a as VegaRTEContent } from './content-state-2de41bc0.js';
 import { M as MapToComponentMethod, V as VegaSlimmer, s as setVegaLogLevel, G as GlobalSlimmersRegistry } from './global-slimmer-registry-17c4efd4.js';
 import { v as vegaEnvManager } from './vega-env-manager-8f8dc473.js';
-import { V as VegaIconManager } from './icon-manager-b889176b.js';
-import './wait-for-vega-handler-03a25866.js';
-import './ui-62e4be97.js';
-import { V as VegaInternalTranslation, a as VegaTranslation, s as staticTranslations } from './translation-c08f2274.js';
+import { V as VegaIconManager } from './icon-manager-638dd4d4.js';
+import './wait-for-vega-handler-b18eb955.js';
+import './ui-ed1283bb.js';
+import { V as VegaInternalTranslation, a as VegaTranslation, s as staticTranslations } from './translation-a18bc15e.js';
 import { T as TypographyUrls } from './typography-396de03f.js';
 import { V as ValidCreditCardNumberRule } from './valid-credit-card-number-rule-cc497bec.js';
-import { w as waitForVega } from './index-88cfdf1a.js';
-import { U as UPDATE_TRANSLATION } from './static-subject-title-8268945e.js';
+import { w as waitForVega } from './index-4153fe96.js';
+import { U as UPDATE_TRANSLATION } from './static-subject-title-249c76cd.js';
 import { C as ChangeManager } from './change-manager-6a7eb88c.js';
-import { O as Observer } from './dom-node-subject-factory-5831cdd4.js';
+import { O as Observer } from './dom-node-subject-factory-286df025.js';
 import { f as forceUpdate } from './index-187f71d1.js';
 
 var __decorate$1 = (undefined && undefined.__decorate) || function (decorators, target, key, desc) {
@@ -311,7 +311,7 @@ function injectVegaRichTextEditorClassIntoGlobal() {
  * Inject VegaPublicValidationRules to global as a public api
  */
 function injectVegaPublicValidationRules() {
-  void import('./public-rules-4a519276.js').then((module) => {
+  void import('./public-rules-31433f1e.js').then((module) => {
     Object.entries(module).forEach(([name, value]) => {
       globalThis[name] = value;
     });

package/dist/esm/{array-b668466e.js → array-3113609f.js}

@@ -76,7 +76,7 @@ function getLongestTextLengthFromArray(textArray) {
  * revertArrayFromFlatArray([1,2,3,4,5,6],[])
  * @param {T[]} flatArr - an array of elements that have been flattened into a single array.
  * @param {T[]} lengthArr - `lengthArr` is an array of numbers that specifies the length of each sub-array that the `flatArr`
- * @returns {T[]|T[][]} The function `revertArrayFromFlatArray` returns either a single-dimensional array of type `T[]` or a two-dimensional array of type `T[][]`
+ * @returns {T[] | T[][]} The function `revertArrayFromFlatArray` returns either a single-dimensional array of type `T[]` or a two-dimensional array of type `T[][]`
  */
 function convertArrayToNestedArray(flatArr, lengthArr) {
   if (lengthArr.length) {
@@ -134,7 +134,7 @@ function sortArrayOrNestedArray(data, sortBy) {
  * @param {string[]} [existArray] - The `existArray` parameter is an optional array of strings that
  * represents the desired order of the elements in the `needSortArray`. If provided, the function will
  * sort the elements in `needSortArray` based on their position in `existArray`. If not provided, the default exist array will use the default order of the array
- * @returns {unknown[] | unknown[][]} The function `sortAsExistArray` returns a sorted array or nested array of type `T[] |
+ * @returns {T[] | T[][]} The function `sortAsExistArray` returns a sorted array or nested array of type `T[] |
  * T[][]`. The sorting is based on the order of elements in the `existArray` parameter, or if
  * `existArray` is not provided, it is based on the order of appearance of elements in the input array
  * or nested array. The sorting is done using the `sortArrayOrNested

package/dist/esm/{child-nodes-event-prevent-slimmer-851ad927.js → child-nodes-event-prevent-slimmer-2f5824ee.js}

@@ -1,7 +1,7 @@
 import { c as MapToComponentField, M as MapToComponentMethod, V as VegaSlimmer } from './global-slimmer-registry-17c4efd4.js';
-import { i as internalVegaEventManager, j as jqueryDelegatedStrategyController } from './internal-vega-event-manager-07e1b3d9.js';
+import { i as internalVegaEventManager, j as jqueryDelegatedStrategyController } from './internal-vega-event-manager-d2c962d2.js';
 import { v as vegaEnvManager } from './vega-env-manager-8f8dc473.js';
-import { F as FeatureFlag } from './feature-flag-controller-91e7eaa1.js';
+import { F as FeatureFlag } from './feature-flag-controller-723f1ff5.js';
 
 var __decorate = (undefined && undefined.__decorate) || function (decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;

package/dist/esm/{child-nodes-notify-observer-slimmer-289caacc.js → child-nodes-notify-observer-slimmer-12d38571.js}

@@ -1,7 +1,7 @@
 import { c as MapToComponentField, M as MapToComponentMethod, V as VegaSlimmer } from './global-slimmer-registry-17c4efd4.js';
-import { O as Observer } from './dom-node-subject-factory-5831cdd4.js';
+import { O as Observer } from './dom-node-subject-factory-286df025.js';
 import { C as ChangeManager } from './change-manager-6a7eb88c.js';
-import { i as isParent } from './ui-62e4be97.js';
+import { i as isParent } from './ui-ed1283bb.js';
 
 var __decorate = (undefined && undefined.__decorate) || function (decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;

package/dist/esm/{component-load-required-ce710ef5.js → component-load-required-db42032a.js}

@@ -3,7 +3,7 @@
  * For example in {@link VegaDatePicker},
  * we want to make sure when {@code @Watch('value')} method is invoked, it should wait for the component is loaded before executing
  *
- * @returns {Function} The function decorated
+ * @returns {FunctionDecoratedType} The function decorated
  */
 function ComponentLoadRequired() {
   return (componentClass, _decoratedMethodName, decoratedMethod) => {

package/dist/esm/{content-state-5646be9f.js → content-state-2de41bc0.js}

@@ -1,11 +1,11 @@
 import { C as ChangeManager } from './change-manager-6a7eb88c.js';
-import { O as Observer, d as domNodeSubjectFactory } from './dom-node-subject-factory-5831cdd4.js';
-import { V as VegaInternalRichTextEditorFlushChanges, a as VegaInternalRichTextEditorSelectionRangeChange } from './vega-internal-event-id-f269c42f.js';
+import { O as Observer, d as domNodeSubjectFactory } from './dom-node-subject-factory-286df025.js';
+import { V as VegaInternalRichTextEditorFlushChanges, a as VegaInternalRichTextEditorSelectionRangeChange } from './vega-internal-event-id-7809368b.js';
 import { L as LogUtility } from './global-slimmer-registry-17c4efd4.js';
 import { i as isNonNullable } from './type-guard-158f6d7a.js';
-import { I as InjectVegaTelemetrySlimmer, c as createPublicAPIRuntimeMetricsSlimmer, g as generateUUID } from './create-public-api-runtime-metrics-slimmer-9ab05523.js';
+import { I as InjectVegaTelemetrySlimmer, c as createPublicAPIRuntimeMetricsSlimmer, g as generateUUID } from './create-public-api-runtime-metrics-slimmer-8ada793f.js';
 import { c as createCommonjsModule, a as commonjsGlobal } from './_commonjsHelpers-9943807e.js';
-import { D as DARK_MODE_CHANGE } from './static-subject-title-8268945e.js';
+import { D as DARK_MODE_CHANGE } from './static-subject-title-249c76cd.js';
 
 var tinycolor = createCommonjsModule(function (module, exports) {
 // This file is autogenerated. It's used to publish CJS to npm.
@@ -2547,7 +2547,7 @@ class ColorSchemaOverridingController {
    *
    * @param {OverridableToken} overrideColorToken The token will be overridden
    * @param {VegaThemeOverrideColors} overrideColors the payload of override colors
-   * @returns {string} The css var value
+   * @returns {Nullable<string>} The css var value
    */
   parseCssVarValue(overrideColorToken, overrideColors) {
     var _a;
@@ -3083,6 +3083,15 @@ class StateEntityRenderingRegistry {
   getDOMByEntity(entity) {
     return this.entityToDOM.get(entity);
   }
+  /**
+   * Delete the dirty element to entity ref.
+   *
+   * @example Convert text node to the link node, the old span will change to the link wrapper element, and there will be a new text span, so we need remove the old span ref from the map.
+   * @param {HTMLElement} dom - The dirty element ref.
+   */
+  removeDirtyDomRef(dom) {
+    this.domToEntity.delete(dom);
+  }
 }
 const stateEntityRenderingRegistry = new StateEntityRenderingRegistry();
 
@@ -3186,7 +3195,7 @@ class IndentAnnotation extends BlockAnnotation {
   /**
    * Generate the JSON item of the annotation
    *
-   * @returns {Record<string, unknown>} JSON representation of the annotation
+   * @returns {Nullable<Record<string, unknown>>} JSON representation of the annotation
    */
   toJSON() {
     return this.indent > 0 ? { indent: this.indent } : null;
@@ -3222,9 +3231,12 @@ class ActionHandleStrategyRegistry {
   /**
    * Get the special strategy that handle the action logic.
    *
+   * @typedef T generic type
+   * @typedef target generic type
+   * @typedef R generic type
    * @param {string} actionType - The special action type or the action class name.
    * @param {string} targetClass - The rich text node class name.
-   * @returns {Nullable<ActionHandleStrategy>} - The action handle strategy instance if defined.
+   * @returns {Nullable<ActionHandleStrategy<T, target, R>>} - The action handle strategy instance if defined.
    */
   static get(actionType, targetClass) {
     const strategyMap = this.registry.get(targetClass);
@@ -3235,9 +3247,10 @@ class ActionHandleStrategyRegistry {
   /**
    * Get the special strategy from the registry and run the strategy execute method.
    *
+   * @typedef R generic type
    * @param {ModifyContentAction | AnnotationAction} action - The update node action instance.
    * @param {RTENode | RTEBlock | VegaRTEContent} RTEInstance - The rich text editor node.
-   * @returns {unknown} The return value of the strategy method execute invoke result.
+   * @returns {R | undefined} The return value of the strategy method execute invoke result.
    */
   static executeTheStrategy(action, RTEInstance) {
     const actionType = action instanceof ModifyContentAction ? action.type : action.constructor.name;
@@ -3296,8 +3309,9 @@ class RTEBlock {
   /**
    * Get annotation by type
    *
+   * @typedef T generic type
    * @param {keyof typeof BlockAnnotationTypeEnum} type - Annotation type
-   * @returns {Nullable<BlockAnnotation> | Nullable<LinkGroupAnnotation>} - Annotation
+   * @returns {Nullable<T>} - Annotation
    */
   getAnnotationByType(type) {
     return this.annotationMap.get(type);
@@ -3363,8 +3377,9 @@ class RTENode {
   /**
    * Get annotation by type
    *
+   * @typedef T generic type
    * @param {RTENodeAnnotationMapKey} type - Annotation type
-   * @returns {Nullable<RTENodeAnnotationMapValue>} - Annotation
+   * @returns {Nullable<T>} - Annotation
    */
   getAnnotationByType(type) {
     return this.annotationMap.get(type);
@@ -3498,9 +3513,10 @@ class ActionHandleStrategy {
   /**
    * Public method to invoke the handle logic.
    *
+   * @typedef R generic type
    * @param {ModifyContentAction | AnnotationAction} action - The action instance. Contains the action type and necessary params.
    * @param {RTENode | RTEBlock | VegaRTEContent} target - The rich text node instance that will be modified.
-   * @returns {unknown} - The invoke result in special strategy.
+   * @returns {R} - The invoke result in special strategy.
    */
   execute(action, target) {
     LogUtility.log(`Executing action ${action.constructor.name} on ${target.constructor.name} ${target['id']}`);
@@ -3600,7 +3616,7 @@ class RTEImageNode extends RTENode {
    *
    * @param {VegaRTEImageNode} node - The node to be converted.
    * @param {RTEImageBlock} parentBlock - The parent block
-   * @returns {RTEImageBlock} An instance of `RTEImageBlock`
+   * @returns {RTEImageNode} An instance of `RTEImageBlock`
    */
   static from(node, parentBlock) {
     const imageNode = new RTEImageNode(node.id, node.url, parentBlock);
@@ -4188,7 +4204,7 @@ class ItalicAnnotation extends NodeAnnotation {
    * Generate the map item for the annotation
    *
    * @param {boolean} italic - Italic annotation
-   * @returns {Nullable<[NodeAnnotationTypeEnum.ITALIC, ItalicAnnotation]>} Map item for the annotation
+   * @returns {[NodeAnnotationTypeEnum.ITALIC, ItalicAnnotation]} Map item for the annotation
    */
   static from(italic) {
     return [NodeAnnotationTypeEnum.ITALIC, new ItalicAnnotation(italic)];
@@ -4412,7 +4428,7 @@ class LinkAnnotation extends NodeAnnotation {
   /**
    * Generate the JSON representation of the annotation
    *
-   * @returns {Record<string, unknown>} JSON representation of the annotation
+   * @returns {Record<'link', VegaRTELink>} JSON representation of the annotation
    */
   toJSON() {
     return { link: { href: this.link.href, groupKey: this.link.groupKey } };
@@ -4461,7 +4477,7 @@ class LinkGroupAnnotationAction extends AnnotationAction {
   /**
    * Converts the action to an annotation
    *
-   * @returns {LinkGroupAnnotation} The annotation
+   * @returns {Annotation} The annotation
    */
   toAnnotation() {
     return new LinkGroupAnnotation(this.groupKey);
@@ -4642,7 +4658,7 @@ class NodeSplitTextStrategy extends ActionHandleStrategy {
    *
    * @param {Range} range - Selection range
    * @param {RTETextNode} target - RTETextNode
-   * @returns {RTETextNode[] | this} RTETextNode array
+   * @returns {RTETextNode[] | RTETextNode} RTETextNode array
    */
   splitTextNode(range, target) {
     const { startContainer, endContainer, startOffset } = range;
@@ -4723,7 +4739,7 @@ class ClearFormattingAnnotationAction extends TextSplittableAction {
   /**
    * Converts the action to an annotation
    *
-   * @returns {ClearFormattingAnnotation} the annotation
+   * @returns {Annotation} the annotation
    */
   toAnnotation() {
     return new ClearFormattingAnnotation();
@@ -6109,7 +6125,7 @@ class RTEListItemBlock extends RTETextBlock {
    * Converts a VegaRTEListItemBlock object to an RTEListItemBlock
    *
    * @param {VegaRTEListBlock} block - Converts a `VegaRTEListItemBlock` object into an `RTEListItemBlock`.
-   * @returns {RTEListBlock} Return an instance of `RTEListItemBlock`
+   * @returns {RTEListItemBlock} Return an instance of `RTEListItemBlock`
    */
   static from(block) {
     const listItemBlock = new RTEListItemBlock(block.id);
@@ -6497,7 +6513,7 @@ class VegaRTEContent {
    * Converts a JSON array of blocks to a class array of RTEContentBlock.
    *
    * @param {VegaRTEContentBlock[]} value The JSON array of blocks to convert.
-   * @returns {RTEContentBlock[]} The converted array of RTEContentBlock.
+   * @returns {VegaRTEContent} The converted array of RTEContentBlock.
    */
   static fromJSON(value) {
     const blocks = value.map((block) => {