@globalpayments/vega 2.73.0 → 2.76.0

package/dist/types/components.d.ts

@@ -5,7 +5,7 @@
  * It contains typing information for all components that exist in this project.
  */
 import { HTMLStencilElement, JSXBase } from "./stencil-public-runtime";
-import { BorderStyleType, BoxDisplayType, CornersType, CssStatesType, ElementAppenderAlignmentType, ElementAppenderPlacementType, FlexAlignItemType, FlexDirectionType, FlexJustifyContentType, FlexWrapType, GapType, GridColumnsType, GridRowsType, HeightType, IconAlignType, MarginType, MaxHeightType, MinHeightType, PaddingType, PlacementType, PositionAlignmentType, ResponsiveType, SizeType, StateVariantType, TextAlignType, TranslocationType, VegaComponentInterface, VegaFlexProps, WidthType } from "./types/ui.type";
+import { BorderStyleType, BoxDisplayType, CornersType, CssStatesType, ElementAppenderAlignmentType, ElementAppenderPlacementType, FlexAlignItemType, FlexDirectionType, FlexJustifyContentType, FlexWrapType, GapType, GridColumnsType, GridRowsType, HeightType, IconAlignType, MarginType, MaxHeightType, MinHeightType, PaddingType, PlacementType, PositionAlignmentType, ResponsiveType, SizeType, StateVariantType, TextAlignType, TranslocationType, VegaComponentInterface, VegaEATriggerType, VegaFlexProps, WidthType } from "./types/ui.type";
 import { LinkTargetType, VegaAppFooterLink } from "./components/vega-app-footer/types";
 import { VegaAppHeaderAvatarConfig, VegaAppHeaderButtonDropdownConfig, VegaAppHeaderButtonSize } from "./components/vega-app-header-button/types";
 import { VegaBannerActionButtonType, VegaBannerPropType } from "./components/vega-banner/types";
@@ -35,11 +35,11 @@ import { VegaCountryCode } from "./types/flag.type";
 import { VegaFontAs } from "./components/vega-font/types";
 import { FormControlOption, FormValidateResult, VegaFormFieldValidationState } from "./components/vega-form/types";
 import { VegaFile, VegaFileOptional, VegaImageUploaderStatus } from "./components/vega-image-uploader/types";
-import { DataTransferType, InputAutocompleteTypes, InputType, InputValueUpdateTriggeredBy, MaskConfigType } from "./components/vega-input/types";
+import { DataTransferType, InputAutocompleteTypes, InputType, InputValueUpdateTriggeredBy, MaskConfigType, VegaInputSuggestionsDropdownConfig } from "./components/vega-input/types";
 import { FormFieldValidationRule as FormFieldValidationRule1 } from "./types/components.type";
 import { VegaCountryType } from "./components/vega-input-phone-number/types";
 import { InputRangeStackType, InputRangeValueType } from "./components/vega-input-range/types";
-import { SelectedLabelType, SelectSourceItem, SelectType, SelectValueType, VegaDropdownPropsForSelect, VegaInputSelectSize, VegaInputSelectSourceLazyLoadCallback } from "./components/vega-input-select/types";
+import { SelectedLabelType, SelectedLabelTypeForAllModes, SelectSourceItem, SelectType, SelectValueType, VegaDropdownPropsForSelect, VegaInputSelectSize, VegaInputSelectSourceLazyLoadCallback } from "./components/vega-input-select/types";
 import { ItemToggleStatusMap } from "./components/vega-item-toggle/types";
 import { autoCollapseGroupsType, LeftNavCounterBadgeConfig, LeftNavHeaderConfig, LeftNavSectionHeaderConfig, LeftNavSourceItem } from "./components/vega-nav/interface";
 import { LineChartOptionsType } from "./helpers/chart/line-chart";
@@ -48,7 +48,7 @@ import { VegaModalBackdrop, VegaModalBackdropColor } from "./components/vega-mod
 import { VegaPageNotificationActionButtonConfig, VegaPageNotificationTypes } from "./components/vega-page-notification/types";
 import { DropdownPropsForPagination, VegaPaginationItemType, VegaPaginationLayoutType } from "./components/vega-pagination/types";
 import { PieChartOptions } from "./helpers/chart/pie-chart";
