@globalpayments/vega 2.73.0 → 2.75.1

package/dist/types/components/vega-rich-text-editor/slimmers/controllers/html-cleaner/processors/remove-whitespace-after-opening-tag-processor.d.ts

@@ -0,0 +1,19 @@
+import { HTMLContentCleanerProcessor } from '../html-content-cleaner-processor.interface';
+/**
+ * Removes `\n` and `\t` characters after opening tags (before text content).
+ *
+ * Transforms patterns like `>[\n\t]+(text)` to `>(text)`.
+ *
+ * Examples:
+ * - `<p>\n\tHello` → `<p>Hello`
+ * - `<div>\n\n\tWorld` → `<div>World`
+ */
+export declare class RemoveWhitespaceAfterOpeningTagProcessor implements HTMLContentCleanerProcessor {
+  /**
+   * Process the HTML string to remove `\n` and `\t` after opening tags.
+   *
+   * @param {string} html - The HTML string to process.
+   * @returns {string} The processed HTML string.
+   */
+  process(html: string): string;
+}

package/dist/types/components/vega-rich-text-editor/slimmers/controllers/html-cleaner/processors/remove-whitespace-before-closing-tag-processor.d.ts

@@ -0,0 +1,19 @@
+import { HTMLContentCleanerProcessor } from '../html-content-cleaner-processor.interface';
+/**
+ * Removes `\n` and `\t` characters before closing tags (after text content).
+ *
+ * Transforms patterns like `(text)[\n\t]+<` to `(text)<`.
+ *
+ * Examples:
+ * - `World\n\t</p>` → `World</p>`
+ * - `Hello\n</div>` → `Hello</div>`
+ */
+export declare class RemoveWhitespaceBeforeClosingTagProcessor implements HTMLContentCleanerProcessor {
+  /**
+   * Process the HTML string to remove `\n` and `\t` before closing tags.
+   *
+   * @param {string} html - The HTML string to process.
+   * @returns {string} The processed HTML string.
+   */
+  process(html: string): string;
+}

package/dist/types/components/vega-rich-text-editor/slimmers/controllers/html-cleaner/processors/remove-whitespace-between-tags-processor.d.ts

@@ -0,0 +1,59 @@
+import { HTMLContentCleanerProcessor } from '../html-content-cleaner-processor.interface';
+/**
+ * Removes whitespace between tags, except preserves ALL whitespace between matching opening/closing tag pairs.
+ *
+ * This processor scans for patterns of `<tag>(whitespace)<tag>` and:
+ * - If the first tag is an opening tag and the second tag is its matching closing tag (e.g., `<span> </span>`),
+ *   preserves ALL the whitespace between them (including spaces, tabs, newlines)
+ * - Otherwise, removes all the whitespace between the tags
+ *
+ * Examples:
+ * - `</p>\n\t<div>` → `</p><div>` (different tags: closing p, opening div - whitespace removed)
+ * - `<div>\n\t<span>` → `<div><span>` (different tags: opening div, opening span - whitespace removed)
+ * - `<span> </span>` → `<span> </span>` (matching tags: opening span, closing span - space preserved)
+ * - `<span>  </span>` → `<span>  </span>` (matching tags - multiple spaces preserved)
+ * - `<span>\n\t</span>` → `<span>\n\t</span>` (matching tags - \n\t preserved)
+ * - `<code> </code>` → `<code> </code>` (matching tags - space preserved)
+ * - `</div> <p>` → `</div><p>` (different tags: closing div, opening p - whitespace removed)
+ */
+export declare class RemoveWhitespaceBetweenTagsProcessor implements HTMLContentCleanerProcessor {
+  /**
+   * Process the HTML string to remove whitespace between non-matching tags.
+   *
+   * @param {string} html - The HTML string to process.
+   * @returns {string} The processed HTML string.
+   */
+  process(html: string): string;
+  /**
+   * Extracts the tag name from an opening HTML tag.
+   *
+   * Supports standard HTML tags (div, span, h1, etc.) and custom elements with hyphens (my-component).
+   *
+   * Examples:
+   * - `<span>` → `span`
+   * - `<div class="test">` → `div`
+   * - `<my-component id="123">` → `my-component`
+   * - `</span>` → `null` (not an opening tag)
+   *
+   * @param {string} tag - The tag string to extract from (e.g., '<span>', '<div class="test">').
+   * @returns {string | null} The tag name or null if not an opening tag.
+   * @private
+   */
+  private extractOpeningTagName;
+  /**
+   * Extracts the tag name from a closing HTML tag.
+   *
+   * Supports standard HTML tags (div, span, h1, etc.) and custom elements with hyphens (my-component).
+   *
+   * Examples:
+   * - `</span>` → `span`
+   * - `</div>` → `div`
+   * - `</my-component>` → `my-component`
+   * - `<span>` → `null` (not a closing tag)
+   *
+   * @param {string} tag - The tag string to extract from (e.g., '</span>', '</div>').
+   * @returns {string | null} The tag name or null if not a closing tag.
+   * @private
+   */
+  private extractClosingTagName;
+}

package/dist/types/components/vega-rich-text-editor/slimmers/controllers/value-controller.d.ts

