@globalpayments/vega 2.41.0 → 2.42.0

package/dist/collection/components/vega-table/vega-table-head-cell/vega-table-head-cell.js

@@ -48,9 +48,14 @@ export class VegaTableHeadCell {
      * @returns {Nullable<'desc' | 'asc'>} Return the next sorter order
      */
     this.getNextSortOrder = (sortOrder) => {
-      const orderSequence = FeatureFlag.isEnabled('VEGA_TABLE.REVERSE_SORT_ORDER')
-        ? ['asc', 'desc', null]
-        : ['desc', 'asc', null];
+      var _a;
+      const isReverseSortOrder = FeatureFlag.isEnabled('VEGA_TABLE.REVERSE_SORT_ORDER');
+      const baseOrderSequence = isReverseSortOrder
+        ? ['asc', 'desc']
+        : ['desc', 'asc'];
+      const orderSequence = ((_a = this.sortConfig) === null || _a === void 0 ? void 0 : _a.disableUnsorted)
+        ? baseOrderSequence
+        : [...baseOrderSequence, null];
       return orderSequence[(orderSequence.indexOf(sortOrder) + 1) % orderSequence.length];
     };
   }
@@ -201,6 +206,29 @@ export class VegaTableHeadCell {
       },
       "attribute": "width",
       "reflect": false