-import { VegaProgressTrackerDirectionType } from "./components/vega-progress-tracker/type";
+import { VegaProgressTrackerDirectionType, VegaProgressTrackerStepItem } from "./components/vega-progress-tracker/type";
 import { VegaRTEContent } from "./components/vega-rich-text-editor/dto/content-state";
 import { VegaRTEExtension } from "./components/vega-rich-text-editor/extensions/extension.abstract";
 import { VegaRichTextEditorImage, VegaRTESourceEditConfig, VegaRTEToolbarItem } from "./components/vega-rich-text-editor/interface";
@@ -1507,6 +1507,11 @@ export namespace Components {
           * @vegaVersion 1.11.0
          */
         "search": (input: string) => Promise<void>;
+        /**
+          * Specifies the no search results text for the dropdown.
+          * @vegaVersion 2.74.0
+         */
+        "searchNoResultsText": string;
         /**
           * Determines whether the dropdown search is triggered by input or pressing the Enter key.
           * @vegaVersion 2.26.0
@@ -1554,12 +1559,13 @@ export namespace Components {
          */
         "translocation": ResponsiveType<TranslocationType>;
         /**
-          * Specifies the trigger mode for the dropdown.
+          * Specifies the trigger mode for the dropdown.   hover: The dropdown is shown/hidden on hover, and listens for global area clicks.   click: The dropdown is shown/hidden on click, and listens for global area clicks.   none: The dropdown does not listen for any events; you must control its visibility within the component.   custom: Custom trigger strategy, more information can refer to https://gethired.atlassian.net/wiki/spaces/VKB/pages/657031171/Trigger+strategy.
           * @vegaVersion 1.3.0
          */
-        "trigger": 'hover' | 'click' | 'none';
+        "trigger": VegaEATriggerType;
         /**
           * Determines whether to enable source filtering based on input words.  When set to 'false', the component will emit a `vegaSearch` event    when input words are provided. In this case, you are responsible for    managing the source, including adding, deleting, and updating the source.  Note that the `dynamicOption` property will not work when    this property is set to `false`.
+          * @VegaWarning Set `preserveValueIfNotInSource` to 'true' to get custom filter fully supported when set to 'false'.
           * @vegaVersion 1.24.0
          */
         "useDefaultFilter": boolean;
@@ -2051,6 +2057,11 @@ export namespace Components {
           * @vegaVersion 1.0.5
          */
         "email": boolean;
+        /**
+          * Invoke this method to hide the suggestions dropdown.
+          * @vegaVersion 2.75.0
+         */
+        "hideSuggestionsDropdown": () => Promise<void>;
         /**
           * Provides a supplementary prompt message that assists users in    understanding the expected value for the input field.
           * @vegaVersion 1.3.0
@@ -2131,11 +2142,21 @@ export namespace Components {
           * @vegaVersion 1.3.0
          */
         "showClearIcon": boolean;
+        /**
+          * Invoke this method to show the suggestions dropdown.
+          * @vegaVersion 2.75.0
+         */
+        "showSuggestionsDropdown": (dropdownConfig?: VegaInputSuggestionsDropdownConfig) => Promise<void>;
         /**
           * Defines the size of the input field,    specifying its width or length.
           * @vegaVersion 1.3.0
          */
         "size": 'default' | 'small';
+        /**
+          * Sets the source array of items for the suggestion dropdown.    You should set this property at least a empty array if you want enable the source mode suggestion dropdown feature.
+          * @vegaVersion 2.75.0
+         */
+        "suggestionsDropdownSource": VegaDropdownSourceItem[];
         /**
           * Defines the specific type or category of the input field.  It specifies the intended format or purpose of the    data to be entered by the user.
           * @vegaVersion 1.0.9
@@ -2588,10 +2609,10 @@ export namespace Components {
          */
         "selectType": SelectType;
         /**
-          * Allows customization of the text displayed within the    select field when multiple items are selected.    The default format for the selected label is    `${number of selected items} Selected`.
+          * Allows customization of the text displayed within the    select field when single or multiple items are selected.    The default format for the selected label is    `${number of selected items} Selected` for multiple mode only.  To enable all modes, use the `SelectedLabelTypeForAllModes` type. 		For single mode, the default format is the `displayName` of the selected item if not set 		For multiple mode, the default format is `${number of selected items} Selected` if not set
           * @vegaVersion 1.35.0
          */
-        "selectedLabel": SelectedLabelType;
+        "selectedLabel": SelectedLabelType | SelectedLabelTypeForAllModes;
         /**
           * Defines the size of the input select field.
           * @vegaVersion 1.18.0
@@ -3152,9 +3173,14 @@ export namespace Components {
           * Specifies an array of step subtitles for    the Progress Tracker component.  Each subtitle corresponds to a step in the    progression of the workflow or process.
           * @vegaVersion 1.3.0
          */
-        "steps": string[];
+        "steps": string[] | VegaProgressTrackerStepItem[];
     }
     interface VegaProgressTrackerStep {
+        /**
+          * If step is clickable.
+          * @vegaVersion 2.76.0
+         */
+        "clickable": boolean;
         /**
           * The unique key for the step.
           * @vegaVersion 2.73.0
@@ -7362,6 +7388,11 @@ declare namespace LocalJSX {
           * @vegaVersion 2.46.0
          */
         "resettable"?: boolean;
+        /**
+          * Specifies the no search results text for the dropdown.
+          * @vegaVersion 2.74.0
+         */
+        "searchNoResultsText"?: string;
         /**
           * Determines whether the dropdown search is triggered by input or pressing the Enter key.
           * @vegaVersion 2.26.0
@@ -7398,12 +7429,13 @@ declare namespace LocalJSX {
          */
         "translocation"?: ResponsiveType<TranslocationType>;
         /**
-          * Specifies the trigger mode for the dropdown.
+          * Specifies the trigger mode for the dropdown.   hover: The dropdown is shown/hidden on hover, and listens for global area clicks.   click: The dropdown is shown/hidden on click, and listens for global area clicks.   none: The dropdown does not listen for any events; you must control its visibility within the component.   custom: Custom trigger strategy, more information can refer to https://gethired.atlassian.net/wiki/spaces/VKB/pages/657031171/Trigger+strategy.
           * @vegaVersion 1.3.0
          */
-        "trigger"?: 'hover' | 'click' | 'none';
+        "trigger"?: VegaEATriggerType;
         /**
           * Determines whether to enable source filtering based on input words.  When set to 'false', the component will emit a `vegaSearch` event    when input words are provided. In this case, you are responsible for    managing the source, including adding, deleting, and updating the source.  Note that the `dynamicOption` property will not work when    this property is set to `false`.
+          * @VegaWarning Set `preserveValueIfNotInSource` to 'true' to get custom filter fully supported when set to 'false'.
           * @vegaVersion 1.24.0
          */
         "useDefaultFilter"?: boolean;
@@ -8078,12 +8110,24 @@ declare namespace LocalJSX {
           * @vegaVersion 2.25.0
          */
         "onLabelButtonClick"?: (event: VegaInputCustomEvent<any>) => void;
+        /**
+          * An event emitter notifying a value change by input action of native input dom.
+          * @eventSemantics namespace:native
+          * @vegaVersion 2.75.0
+         */
+        "onNativeInputChange"?: (event: VegaInputCustomEvent<string>) => void;
         /**
           * An event emitter notifying the paste of the inner input element.
           * @eventSemantics namespace:native
           * @vegaVersion 2.66.0
          */
         "onPaste"?: (event: VegaInputCustomEvent<DataTransferType>) => void;
+        /**
+          * An event emitter notifying the click of a suggestion item.
+          * @eventSemantics namespace:native
+          * @vegaVersion 2.75.0
+         */
+        "onSuggestionItemClick"?: (event: VegaInputCustomEvent<VegaDropdownSourceItem>) => void;
         /**
           * An event emitter notifying the blur of the inner input element.
           * @vegaVersion 1.3.0
@@ -8104,11 +8148,21 @@ declare namespace LocalJSX {
           * @vegaVersion 2.25.0
          */
         "onVegaLabelButtonClick"?: (event: VegaInputCustomEvent<any>) => void;
+        /**
+          * An event emitter notifying a value change by input action of native input dom.
+          * @vegaVersion 2.75.0
+         */
+        "onVegaNativeInputChange"?: (event: VegaInputCustomEvent<string>) => void;
         /**
           * An event emitter notifying the paste of the inner input element.
           * @vegaVersion 2.66.0
          */
         "onVegaPaste"?: (event: VegaInputCustomEvent<DataTransferType>) => void;
+        /**
+          * An event emitter notifying the click of a suggestion item.
+          * @vegaVersion 2.75.0
+         */
+        "onVegaSuggestionItemClick"?: (event: VegaInputCustomEvent<VegaDropdownSourceItem>) => void;
         /**
           * Specifies a placeholder string that displays as a temporary hint    or example inside the input field.  It indicates the expected format or pattern of the input.
           * @vegaVersion 1.3.0
@@ -8134,6 +8188,11 @@ declare namespace LocalJSX {
           * @vegaVersion 1.3.0
          */
         "size"?: 'default' | 'small';
+        /**
+          * Sets the source array of items for the suggestion dropdown.    You should set this property at least a empty array if you want enable the source mode suggestion dropdown feature.
+          * @vegaVersion 2.75.0
+         */
+        "suggestionsDropdownSource"?: VegaDropdownSourceItem[];
         /**
           * Defines the specific type or category of the input field.  It specifies the intended format or purpose of the    data to be entered by the user.
           * @vegaVersion 1.0.9
@@ -8724,10 +8783,10 @@ declare namespace LocalJSX {
          */
         "selectType"?: SelectType;
         /**
-          * Allows customization of the text displayed within the    select field when multiple items are selected.    The default format for the selected label is    `${number of selected items} Selected`.
+          * Allows customization of the text displayed within the    select field when single or multiple items are selected.    The default format for the selected label is    `${number of selected items} Selected` for multiple mode only.  To enable all modes, use the `SelectedLabelTypeForAllModes` type. 		For single mode, the default format is the `displayName` of the selected item if not set 		For multiple mode, the default format is `${number of selected items} Selected` if not set
           * @vegaVersion 1.35.0
          */
-        "selectedLabel"?: SelectedLabelType;
+        "selectedLabel"?: SelectedLabelType | SelectedLabelTypeForAllModes;
         /**
           * Defines the size of the input select field.
           * @vegaVersion 1.18.0
@@ -9364,9 +9423,14 @@ declare namespace LocalJSX {
           * Specifies an array of step subtitles for    the Progress Tracker component.  Each subtitle corresponds to a step in the    progression of the workflow or process.
           * @vegaVersion 1.3.0
          */
-        "steps"?: string[];
+        "steps"?: string[] | VegaProgressTrackerStepItem[];
     }
     interface VegaProgressTrackerStep {
+        /**
+          * If step is clickable.
+          * @vegaVersion 2.76.0
+         */
+        "clickable"?: boolean;
         /**
           * The unique key for the step.
           * @vegaVersion 2.73.0

package/dist/types/constants/ui.d.ts

@@ -12,5 +12,5 @@ export declare const FlexWrap: readonly ["nowrap", "wrap", "wrap-reverse"];
 export declare const BoxDisplay: readonly ["block", "inline-block", "none"];
 export declare const BorderStyle: readonly ["solid", "dashed", "dotted", "double", "none"];
 export declare const TextAlign: readonly ["start", "end", "left", "right", "center", "justify"];
-export declare const VegaNativeEventName: readonly ["change", "click", "focus", "blur", "close", "modalOpen", "validate", "formSubmit", "formReset", "rowClick", "rowExpand", "selectChange", "selectAllChange", "pageSizeChange", "dropdownClick", "create", "search", "searchTrigger", "hide", "show", "popoverShow", "popoverHide", "cancel", "remove", "pageUpdate", "currentStepUpdate", "toggleStatus", "stateUpdate", "groupClick", "menuClick", "accordionExpand", "dropdownShow", "dropdownHide", "dropdownSearch", "actionClick", "eventClick", "dateDblClick", "dateClick", "countryChange", "actionButtonClick", "moreActionClick", "expand", "rowSelect", "rowSelectAll", "retry", "selectedFileChange", "preview", "labelButtonClick", "imageInserted", "reset", "eventPreviewShow", "monthYearChange", "complete", "paste", "clear", "periodChange", "selectionChange"];
+export declare const VegaNativeEventName: readonly ["change", "click", "focus", "blur", "close", "modalOpen", "validate", "formSubmit", "formReset", "rowClick", "rowExpand", "selectChange", "selectAllChange", "pageSizeChange", "dropdownClick", "create", "search", "searchTrigger", "hide", "show", "popoverShow", "popoverHide", "cancel", "remove", "pageUpdate", "currentStepUpdate", "toggleStatus", "stateUpdate", "groupClick", "menuClick", "accordionExpand", "dropdownShow", "dropdownHide", "dropdownSearch", "actionClick", "eventClick", "dateDblClick", "dateClick", "countryChange", "actionButtonClick", "moreActionClick", "expand", "rowSelect", "rowSelectAll", "retry", "selectedFileChange", "preview", "labelButtonClick", "imageInserted", "reset", "eventPreviewShow", "monthYearChange", "complete", "paste", "clear", "periodChange", "selectionChange", "suggestionItemClick", "nativeInputChange"];
 export declare const CssStates: readonly ["default", "hover", "active", "focus-visible"];

package/dist/types/helpers/code-format/code-formatter.d.ts

@@ -6,7 +6,20 @@ export declare type CodeFormatOptions = {
  * Class to format HTML code with proper indentation and style cleanup.
  */
 declare class CodeFormatter {
+  /**
+   * Inline/phrasing elements that should be kept on a single line with their content.
+   * These tags are formatted as: <tag>content</tag> on one line.
+   */
   private static readonly INLINE_TAGS;
+  /**
+   * Void/self-closing elements that don't have closing tags.
+   * Used to avoid increasing indentation for these elements.
+   */
+  private static readonly VOID_TAGS;
+  /**
+   * Tags whose content should be preserved as-is without formatting.
+   */
+  private static readonly PRESERVE_CONTENT_TAGS;
   /**
    * Extracts the tag name from an HTML tag string.
    *
@@ -16,6 +29,7 @@ declare class CodeFormatter {
   private static getTagName;
   /**
    * Formats a given HTML source string by applying indentation and cleaning up styles.
+   * Content inside preserve tags (pre) is preserved as-is without formatting.
    *
    * @param {string} source - The HTML source string to format.
    * @param {CodeFormatOptions} options - Formatting options.

package/dist/types/helpers/common/index.d.ts

@@ -1,15 +1,2 @@
-import { HTMLVegaElementType } from './wait-for-vega-handler';
-import { HTMLStencilElement } from '../../stencil-public-runtime';
-/**
- * Wait for all vega elements to be ready.
- *
- * The below method is e2e-test covered in @see{module:wait-for-vega-should-work-as-expected}
- */
-export declare const waitForVega: () => Promise<Awaited<HTMLVegaElementType>[]>;
-/**
- * Wait for the component has been rendered.
- *
- * @param {HTMLStencilElement} componentRef - The reference to the component that needs to be rendered.
- * @returns {Promise<unknown>} A promise that resolves when the component has been rendered.
- */
-export declare const waitForComponentDidRender: (componentRef: HTMLStencilElement) => Promise<unknown>;
+export { waitForVega } from './wait-for-vega-handler';
+export { waitForComponentDidRender } from './wait-for-component-did-render';

package/dist/types/helpers/common/wait-for-component-did-render.d.ts

@@ -0,0 +1,8 @@
+import { HTMLStencilElement } from '../../stencil-public-runtime';
+/**
+ * Wait for the component has been rendered.
+ *
+ * @param {HTMLStencilElement} componentRef - The reference to the component that needs to be rendered.
+ * @returns {Promise<unknown>} A promise that resolves when the component has been rendered.
+ */
+export declare const waitForComponentDidRender: (componentRef: HTMLStencilElement) => Promise<unknown>;

package/dist/types/helpers/common/wait-for-vega-handler.d.ts

@@ -1,19 +1,10 @@
 import { VegaComponentInterface } from '../../types/ui.type';
-import { VegaPublicAPIRuntimeMetricsSlimmerBase } from '../slimmers/runtime-metrics/public-api-runtime-metrics-slimmer-base';
 export declare type HTMLVegaElementType = VegaComponentInterface<any>;
 /**
- * WaitForVegaHandler to check whether the vega component has been loaded.
+ * Wait for all vega elements to be ready.
+ *
+ * The below method is e2e-test covered in @see{module:wait-for-vega-should-work-as-expected}
+ *
+ * @returns {Promise} A promise that resolves when all vega elements are ready.
  */
-declare class WaitForVegaHandler {
-  protected vegaPublicAPIRuntimeMetricsSlimmer: VegaPublicAPIRuntimeMetricsSlimmerBase;
-  /**
-   * Wait for all vega elements to be ready.
-   *
-   * The below method is e2e-test covered in @see{module:wait-for-vega-should-work-as-expected}
-   *
-   * @vegaVersion 2.8.0
-   */
-  handle(): Promise<Awaited<HTMLVegaElementType>[]>;
-}
-export declare const WaitForVega: WaitForVegaHandler;
-export {};
+export declare const waitForVega: () => Promise<Awaited<HTMLVegaElementType>[]>;

package/dist/types/helpers/event-manager/event-id/vega-event-id.d.ts

@@ -99,3 +99,5 @@ export declare const VegaPaste: VegaEventID;
 export declare const HTMLNativeEventIds: VegaEventID[];
 export declare const VegaMonthYearChange: VegaEventID;
 export declare const VegaSelectionChange: VegaEventID;
+export declare const VegaSuggestionItemClick: VegaEventID;
+export declare const VegaNativeInputChange: VegaEventID;

package/dist/types/helpers/feature-control/feature-flag.d.ts

@@ -59,4 +59,5 @@ export type FeatureFlagKey =
 	| 'VEGA_TABLE.REVERSE_SORT_ORDER'
 	| 'VEGA_PAGINATION.ENABLE_EXTENSIONS_RESPONSIVE_DEFAULT_VALUE'
 	| 'VEGA_COMPONENT.CORNERS_USE_OLD_BEHAVIOR'
-	| 'VEGA_INPUT_PHONE_NUMBER.ENABLE_CALCULATION_POSITION_BY_SCREEN';
+	| 'VEGA_INPUT_PHONE_NUMBER.ENABLE_CALCULATION_POSITION_BY_SCREEN'
+	| 'VEGA_ELEMENT_APPENDER.AUTO_PLACEMENT';

package/dist/types/helpers/public-api.d.ts

@@ -15,6 +15,4 @@ export { waitForVega } from './common';
 export { IconPayload } from './icon/interface';
 export { VegaSkeletonLoader } from './skeleton-loader/vega-skeleton-loader-controller';
 export { VegaTranslation, en as VegaTranslationResourceEN } from './translation';
-export { VegaRTEContent } from '../components/vega-rich-text-editor/dto/content-state';
 export { setVegaNonce } from './csp/vega-nonce-manager';
-export * from '../components/vega-rich-text-editor/public-api';

package/dist/types/helpers/slimmers/element-appender/element-appender-slimmer.d.ts

@@ -2,15 +2,9 @@ import { VegaSlimmer } from '../../../vega-slimmer/vega-slimmer-core';
 import { ElementAppender, ElementAppenderShowConfig } from '../../ui/element-appender';
 import { Nullable } from '../../../types/general';
 import { ElementAppenderHierarchyTreeManager } from './element-appender-hierarchy-tree-manager';
+import { VegaEATriggerType } from '../../../types/ui.type';
 declare type ShowConfigFactoryType = () => ElementAppenderShowConfig;
-/**
- * - click: means the dropdown show/hide by click, it also listen global area click. example: VegaPopover
- * - hover: means the dropdown show/hide by hover, it also listen global area click. example: VegaDropdown VegaAppHeaderButton
- * - none: means element appender not listens any event, you should control the dropdown show/hide in component. example: VegaDatePicker
- * - custom: means element appender only listen the outer area click. when clicked the dropdown will hide. example: VegaTimePicker
- */
-declare type TriggerType = 'click' | 'hover' | 'none' | 'custom';
-declare type GetTriggerType = () => TriggerType;
+declare type GetTriggerType = () => VegaEATriggerType;
 declare type DisableInteractiveGetter = () => boolean;
 export declare class ElementAppenderSlimmer extends VegaSlimmer {
   private static readonly DELAY_HIDE_TIME;
@@ -58,7 +52,6 @@ export declare class ElementAppenderSlimmer extends VegaSlimmer {
   private globalScrollHandler;
   private createDelayHideTimer;
   private clearDelayHideTimer;
-  private shouldListenerWork;
   /**
    * Sets up an observer to handle scroll events in a shadow root element.
    */
@@ -74,5 +67,7 @@ export declare class ElementAppenderSlimmer extends VegaSlimmer {
    * Remove observer for scrolling in a shadow root element.
    */
   private removeShadowRootElementScrolling;
+  private executeTriggerStrategy;
+  private getTriggerStrategy;
 }
 export {};

package/dist/types/helpers/slimmers/element-appender/trigger-strategies/click-outside-only-to-dismiss-strategy.d.ts

@@ -0,0 +1,21 @@
+import { VegaEAEventType } from '../../../../types/ui.type';
+import { VegaEATriggerStrategy, VegaEATriggerContext, VegaEATriggerResult } from './trigger-strategy.interface';
+/**
+ * A trigger strategy that hides the appendable element when a global mouse down event occurs outside the element.
+ */
+export declare class ClickOutsideOnlyToDismissStrategy implements VegaEATriggerStrategy {
+  /**
+   * Determines if the strategy can evaluate the given event type.
+   *
+   * @param {VegaEAEventType} type - The type of the event.
+   * @returns {boolean} True if the event type is 'globalMouseDown', otherwise false.
+   */
+  canEvaluate(type: VegaEAEventType): boolean;
+  /**
+   * Evaluates the trigger context and determines whether to hide the appendable element.
+   *
+   * @param {VegaEATriggerContext} context - The context of the trigger event.
+   * @returns {VegaEATriggerResult} An object indicating whether to hide the appendable element.
+   */
+  evaluate(context: VegaEATriggerContext): VegaEATriggerResult;
+}

package/dist/types/helpers/slimmers/element-appender/trigger-strategies/click-trigger-strategy.d.ts

@@ -0,0 +1,21 @@
+import { VegaEAEventType } from '../../../../types/ui.type';
+import { VegaEATriggerStrategy, VegaEATriggerContext, VegaEATriggerResult } from './trigger-strategy.interface';
+/**
+ * ClickTriggerStrategy handles 'targetClick' and 'globalMouseDown' events to toggle or hide the appendable element.
+ */
+export declare class ClickTriggerStrategy implements VegaEATriggerStrategy {
+  /**
+   * Determines if the strategy can evaluate the given event type.
+   *
+   * @param {VegaEAEventType} type - The type of the event.
+   * @returns {boolean} True if the event type is 'targetClick' or 'globalMouseDown', otherwise false.
+   */
+  canEvaluate(type: VegaEAEventType): boolean;
+  /**
+   * Evaluates the trigger context and determines whether to show, hide, or toggle the appendable element.
+   *
+   * @param {VegaEATriggerContext} context - The context of the trigger event.
+   * @returns {VegaEATriggerResult} An object indicating whether to show, hide, or toggle the appendable element.
+   */
+  evaluate(context: VegaEATriggerContext): VegaEATriggerResult;
+}

package/dist/types/helpers/slimmers/element-appender/trigger-strategies/hover-trigger-strategy.d.ts

@@ -0,0 +1,22 @@
+import { VegaEAEventType } from '../../../../types/ui.type';
+import { VegaEATriggerStrategy, VegaEATriggerContext, VegaEATriggerResult } from './trigger-strategy.interface';
+/**
+ * HoverTriggerStrategy handles mouse enter and leave events on the target and appendable elements,
+ * as well as global mouse down events to show or hide the appendable element.
+ */
+export declare class HoverTriggerStrategy implements VegaEATriggerStrategy {
+  /**
+   * Determines if the strategy can evaluate the given event type.
+   *
+   * @param {VegaEAEventType} type - The type of the event.
+   * @returns {boolean} True if the event type is related to hover actions or global mouse down, otherwise false.
+   */
+  canEvaluate(type: VegaEAEventType): boolean;
+  /**
+   * Evaluates the trigger context and determines whether to show, hide, or toggle the appendable element.
+   *
+   * @param {VegaEATriggerContext} context - The context of the trigger event.
+   * @returns {VegaEATriggerResult} An object indicating whether to show, hide, or toggle the appendable element.
+   */
+  evaluate(context: VegaEATriggerContext): VegaEATriggerResult;
+}

package/dist/types/helpers/slimmers/element-appender/trigger-strategies/none-trigger-strategy.d.ts

@@ -0,0 +1,18 @@
+import { VegaEATriggerResult, VegaEATriggerStrategy } from './trigger-strategy.interface';
+/**
+ * NoneTriggerStrategy does not respond to any events and always indicates no action.
+ */
+export declare class NoneTriggerStrategy implements VegaEATriggerStrategy {
+  /**
+   * Determines if the strategy can evaluate the given event type.
+   *
+   * @returns {boolean} Always false as this strategy does not respond to any events.
+   */
+  canEvaluate(): boolean;
+  /**
+   * Evaluates the trigger context and always indicates no action.
+   *
+   * @returns {VegaEATriggerResult} An object indicating no action (no show, hide, or toggle).
+   */
+  evaluate(): VegaEATriggerResult;
+}

package/dist/types/helpers/slimmers/element-appender/trigger-strategies/trigger-strategy.interface.d.ts

@@ -0,0 +1,37 @@
+import { VegaEAEventType } from '../../../../types/ui.type';
+/**
+ * Context for evaluating trigger strategies.
+ *
+ * @param target - The target HTMLElement that the appendable element is associated with.
+ * @param appendableElement - The HTMLElement that is to be shown or hidden.
+ * @param htmlEvent - The html event that triggered the evaluation.
+ * @param eventType - The trigger type of the event.
+ * @param currentState - The current visibility state of the appendable element.
+ */
+export interface VegaEATriggerContext {
+  target: HTMLElement;
+  appendableElement: HTMLElement;
+  htmlEvent: Event;
+  eventType: VegaEAEventType;
+  currentState: {
+    isVisible: boolean;
+  };
+}
+/**
+ * Interface for trigger strategies that determine when to show, hide, or toggle appendable elements.
+ *
+ * @function canEvaluate - Determines if the strategy can evaluate the given event type.
+ * @function evaluate - Evaluates the trigger context and returns the action to be taken.
+ */
+export interface VegaEATriggerStrategy {
+  canEvaluate(type: VegaEAEventType): boolean;
+  evaluate(context: VegaEATriggerContext): VegaEATriggerResult;
+}
+/**
+ * Result of evaluating a trigger strategy.
+ *
+ * @param nextAction - The next action to be taken: 'show' to display the appendable element, 'hide' to conceal it.
+ */
+export interface VegaEATriggerResult {
+  nextAction?: 'show' | 'hide';
+}

package/dist/types/helpers/slimmers/mutation-observer/aria-attributes-value-mapper.d.ts

@@ -0,0 +1,44 @@
+import { MutationObserverSlimmer } from './mutation-observer-slimmer';
+export declare type AriaAttrDependency = {
+  dependency: string[];
+  defaultValue?: string;
+};
+export declare type AriaAttributesMap = Record<string, AriaAttrDependency>;
+/**
+ * Maps component attributes/properties to aria-XXX attributes on an inner native element.
+ * Observes attribute changes on host and updates the target element accordingly.
+ */
+export declare class AriaAttributesValueMapper extends MutationObserverSlimmer {
+  private readonly targetGetter;
+  private readonly ariaMap;
+  /**
+   * Component lifecycle - [componentDidLoad]
+   */
+  componentDidLoad(): void;
+  /**
+   * Run mapping after each component render to ensure refs assigned and
+   * attributes/properties are up-to-date. This guarantees the mapper runs
+   * even when attribute changes are observed before the inner target ref
+   * is available.
+   */
+  componentDidRender(): void;
+  /**
+   * The constructor initializes a class instance with a targetGetter function and an ariaMap.
+   *
+   * @param {() => HTMLElement} targetGetter - a function that returns the target element to set aria attributes on
+   * @param {AriaAttributesMap} ariaMap - a map where the key is the aria attribute to set on the target element, and the value is an object that defines the dependencies (attributes/properties on host to check for value) and an optional default value
+   */
+  constructor(targetGetter: () => HTMLElement, ariaMap: AriaAttributesMap);
+  /**
+   * The `handleMutations` function processes an array of `MutationRecord` objects to determine which attributes have changed and then calls the `performMapping` function to update the corresponding aria attributes on the target element. It collects the names of the changed attributes into a set and passes it to the `performMapping` function, which uses this information to decide which aria attributes need to be updated based on their defined dependencies.
+   *
+   * @param {MutationRecord[]} mutations - an array of MutationRecord objects that represent the changes observed by the MutationObserver. Each MutationRecord contains information about the type of mutation, the target element that was mutated, and any relevant attribute names if the mutation was an attribute change.
+   */
+  private handleMutations;
+  /**
+   * The `performMapping` function updates the aria attributes on the target element based on the defined dependencies in the `ariaMap`. It checks which attributes have changed (if provided) and only updates the aria attributes that depend on those changed attributes. For each aria attribute defined in the `ariaMap`, it looks for the first non-empty value among its dependencies (checking both attributes and properties on the host element) and sets that as the value of the aria attribute on the target element. If all dependencies are empty or undefined, it uses the default value specified in the `ariaMap`. The function also includes error handling when setting attributes on the target element.
+   *
+   * @param {Set<string>} changedAttrs - a set of attribute names that have changed on the host element
+   */
+  private performMapping;
+}

package/dist/types/helpers/slimmers/mutation-observer/test/aria-attributes-value-mapper.test.d.ts

@@ -0,0 +1 @@
+export {};