@@ -12,6 +12,7 @@ export declare class ValueController extends VegaSlimmer {
   valueController: VegaRichTextEditor['valueController'];
   historyController: VegaRichTextEditor['historyController'];
   selectionController: VegaRichTextEditor['selectionController'];
+  sourceEditConfig: VegaRichTextEditor['sourceEditConfig'];
   private flushChangeObserver;
   /**
    * Component lifecycle - [connectedCallback]{@link VegaRichTextEditor.connectedCallback}

package/dist/types/components/vega-rich-text-editor/slimmers/renderers/tools/source-edit-toolbar-button-slimmer.d.ts

@@ -6,6 +6,7 @@ export declare class SourceEditToolbarButtonSlimmer extends ToolbarButtonSlimmer
   valueController: VegaRichTextEditor['valueController'];
   vegaRichTextEditorRenderer: VegaRichTextEditor['vegaRichTextEditorRenderer'];
   sourceEditConfig: VegaRichTextEditor['sourceEditConfig'];
+  value: VegaRichTextEditor['value'];
   constructor();
   protected onClick(): Promise<void>;
   protected isSelected(): boolean;

package/dist/types/components/vega-rich-text-editor/test/html-cleaner/html-content-cleaner.test.d.ts

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

package/dist/types/components/vega-rich-text-editor/test/html-cleaner/remove-whitespace-after-opening-tag-processor.test.d.ts

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

package/dist/types/components/vega-rich-text-editor/test/html-cleaner/remove-whitespace-before-closing-tag-processor.test.d.ts

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

package/dist/types/components/vega-rich-text-editor/test/html-cleaner/remove-whitespace-between-tags-processor.test.d.ts

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

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";
@@ -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
@@ -7362,6 +7383,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 +7424,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 +8105,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 +8143,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 +8183,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 +8778,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

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/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/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/types/components.type.d.ts

@@ -32,6 +32,7 @@ export {
 	TextAlignType,
 	TranslocationType,
 	VegaComponentInterface,
+	VegaEATriggerType,
 	VegaFlexProps,
 	WidthType,
 } from '../types/ui.type';
@@ -146,12 +147,14 @@ export {
 	InputType,
 	InputValueUpdateTriggeredBy,
 	MaskConfigType,
+	VegaInputSuggestionsDropdownConfig,
 } from '../components/vega-input/types';
 export { FormFieldValidationRule as FormFieldValidationRule1 } from '../types/components.type';
 export { VegaCountryType } from '../components/vega-input-phone-number/types';
 export { InputRangeStackType, InputRangeValueType } from '../components/vega-input-range/types';
 export {
 	SelectedLabelType,
+	SelectedLabelTypeForAllModes,
 	SelectSourceItem,
 	SelectType,
 	SelectValueType,

package/dist/types/types/type-guard.d.ts

@@ -5,6 +5,7 @@ import { DropdownSourceItem } from '../components/vega-dropdown/types';
 import { Nullable } from './general';
 import { VegaTableColumnGroupingModel } from '../components/vega-table/interface';
 import { CalendarDate } from '../helpers/calendar';
+import { VegaEATriggerStrategy } from '../helpers/slimmers/element-appender/trigger-strategies/trigger-strategy.interface';
 /**
  * Returns true if the input is a string that is one of the four directions.
  *
@@ -300,3 +301,10 @@ export declare const isVegaTableColumnGroupingModelType: (input: unknown) => inp
  * @returns {input is CalendarDate} True when input matches the calendar date type.
  */
 export declare const isCalendarDateType: (input: unknown) => input is CalendarDate;
+/**
+ * Type guard to check if the provided instance implements the VegaEATriggerStrategy interface
+ *
+ * @param {unknown} instance - The instance to check.
+ * @returns {instance is VegaEATriggerStrategy} True if the instance implements VegaEATriggerStrategy.
+ */
+export declare const isEATriggerStrategy: (instance: unknown) => instance is VegaEATriggerStrategy;

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

@@ -4,6 +4,7 @@ import { Placements, FlexDirections, Alignments, BoxDisplay, VegaNativeEventName
 import { HTMLStencilElement } from '../stencil-public-runtime';
 import { GridColumns, GridRows } from '../constants/tokens/tailwind.extend';
 import { JSX as LocalJSX } from '../components';
+import { VegaEATriggerStrategy } from '../helpers/slimmers/element-appender/trigger-strategies/trigger-strategy.interface';
 export declare type BrowserVisibleArea = {
   top: number;
   bottom: number;
@@ -156,3 +157,11 @@ export declare type IconAlignType = 'left' | 'right';
 export declare type BorderStyleType = 'solid' | 'dashed' | 'dotted' | 'double' | 'none';
 export declare type TextAlignType = 'start' | 'end' | 'left' | 'right' | 'center' | 'justify';
 export declare type VegaFlexProps = Partial<Pick<HTMLVegaFlexElement, 'gap' | 'direction' | 'alignItems' | 'justifyContent' | 'margin'>>;
+/**
+ * - 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
+ * - VegaEATriggerStrategy: means element appender use custom trigger strategy to control show/hide behavior.
+ */
+export declare type VegaEATriggerType = 'click' | 'hover' | 'none' | VegaEATriggerStrategy;
+export declare type VegaEAEventType = 'target-click' | 'target-mouseenter' | 'target-mouseleave' | 'element-mouseenter' | 'element-mouseleave' | 'click-outside';