@globalpayments/vega 2.41.0 → 2.43.0

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-f767f6be.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-690eac1d.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-2b4fdc4f.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-707fec53.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-20db9763.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-aab1c019.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-690eac1d.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-2b4fdc4f.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-d7113cf7.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) => {

package/dist/esm/{create-public-api-runtime-metrics-slimmer-9ab05523.js → create-public-api-runtime-metrics-slimmer-8ada793f.js}

@@ -153,7 +153,7 @@ 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/esm/{deprecated-property-slimmer-43d184b3.js → deprecated-property-slimmer-32575f02.js}

@@ -15,7 +15,8 @@ class DeprecatedPropertySlimmerBase extends VegaSlimmer {
    * The `getValue` function returns either the old property or the new property based on a deep equality
    * check.
    *
-   * @returns {unknown} The `getValue` method returns either the `oldProperty` or `newProperty` based on the result
+   * @typedef T generic type
+   * @returns {T} The `getValue` method returns either the `oldProperty` or `newProperty` based on the result
    * of the `deepEqual` comparison between them. If `newProperty` is deeply equal to `oldProperty`, then
    * `oldProperty` is returned; otherwise, `newProperty` is returned.
    */
@@ -28,11 +29,12 @@ class DeprecatedPropertySlimmerBase extends VegaSlimmer {
 /**
  * Create dynamic deprecated property slimmer
  *
+ * @typedef K generic type
  * @param {ClassPrototype} mapFromClass - It represents the class that you want to map from.
  * @param {string} newPropertyName - The new prop name or name path
  * @param {string} oldPropertyName - The old prop name or name path
  * @param {unknown} defaultValue - The default value of the prop
- * @returns {DeprecatedPropertySlimmerBase<unknown>} - deprecated property slimmer
+ * @returns {DeprecatedPropertySlimmerBase<K>} - deprecated property slimmer
  */
 function createDeprecatedPropertySlimmer(mapFromClass, newPropertyName, oldPropertyName, defaultValue) {
   return createDynamicSlimmer(mapFromClass, DeprecatedPropertySlimmerBase, [{ mapFrom: 'host', mapTo: 'host' }], [], [

package/dist/esm/{design-token-a1bb9a99.js → design-token-9a3c1dc5.js}

@@ -1,7 +1,7 @@
 import { j as isBorderColorTokenType, b as BorderColors, e as BorderColorMap, k as isShadowsTokenType, f as Shadows, g as ShadowMap, l as isBorderTokenType, m as Borders, n as BorderMap, o as isSpacingTokenType, p as isBorderRadiusTokenType, q as isBackgroundColorTokenType, r as isTextColorTokenType, s as isBreakpointsTokenType, h as Spacing, t as isBorderStyleType, B as BorderRadius, C as Colors, u as isTypographyTokenType } from './type-guard-158f6d7a.js';
 import { B as Breakpoints } from './breakpoints-d9faf11c.js';
 import { L as LogUtility } from './global-slimmer-registry-17c4efd4.js';
-import { R as ResponsiveFormatFacade } from './responsive-format-facade-b3bc4db6.js';
+import { R as ResponsiveFormatFacade } from './responsive-format-facade-175aee98.js';
 import { a as TypographyKeys } from './typography-396de03f.js';
 import { S as StateVariantFormatter, s as stateBackgroundColorFormatter } from './state-background-color-formatter-121ae7d3.js';
 import { a as BorderStyle } from './ui-8424715a.js';
@@ -198,7 +198,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.
  */
 function formatAndValidPadding(token) {
   if (isSpacingTokenType(token)) {
@@ -213,7 +213,7 @@ 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`).
@@ -231,7 +231,7 @@ 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.
  */
 function formatAndValidBorderRadius(token) {
   if (isBorderRadiusTokenType(token)) {
@@ -245,7 +245,7 @@ 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
  */
 function formatAndValidBorderColor(token) {
   if (isBorderColorTokenType(token)) {
@@ -260,7 +260,7 @@ function formatAndValidBorderColor(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.
  */
 function formatAndValidBackgroundColor(token, withModes = []) {
   if (isBackgroundColorTokenType(token)) {
@@ -276,7 +276,7 @@ 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.
  */
 function formatAndValidTextColor(token, withModes = []) {
   if (isTextColorTokenType(token)) {
@@ -290,7 +290,7 @@ 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.
  */
 function formatAndValidFlexBreakpoint(token) {
   if (isBreakpointsTokenType(token)) {
@@ -304,7 +304,7 @@ 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.
  */
 function formatAndValidBreakpointSize(token) {
   if (isBreakpointsTokenType(token)) {
@@ -319,7 +319,7 @@ 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.
  */
 function formatAndValidGap(token) {
   if (isSpacingTokenType(token)) {
@@ -334,7 +334,7 @@ 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
  */
 function formatAndValidShadow(token, withModes = []) {
   if (isShadowsTokenType(token)) {
@@ -350,7 +350,7 @@ 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
  */
 function formatAndValidResponsiveToken(token, flag) {
   if (token !== null && token !== undefined) {
@@ -361,7 +361,7 @@ 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.
  */
 function formatAndValidTypographyToken(token) {
   if (isTypographyTokenType(token)) {

package/dist/esm/{dom-node-subject-factory-5831cdd4.js → dom-node-subject-factory-286df025.js}

@@ -1,4 +1,4 @@
-import { i as isParent } from './ui-62e4be97.js';
+import { i as isParent } from './ui-ed1283bb.js';
 
 /**
  *  An Observer is a class that has a listener method that accepts a value of type T
@@ -196,7 +196,7 @@ class DomNodeSubjectFactory {
    *
    * @param {HTMLElement} childNode - Child node.
    * @param {VegaEventIDInterface} eventId - eventId.
-   * @returns {DomNodeSubject} - Parent node subject.
+   * @returns {Nullable<DomNodeSubject>} - Parent node subject.
    */
   getSubjectFromParentNodeByEventId(childNode, eventId) {
     let subject;

package/dist/esm/{dom-node-subject-observer-factory-dc486a8b.js → dom-node-subject-observer-factory-d661fc7c.js}

@@ -1,5 +1,5 @@
 import { C as ChangeManager } from './change-manager-6a7eb88c.js';
-import { O as Observer, d as domNodeSubjectFactory } from './dom-node-subject-factory-5831cdd4.js';
+import { O as Observer, d as domNodeSubjectFactory } from './dom-node-subject-factory-286df025.js';
 
 /**
  * The function `domAcceptableHandle` always returns `true`.