+    },
+    "sortConfig": {
+      "type": "unknown",
+      "mutable": false,
+      "complexType": {
+        "original": "VegaTableSortConfig",
+        "resolved": "{ type: \"single\" | \"multiple\"; disableUnsorted?: boolean; }",
+        "references": {
+          "VegaTableSortConfig": {
+            "location": "import",
+            "path": "../interface"
+          }
+        }
+      },
+      "required": false,
+      "optional": true,
+      "docs": {
+        "tags": [{
+            "name": "vegaVersion",
+            "text": "2.42.0"
+          }],
+        "text": "Specifies the sorting configuration for the table header cell."
+      }
     }
   }; }
   static get states() { return {

package/dist/collection/components/vega-table/vega-table.js

@@ -828,7 +828,7 @@ export class VegaTable {
       "mutable": false,
       "complexType": {
         "original": "VegaTableSortConfig",
-        "resolved": "{ type: \"single\" | \"multiple\"; }",
+        "resolved": "{ type: \"single\" | \"multiple\"; disableUnsorted?: boolean; }",
         "references": {
           "VegaTableSortConfig": {
             "location": "import",

package/dist/collection/components/vega-time-picker/slimmers/controllers/vega-time-picker-range-dropdown-controller.js

@@ -5,7 +5,7 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
 import { MapToComponentField, MapToComponentMethod } from 'vega-slimmer/core';
-import { ElementAppenderSlimmer } from '../../../../helpers/slimmers/element-appender-slimmer';
+import { ElementAppenderSlimmer } from '../../../../helpers/slimmers/element-appender/element-appender-slimmer';
 /** The `VegaTimePickerRangeDropdownController` class is responsible for managing the dropdown menu for selecting a range of time in the VegaTimePicker component. */
 export class VegaTimePickerRangeDropdownController extends ElementAppenderSlimmer {
   /**

package/dist/collection/components/vega-time-picker/slimmers/controllers/vega-time-picker-single-dropdown-controller.js

@@ -5,7 +5,7 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
 import { MapToComponentField, MapToComponentMethod } from 'vega-slimmer/core';
-import { ElementAppenderSlimmer } from '../../../../helpers/slimmers/element-appender-slimmer';
+import { ElementAppenderSlimmer } from '../../../../helpers/slimmers/element-appender/element-appender-slimmer';
 import { LogUtility } from '../../../../utils/log';
 import { pad } from '../../../../utils/date';
 /** The `VegaTimePickerDropdownController` class is responsible for managing the dropdown functionality of the VegaTimePicker component in a TypeScript application. */

package/dist/collection/components/vega-tooltip/slimmers/controllers/vega-tooltip-element-appender-controller.js

@@ -4,7 +4,7 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
   else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
-import { ElementAppenderSlimmer } from '../../../../helpers/slimmers/element-appender-slimmer';
+import { ElementAppenderSlimmer } from '../../../../helpers/slimmers/element-appender/element-appender-slimmer';
 import { MapToComponentField, MapToComponentMethod } from 'vega-slimmer/core';
 /**
  * The class is responsible for managing the visibility and behavior of the tooltip content box.

package/dist/collection/decorators/method-decorators/component-load-required.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
  */
 export function ComponentLoadRequired() {
   return (componentClass, _decoratedMethodName, decoratedMethod) => {

package/dist/collection/decorators/property-decorators/inject-element-appender.js

@@ -9,7 +9,7 @@ import { findParent, isParent } from '../../utils/ui';
  * show/hide.
  * @param {string} [isDropdownShowName] - The name of the property that will be used to determine if
  * the dropdown is shown or not.
- * @returns {void} A function that takes a component class and a string.
+ * @returns {(target: ComponentInterface, key: string) => void} A function that takes a component class and a string.
  */
 export function InjectElementAppender(showConfigFactory, getTrigger, isDropdownShowName) {
   return (componentClass, elementAppenderName) => {

package/dist/collection/decorators/property-decorators/inject-keyboard-manager.js

@@ -6,7 +6,7 @@ import KeyboardManager from '../../helpers/keyboard/keyboard-manager';
  * component is disconnected
  *
  * @param {(instance: ComponentInterface) => KeyboardEventListener[]} listenersRetriever - (instance: ComponentInterface) => KeyboardEventListener[]
- * @returns {void} A decorator function that takes a component class and a property name.
+ * @returns {(target: ComponentInterface, key: string) => void} A decorator function that takes a component class and a property name.
  */
 export function InjectKeyboardManager(listenersRetriever) {
   /* A decorator function that takes a component class and a property name. */

package/dist/collection/helpers/calendar/calendar-event.js

@@ -61,7 +61,7 @@ export class CalendarEvent {
   /**
    * This function returns the variant of an event in TypeScript.
    *
-   * @returns {VegaCalendarEventVariantType|null} The variant of the event.
+   * @returns {Nullable<VegaCalendarEventVariantType>} The variant of the event.
    */
   get variant() {
     return this._event.variant;
@@ -69,7 +69,7 @@ export class CalendarEvent {
   /**
    * This function returns the color of an event in TypeScript.
    *
-   * @returns {string|null} The color of the event.
+   * @returns {Nullable<string>} The color of the event.
    */
   get color() {
     return this._event.color;

package/dist/collection/helpers/change-manager/subject/dom-node-subject/dom-node-subject-factory.js

@@ -40,7 +40,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/collection/helpers/change-manager/subject/static-subject/static-subject.js

@@ -13,7 +13,7 @@ export class StaticSubject {
   /**
    * Get the title of the subject
    *
-   * @returns {SubjectTitle} The title of the subject.
+   * @returns {string} The title of the subject.
    */
   getDescription() {
     return this.title;

package/dist/collection/helpers/chart/drawers/legend-drawer.js

@@ -23,7 +23,7 @@ export class LegendDrawer extends BaseDrawer {
   /**
    * This function draws a legend on a chart using input options.
    *
-   * @returns {(SVGGElement | HTMLCanvasElement)[]}  draw piece
+   * @returns {(SVGGElement | HTMLCanvasElement)[] | undefined}  draw piece
    */
   draw() {
     const { data = [], colors, position, width } = this.options.renderOptions;

package/dist/collection/helpers/chart/input-processors/pie-chart-arc-path-input-processor.js

@@ -6,7 +6,7 @@ export class PieChartArchPathInputProcessor {
    *
    * @param {ChartOptions<PieChartSourceType>} input - The input parameter is an object containing chart options, including the data source, colors, layout, donut radius, and type of chart.
    * @param {PieChartRadiusProcessResultType} previousOutput - previous result from the other input process
-   * @returns {{ renderOptions: ChartArcOptions }} An object with a property `renderOptions` which contains an object with properties `data`,
+   * @returns {ChartArcOptions} An object with a property `renderOptions` which contains an object with properties `data`,
    * `colors`, `outerRadius`, `donutRadius`, and `center`.
    */
   process(input, previousOutput) {

package/dist/collection/helpers/chart/input-processors/pie-chart-text-input-processor.js

@@ -4,7 +4,7 @@ export class PieChartTextInputProcessor {
    * This function processes input data to generate options for rendering a pie or donut chart with D3.js.
    *
    * @param {ChartArcOptions} input - chartArcPathInputProcessor process result
-   * @returns {{ renderOptions: TextInputType[] }} An object with a property `renderOptions` which contains an object with properties `data`,
+   * @returns {TextInputType[]} An object with a property `renderOptions` which contains an object with properties `data`,
    * `colors`, `outerRadius`, `donutRadius`, and `center`.
    */
   process(input) {

package/dist/collection/helpers/chart/input-processors/processor-chain.js

@@ -14,9 +14,10 @@ export class ProcessorChain {
   /**
    * This function processes input through a series of processors and returns the final output.
    *
+   * @typedef T generic type
    * @param {unknown} input - The input parameter is of type unknown, which means it can be any type of
    * value. It is the data that will be processed by the processors.
-   * @returns {unknown} the output of the last processor in the `this.processors` array.
+   * @returns {T} the output of the last processor in the `this.processors` array.
    */
   process(input) {
     let previousOutput;

package/dist/collection/helpers/chart/input-processors/y-axis-input-processor.js

@@ -34,7 +34,7 @@ export class YAxisInputProcessor {
    * @param {ChartDataSourceItem[]} data data source
    * @param {number[]} range svg scale range
    * @param {number} ticks the y-axis ticks
-   * @returns {AxisScale<AxisDomain>}y scale
+   * @returns {ScaleType}y scale
    */
   getScale(data, range, ticks) {
     const flatData = flatNestedArray(data);

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

@@ -31,7 +31,7 @@ class VegaDialogController {
    * It creates a new `vega-dialog` element, sets its properties, appends it to the DOM, and opens it
    *
    * @param {VegaDialogOption} options - VegaDialogOption
-   * @returns {HTMLElement} The dialog reference.
+   * @returns {HTMLVegaDialogElement} The dialog reference.
    * @vegaVersion 1.24.0
    */
   open(options) {

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

@@ -41,3 +41,5 @@ export const VegaInternalRichTextImageDeleteButtonClicked = new VegaInternalEven
 export const VegaInternalComponentDidRender = new VegaInternalEventID('componentDidRender');
 export const VegaInternalPopoverUpdateTarget = new VegaInternalEventID('popoverUpdateTarget');
 export const VegaInternalRichTextEditDeleteSelectedNodes = new VegaInternalEventID('richTextEditDeleteSelectedNodes');
+export const VegaInternalPaginationPageSizeChange = new VegaInternalEventID('paginationPageSizeChange');
+export const VegaInternalPaginationCurrentChange = new VegaInternalEventID('paginationCurrentChange');

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

@@ -45,7 +45,7 @@ class InternalVegaEventManager {
   /**
    * The function `getSemanticsInGlobal` returns the global event semantics configuration.
    *
-   * @returns {EventSemantics} The method is returning a nullable EventSemantics object.
+   * @returns {Nullable<EventSemantics>} The method is returning a nullable EventSemantics object.
    */
   getSemanticsInGlobal() {
     return this.config.global;

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

@@ -191,6 +191,12 @@ const FeatureFlagsMap = {
     createdAtVersion: '2.32.0',
     disabledByDefault: false,
   },
+  'VEGA_PAGINATION.ENABLE_EXTENSIONS_RESPONSIVE_DEFAULT_VALUE': {
+    description: `Feature flag to enable responsive default values for the extensions property in vega-pagination.`,
+    createdTimestamp: 1744876233415,
+    createdAtVersion: '2.42.0',
+    disabledByDefault: true,
+  },
   'VEGA_COMPONENT.CORNERS_USE_OLD_BEHAVIOR': {
     description: `Feature flag that the component corners style weights are sorted according to the [0, 9999, 2, 4, 8, ..., 48]`,
     createdTimestamp: 1744772429681,

package/dist/collection/helpers/formatter/responsive-map-formatter/responsive-size-formatter.js

@@ -11,7 +11,7 @@ class ResponsiveSizeFormatter {
    * Given a responsive size, return the size according current window width
    *
    * @param {ResponsiveType<SizeType>} input - ResponsiveScope
-   * @returns {SizeType} - size.
+   * @returns {ResponsiveSizeType} - size.
    */
   format(input) {
     const breakpoint = getCurrentBreakpoint();

package/dist/collection/helpers/formatter/responsive-map-formatter/responsive-translocation-formatter.js

@@ -10,7 +10,7 @@ class ResponsiveTranslocationFormatter {
    * Given a responsive size, return the size according current window width
    *
    * @param {ResponsiveType<TranslocationType>} input - ResponsiveScope
-   * @returns {TranslocationType} - size.
+   * @returns {Nullable<TranslocationType>} - size.
    */
   format(input) {
     if (isTranslocationType(input)) {

package/dist/collection/helpers/formatter/string-formatter/number-mask-strategy.js

@@ -55,7 +55,7 @@ export class NumberMaskStrategy extends StringFormatStrategy {
    *
    * @param {string} input - input number
    * @param {number} caretPosition - The current caret position
-   * @returns {number} The new position of caret
+   * @returns {Nullable<number>} The new position of caret
    */
   calculateCaretPosition(input, caretPosition) {
     if (isNonNullable(caretPosition)) {

package/dist/collection/helpers/formatter/string-formatter/string-mask-strategy.js

@@ -48,7 +48,7 @@ export class StringMaskStrategy extends StringFormatStrategy {
    *
    * @param {string} input - The input string
    * @param {number} caretPosition - The current position of caret
-   * @returns {number} The new position of caret
+   * @returns {Nullable<number>} The new position of caret
    */
   calculateCaretPosition(input, caretPosition) {
     if (!isNonNullable(caretPosition))

package/dist/collection/helpers/formatter/style-formatter.js

@@ -7,7 +7,7 @@ import responsiveFormatFacade from './responsive-map-formatter/responsive-format
  * @param {Nullable<ResponsiveType<FlexGrowType>>} flexGrow - flex-grow
  * @param {Nullable<ResponsiveType<FlexShrinkType>>} flexShrink - flex-shrink
  * @param {Nullable<ResponsiveType<FlexBasisType>>} flexBasis - flex-basis
- * @returns {object} - formatted styles
+ * @returns {FormattedStylesType} - formatted styles
  */
 export function formatFlexStyles(flex, flexGrow, flexShrink, flexBasis) {
   if (isNonNullable(flex)) {

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

@@ -32,7 +32,7 @@ class IconManager {
    * Get an internal icon by name
    *
    * @param {string} name - The name of the icon
-   * @returns {Nullable<string>} returns the icon svg or null if not found
+   * @returns {Nullable<IconPayload>} returns the icon svg or null if not found
    * @vegaVersion 2.13.0
    */
   getIcon(name) {

package/dist/collection/helpers/immutable/immutable-map.js

@@ -33,7 +33,8 @@ export class ImmutableMap {
   /**
    * The function returns an iterator of the keys in a map.
    *
-   * @returns {IterableIterator<unknown>} The `keys()` method is returning an `IterableIterator` object that contains the keys of the `map`.
+   * @typedef K generic type
+   * @returns {IterableIterator<K>} The `keys()` method is returning an `IterableIterator` object that contains the keys of the `map`.
    */
   keys() {
     return this.map.keys();
@@ -41,9 +42,11 @@ export class ImmutableMap {
   /**
    * The `set` function adds a key-value pair to an immutable map.
    *
+   * @typedef K generic type
+   * @typedef V generic type
    * @param {unknown} key - The key parameter is the key of the entry that you want to add or update in the map. It is of type K, which represents the type of the keys in the map.
    * @param {unknown} value - The value parameter represents the value that you want to associate with the specified key in the ImmutableMap.
-   * @returns {ImmutableMap<unknown, unknown>} The method is returning an ImmutableMap<K, V>.
+   * @returns {ImmutableMap<K, V>} The method is returning an ImmutableMap<K, V>.
    */
   set(key, value) {
     return this.withMutation((map) => {
@@ -53,8 +56,9 @@ export class ImmutableMap {
   /**
    * The get function retrieves the value associated with a given key from a map.
    *
+   * @typedef V generic type
    * @param {unknown} key - The parameter "key" is of type "K", which means it can be any type.
-   * @returns {unknown} The value associated with the given key in the map.
+   * @returns {Nullable<V>} The value associated with the given key in the map.
    */
   get(key) {
     return this.map.get(key);
@@ -62,7 +66,8 @@ export class ImmutableMap {
   /**
    * The values() method of Map instances returns a new map iterator object that contains the values for each element in this map in insertion order.
    *
-   * @returns {IterableIterator<unknown>} An iterator of the values in the map.
+   * @typedef V generic type
+   * @returns {IterableIterator<V>} An iterator of the values in the map.
    */
   values() {
     return this.map.values();
@@ -70,8 +75,10 @@ export class ImmutableMap {
   /**
    * The `delete` function removes an entry from an ImmutableMap by deleting the corresponding key-value pair from the underlying Map.
    *
+   * @typedef K generic type
+   * @typedef V generic type
    * @param {unknown} key - The key parameter is the key of the entry that you want to delete from the ImmutableMap.
-   * @returns {ImmutableMap<unknown, unknown>} The method is returning an ImmutableMap<K, V>.
+   * @returns {ImmutableMap<K, V>} The method is returning an ImmutableMap<K, V>.
    */
   delete(key) {
     return this.withMutation((map) => {
@@ -81,7 +88,9 @@ export class ImmutableMap {
   /**
    * The `clear` function clears all key-value pairs from an ImmutableMap.
    *
-   * @returns {ImmutableMap<unknown, unknown>} The method is returning an ImmutableMap<K, V>.
+   * @typedef K generic type
+   * @typedef V generic type
+   * @returns {ImmutableMap<K, V>} The method is returning an ImmutableMap<K, V>.
    */
   clear() {
     return this.withMutation((map) => {
@@ -100,8 +109,10 @@ export class ImmutableMap {
   /**
    * The `withMutation` function takes a callback function that mutates a map and returns a new immutable map with the changes applied.
    *
+   * @typedef K generic type
+   * @typedef V generic type
    * @param {(map: Map<unknown, unknown>) => void} fn - A function that takes a map as its parameter and does some mutation on it.
-   * @returns {ImmutableMap<unknown, unknown>} a new instance of `ImmutableMap<K, V>`.
+   * @returns {ImmutableMap<K, V>} a new instance of `ImmutableMap<K, V>`.
    */
   withMutation(fn) {
     const newMap = new Map(this.map);

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

@@ -21,7 +21,7 @@ class VegaLoaderController {
    * Create a loading indicator and append it to the container
    *
    * @param {VegaLoaderIndicatorOptions} options - VegaLoaderOptions = {} options of the method
-   * @returns {string} The uuid of the loader.
+   * @returns {Nullable<string>} The uuid of the loader.
    * @vegaVersion 1.16.0
    */
   load(options = {}) {
@@ -65,7 +65,7 @@ class VegaLoaderController {
    * Find loader by id, if the id include '>>>' it will find inside shadowRoot
    *
    * @param {string} id - The id of the loader.
-   * @returns {string} The loader found by id.
+   * @returns {Nullable<HTMLElement>} The loader found by id.
    */
   findLoader(id) {
     var _a, _b;
@@ -98,7 +98,7 @@ class VegaLoaderController {
    * Create a loading indicator
    *
    * @param {VegaLoaderIndicatorOptions} indicatorOptions the props of vega loading indicator
-   * @returns {HTMLElement} vega-loading-indicator component template
+   * @returns {HTMLVegaLoadingIndicatorElement} vega-loading-indicator component template
    */
   createLoadingIndicator(indicatorOptions = {}) {
     const loadingIndicator = document.createElement('vega-loading-indicator');

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

@@ -39,7 +39,7 @@ class VegaNotifyController {
    * It creates a new notification element, adds it to the container, and returns the notification's ID
    *
    * @param {VegaNotifyOption} options - VegaNotifyProps
-   * @returns {string} The ID of the notification.
+   * @returns {Promise<string>} The ID of the notification.
    * @vegaVersion 1.17.0
    */
   async open(options) {
@@ -79,7 +79,7 @@ class VegaNotifyController {
    * It creates a new page notification element, sets its properties, and returns it
    *
    * @param {VegaNotifyOption} props - VegaNotifyProps - the properties of the notification
-   * @returns {HTMLElement} A function that takes in a props object and returns a pageNotification element.
+   * @returns {HTMLVegaPageNotificationElement} A function that takes in a props object and returns a pageNotification element.
    */
   createPageNotification(props) {
     const pageNotification = document.createElement('vega-page-notification');
@@ -94,7 +94,7 @@ class VegaNotifyController {
    * It creates a div element, sets its z-index to be on top of everything else, adds a class to it, and
    * then adds it to the body of the page
    *
-   * @returns {HTMLElement} The container is being returned.
+   * @returns {HTMLVegaPageNotificationListElement} The container is being returned.
    */
   getContainer() {
     if (this.container) {

package/dist/collection/helpers/remote-invocation/remote-invocation-registry.js

@@ -8,9 +8,10 @@ export class RemoteInvocationRegistry {
   /**
    * This function performs a remote invocation call and returning the result.
    *
+   * @typedef T generic type
    * @param {HTMLElement} subject the dom node subject
    * @param {unknown[]} args - The `args` parameter of specific method.
-   * @returns {unknown} The result of call `remoteInvocation`.
+   * @returns {Nullable<T>} The result of call `remoteInvocation`.
    */
   call(subject, ...args) {
     let result = null;

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

@@ -74,7 +74,7 @@ class VegaSkeletonLoaderController {
    * Create a skeleton item. The skeleton animated always be true
    *
    * @param {VegaSkeletonLoaderItem} config - Configuration for the skeleton item.
-   * @returns {HTMLElement} - Skeleton item.
+   * @returns {HTMLVegaSkeletonElement} - Skeleton item.
    */
   createSkeleton(config) {
     const { type, width, height } = config;
@@ -87,7 +87,7 @@ class VegaSkeletonLoaderController {
    *
    * @param {HTMLElement[]} skeletons - Skeleton elements of the loader.
    * @param {VegaSkeletonLoaderLayout} layout - Flex properties for the layout.
-   * @returns {HTMLElement} - Container wrapping the skeletons in the specified flex layout.
+   * @returns {HTMLVegaFlexElement} - Container wrapping the skeletons in the specified flex layout.
    */
   wrapLayout(skeletons, layout) {
     const skeletonContainer = document.createElement('vega-flex');

package/dist/collection/helpers/slimmers/deprecated-property-slimmer.js

@@ -13,7 +13,8 @@ export 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.
    */
@@ -26,11 +27,12 @@ export 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
  */
 export function createDeprecatedPropertySlimmer(mapFromClass, newPropertyName, oldPropertyName, defaultValue) {
   return createDynamicSlimmer(mapFromClass, DeprecatedPropertySlimmerBase, [{ mapFrom: 'host', mapTo: 'host' }], [], [

package/dist/collection/helpers/slimmers/{element-appender-container → element-appender}/element-appender-container-controller.js

@@ -5,7 +5,7 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
 import { InjectVegaSlimmer, MapToComponentField as MapToSlimmerField, VegaSlimmer } from 'vega-slimmer/core';
-import { DefaultWrapper } from './default-wrapper';
+import { DefaultWrapper } from './body-positioned-wrapper/default-wrapper';
 import { PositionRelativeToWrapper } from './body-positioned-wrapper/position-relative-to-wrapper';
 import { VegaModalWrapper } from './body-positioned-wrapper/vega-modal-wrapper';
 import { VegaPopoverWrapper } from './body-positioned-wrapper/vega-popover-wrapper';

package/dist/collection/helpers/slimmers/{element-appender-slimmer.js → element-appender/element-appender-slimmer.js}

@@ -5,11 +5,11 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
 import { MapToComponentMethod, VegaSlimmer } from 'vega-slimmer/core';
-import { ElementAppender } from '../ui/element-appender';
-import { findParent, isParent } from '../../utils/ui';
-import ChangeManager from '../change-manager/change-manager';
-import { SHADOW_ROOT_ELEMENT_SCROLLING } from '../change-manager/subject/static-subject/static-subject-title';
-import { Observer } from '../change-manager/observer/observer';
+import { ElementAppender } from '../../ui/element-appender';
+import { findParent, isParent } from '../../../utils/ui';
+import ChangeManager from '../../change-manager/change-manager';
+import { SHADOW_ROOT_ELEMENT_SCROLLING } from '../../change-manager/subject/static-subject/static-subject-title';
+import { Observer } from '../../change-manager/observer/observer';
 export class ElementAppenderSlimmer extends VegaSlimmer {
   constructor(showConfigFactory, getTrigger, isDropdownShowName = 'isDropdownShow', disableInteractiveGetter = () => false) {
     super();

package/dist/collection/helpers/slimmers/{test → element-appender/test}/element-appender-slimmer.test.js

@@ -5,13 +5,13 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
 import { MockHTMLElement } from '@stencil/core/mock-doc';
-import { triggerMouseEvent } from '../../../utils/spec-utils';
-import '../../../polyfill/test-polyfill/unit/index';
+import { triggerMouseEvent } from '../../../../utils/spec-utils';
+import '../../../../polyfill/test-polyfill/unit/index';
 import { InjectVegaSlimmer, MapToComponentField } from 'vega-slimmer/core';
 import { ElementAppenderSlimmer } from '../element-appender-slimmer';
-import { LogUtility } from '../../../utils/log';
-import ChangeManager from '../../change-manager/change-manager';
-import { SHADOW_ROOT_ELEMENT_SCROLLING } from '../../change-manager/subject/static-subject/static-subject-title';
+import { LogUtility } from '../../../../utils/log';
+import ChangeManager from '../../../change-manager/change-manager';
+import { SHADOW_ROOT_ELEMENT_SCROLLING } from '../../../change-manager/subject/static-subject/static-subject-title';
 describe('ElementAppender slimmer test suite', () => {
   const mockedComponentDidLoadMethod = jest.fn();
   const mockedComponentDisconnectedCallbackMethod = jest.fn();

package/dist/collection/helpers/slimmers/field-error-ui-controller-slimmer.js

@@ -78,7 +78,7 @@ export class FieldErrorUIControllerSlimmer extends VegaSlimmer {
    * Get the error container, if it doesn't exist, create it
    *
    * @param {HTMLElement} inputContainer - The input element container.
-   * @returns {HTMLElement} The error container.
+   * @returns {HTMLElement | undefined} The error container.
    */
   getErrorContainer(inputContainer) {
     for (const strategy of this.fieldErrorUiControllerStrategies) {

package/dist/collection/helpers/slimmers/form-field-controller-slimmer.js

@@ -130,7 +130,8 @@ export class FormFieldControllerSlimmer extends VegaSlimmer {
    * It takes the property rules from the option, maps them to a function that returns a validation rule,
    * and then filters out any falsy values
    *
-   * @returns {FormFieldValidationRule[]} An array of validation rules.
+   * @typedef T generic type
+   * @returns {FormFieldValidationRule<T>[]} An array of validation rules.
    */
   getPropertyRules() {
     const { propertyRules, attributeGetter } = this.options;

package/dist/collection/helpers/slimmers/mutation-observer/mutation-observer-filters.js

@@ -7,7 +7,7 @@ import { findNodeList } from '../../../utils/array';
  * a string representing the tag name of an HTML element. The function then returns a `MutationFilter`
  * function that filters mutations based on whether any added or removed nodes have the specified tag
  * name.
- * @returns {Function} The `TagNameMutationFilter` function is being returned. It takes a `tagName` parameter of
+ * @returns {MutationFilter} The `TagNameMutationFilter` function is being returned. It takes a `tagName` parameter of
  * type string and returns a `MutationFilter` function that filters mutations based on whether any
  * added or removed nodes have a tag name matching the provided `tagName`.
  */
@@ -28,7 +28,7 @@ export const TagNameMutationFilter = (...tagNames) => {
  * The function `AttributeOldValueMutationFilter` filters mutations based on whether the old attribute
  * value differs from the current attribute value on the host element.
  *
- * @returns { Function }The code snippet defines a function named `AttributeOldValueMutationFilter` that returns a
+ * @returns { MutationFilter }The code snippet defines a function named `AttributeOldValueMutationFilter` that returns a
  * `MutationFilter` function. The `MutationFilter` function takes an array of `MutationRecord` objects
  * and an `HTMLElement` as parameters.
  */
@@ -41,7 +41,7 @@ export const AttributeOldValueMutationFilter = () => {
  * Filters mutations based on specified tag names or attribute changes.
  *
  * @param {string[]} tagNames - The tagName of need listened child.
- * @returns {Function} - Filter function.
+ * @returns {MutationFilter} - Filter function.
  */
 export const TagNameAndAttributeMutationFilter = (...tagNames) => {
   return (mutations) => {

package/dist/collection/helpers/slimmers/position-calculation/base-position-calculation-strategy.js

@@ -336,7 +336,7 @@ export class BasePositionCalculationStrategy extends VegaSlimmer {
   /**
    * Retrieves and formats the translocation.
    *
-   * @returns {TranslocationType} current translocation.
+   * @returns {Nullable<TranslocationType>} current translocation.
    */
   getTranslocation() {
     const translocation = this.showConfig.translocation;

package/dist/collection/helpers/slimmers/position-calculation/test/body-position-calculation-strategy.test.js

@@ -7,7 +7,7 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 import { InjectVegaSlimmer } from 'vega-slimmer/core';
 import { LogUtility } from '../../../../utils/log';
 import { PositionCalculationController } from '../position-calculation-controller';
-import { ElementAppenderContainerController } from '../../element-appender-container/element-appender-container-controller';
+import { ElementAppenderContainerController } from '../../element-appender/element-appender-container-controller';
 export class PositionCalculationMockedComponent {
   constructor() {
     this.elementAppenderContainerController = new ElementAppenderContainerController();