@heartlandone/vega 2.74.0 → 2.75.0

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

@@ -6,6 +6,7 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 };
 import { MapToComponentField, MapToComponentMethod } from 'vega-slimmer/core';
 import { ElementAppenderSlimmer } from '../../../../helpers/slimmers/element-appender/element-appender-slimmer';
+import { ClickOutsideOnlyToDismissStrategy } from '../../../../helpers/slimmers/element-appender/trigger-strategies/click-outside-only-to-dismiss-strategy';
 /** 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 {
   /**
@@ -29,7 +30,7 @@ export class VegaTimePickerRangeDropdownController extends ElementAppenderSlimme
         placement: ['bottom', 'top'],
         matchTargetWidth: true,
       };
-    }, () => 'custom', 'isRangeDropdownShow');
+    }, () => new ClickOutsideOnlyToDismissStrategy(), 'isRangeDropdownShow');
     this.isRangeDropdownShow = false;
     this.rangeDropdownType = 'start';
     /*

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

@@ -8,6 +8,7 @@ import { MapToComponentField, MapToComponentMethod } from 'vega-slimmer/core';
 import { ElementAppenderSlimmer } from '../../../../helpers/slimmers/element-appender/element-appender-slimmer';
 import { LogUtility } from '../../../../utils/log';
 import { pad } from '../../../../utils/date';
+import { ClickOutsideOnlyToDismissStrategy } from '../../../../helpers/slimmers/element-appender/trigger-strategies/click-outside-only-to-dismiss-strategy';
 /** The `VegaTimePickerDropdownController` class is responsible for managing the dropdown functionality of the VegaTimePicker component in a TypeScript application. */
 export class VegaTimePickerSingleDropdownController extends ElementAppenderSlimmer {
   /**
@@ -23,7 +24,7 @@ export class VegaTimePickerSingleDropdownController extends ElementAppenderSlimm
       positionRelativeTo: this.positionRelativeTo,
       translocation: { X: 0, Y: 8 },
       placement: ['bottom', 'top'],
-    }), () => 'custom');
+    }), () => new ClickOutsideOnlyToDismissStrategy());
   }
   /**
    * The function initializes a value controller and dropdown source.

package/dist/collection/constants/ui.js

@@ -91,6 +91,8 @@ export const VegaNativeEventName = [
   'clear',
   'periodChange',
   'selectionChange',
+  'suggestionItemClick',
+  'nativeInputChange',
 ];
 // eslint-disable-next-line @typescript-eslint/typedef
 export const CssStates = ['default', 'hover', 'active', 'focus-visible'];

package/dist/collection/helpers/event-manager/event-id/component-event-id-map.js

@@ -1,4 +1,4 @@
-import { VegaExpand, VegaClick, VegaDropdownClick, VegaReset, VegaClose, VegaActionButtonClick, VegaChange, VegaEventClick, VegaDateDblClick, VegaMoreActionClick, VegaDateClick, VegaPageUpdate, VegaRemove, VegaCreate, VegaSearch, VegaMonthYearChange, VegaClear, VegaSelectionChange, VegaDropdownShow, VegaDropdownHide, VegaDropdownSearch, VegaSearchTrigger, VegaLabelButtonClick, VegaSelectFileChange, VegaRetry, VegaPreview, VegaFormSubmit, VegaFormReset, VegaValidate, VegaCancel, VegaFocus, VegaBlur, VegaPaste, VegaComplete, VegaCountryChange, VegaShow, VegaHide, VegaToggleStatus, VegaOpen, VegaStateUpdate, VegaGroupClick, VegaMenuClick, VegaActionClick, VegaPageSizeChange, VegaPopoverShow, VegaPopoverHide, VegaCurrentStepUpdate, VegaImageInserted, VegaSelectChange, VegaSelectAllChange, VegaRowClick, VegaRowExpand, VegaRowSelect, VegaRowSelectAll, } from './vega-event-id';
+import { VegaExpand, VegaClick, VegaDropdownClick, VegaReset, VegaClose, VegaActionButtonClick, VegaChange, VegaEventClick, VegaDateDblClick, VegaMoreActionClick, VegaDateClick, VegaPageUpdate, VegaRemove, VegaCreate, VegaSearch, VegaMonthYearChange, VegaClear, VegaSelectionChange, VegaDropdownShow, VegaDropdownHide, VegaDropdownSearch, VegaSearchTrigger, VegaLabelButtonClick, VegaSelectFileChange, VegaRetry, VegaPreview, VegaFormSubmit, VegaFormReset, VegaValidate, VegaCancel, VegaNativeInputChange, VegaFocus, VegaBlur, VegaSuggestionItemClick, VegaPaste, VegaComplete, VegaCountryChange, VegaShow, VegaHide, VegaToggleStatus, VegaOpen, VegaStateUpdate, VegaGroupClick, VegaMenuClick, VegaActionClick, VegaPageSizeChange, VegaPopoverShow, VegaPopoverHide, VegaCurrentStepUpdate, VegaImageInserted, VegaSelectChange, VegaSelectAllChange, VegaRowClick, VegaRowExpand, VegaRowSelect, VegaRowSelectAll, } from './vega-event-id';
 const entries = [
   ['vega-accordion', [VegaExpand]],
   ['vega-app-header-button', [VegaClick, VegaDropdownClick, VegaReset]],
@@ -35,7 +35,18 @@ const entries = [
   ['vega-file-uploader', [VegaChange, VegaSelectFileChange, VegaRemove, VegaRetry, VegaPreview]],
   ['vega-form', [VegaFormSubmit, VegaFormReset, VegaValidate]],
   ['vega-image-uploader', [VegaChange, VegaRemove, VegaCancel]],
-  ['vega-input', [VegaChange, VegaFocus, VegaBlur, VegaLabelButtonClick, VegaPaste]],
+  [
+    'vega-input',
+    [
+      VegaChange,
+      VegaNativeInputChange,
+      VegaFocus,
+      VegaBlur,
+      VegaLabelButtonClick,
+      VegaSuggestionItemClick,
+      VegaPaste,
+    ],
+  ],
   ['vega-input-credit-card', [VegaChange, VegaBlur, VegaFocus]],
   ['vega-input-numeric', [VegaChange]],
   ['vega-input-passcode', [VegaChange, VegaComplete]],

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

@@ -107,3 +107,5 @@ export const VegaPaste = new VegaEventID('vegaPaste', 'paste');
 export const HTMLNativeEventIds = [VegaChange, VegaClick, VegaFocus, VegaBlur, VegaPaste];
 export const VegaMonthYearChange = new VegaEventID('vegaMonthYearChange', 'monthYearChange');
 export const VegaSelectionChange = new VegaEventID('vegaSelectionChange', 'selectionChange');
+export const VegaSuggestionItemClick = new VegaEventID('vegaSuggestionItemClick', 'suggestionItemClick');
+export const VegaNativeInputChange = new VegaEventID('vegaNativeInputChange', 'nativeInputChange');

package/dist/collection/helpers/event-manager/test/component-event-id-map.test.js

@@ -1,14 +1,16 @@
 import { VEGA_COMPONENT_EVENT_MAP } from '../event-id/component-event-id-map';
-import { VegaBlur, VegaChange, VegaFocus, VegaLabelButtonClick, VegaPaste } from '../event-id/vega-event-id';
+import { VegaBlur, VegaChange, VegaFocus, VegaLabelButtonClick, VegaNativeInputChange, VegaPaste, VegaSuggestionItemClick, } from '../event-id/vega-event-id';
 test('VEGA_COMPONENT_EVENT_MAP size', () => {
   expect(VEGA_COMPONENT_EVENT_MAP.size).not.toEqual(0);
 });
 test('VEGA_COMPONENT_EVENT_MAP vega-input', () => {
   expect(VEGA_COMPONENT_EVENT_MAP.get('vega-input')).toEqual([
     VegaChange,
+    VegaNativeInputChange,
     VegaFocus,
     VegaBlur,
     VegaLabelButtonClick,
+    VegaSuggestionItemClick,
     VegaPaste,
   ]);
 });

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

@@ -1,5 +1,5 @@
 import { VegaEventManager } from '../../public-api';
-import { VegaBlur, VegaChange, VegaCreate, VegaDropdownClick, VegaDropdownHide, VegaDropdownSearch, VegaDropdownShow, VegaFocus, VegaLabelButtonClick, VegaPaste, VegaReset, VegaSearchTrigger, } from '../event-id/vega-event-id';
+import { VegaBlur, VegaChange, VegaCreate, VegaDropdownClick, VegaDropdownHide, VegaDropdownSearch, VegaDropdownShow, VegaFocus, VegaLabelButtonClick, VegaNativeInputChange, VegaPaste, VegaReset, VegaSearchTrigger, VegaSuggestionItemClick, } from '../event-id/vega-event-id';
 import VegaTelemetryRuntimeMetricsManager from '@heartlandone/vega-telemetry-runtime-metrics/index';
 import { sleep } from '../../../utils/test-utils';
 describe('VegaEventManager', () => {
@@ -20,9 +20,11 @@ describe('VegaEventManager', () => {
   it('should work proper while call getNativeEventName', () => {
     expect(VegaEventManager.getEnabledEventIdsByComponent('vega-input')).toEqual([
       VegaChange,
+      VegaNativeInputChange,
       VegaFocus,
       VegaBlur,
       VegaLabelButtonClick,
+      VegaSuggestionItemClick,
       VegaPaste,
     ]);
     expect(VegaEventManager.getEnabledEventIdsByComponent('vega-dropdown')).toEqual([

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

@@ -11,6 +11,10 @@ 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 { ElementAppenderHierarchyTreeManager } from './element-appender-hierarchy-tree-manager';
+import { ClickTriggerStrategy } from './trigger-strategies/click-trigger-strategy';
+import { HoverTriggerStrategy } from './trigger-strategies/hover-trigger-strategy';
+import { NoneTriggerStrategy } from './trigger-strategies/none-trigger-strategy';
+import { isEATriggerStrategy } from '../../../types/type-guard';
 export class ElementAppenderSlimmer extends VegaSlimmer {
   constructor(showConfigFactory, getTrigger, isDropdownShowName = 'isDropdownShow', disableInteractiveGetter = () => false) {
     super();
@@ -36,25 +40,28 @@ export class ElementAppenderSlimmer extends VegaSlimmer {
     };
     /* It's a function that listens to the click event on the dropdown. It checks if the trigger
     property is equal to 'click'. If it is, then it toggles the dropdown. */
-    this.targetClickHandler = () => {
-      if (this.shouldListenerWork('click')) {
-        this.isShowing() ? this.hide() : this.show();
+    this.targetClickHandler = (event) => {
+      const triggerStrategy = this.getTriggerStrategy();
+      if (triggerStrategy.canEvaluate('target-click')) {
+        this.executeTriggerStrategy(triggerStrategy, event, 'target-click');
       }
     };
     /* It's a function that listens to the mouseenter event on the dropdown. It checks if the trigger
     property is equal to 'hover'. If it is, then it clears the timer. */
-    this.targetMouseEnterHandler = () => {
-      if (this.shouldListenerWork('hover')) {
-        this.isShowing() === false && this.show();
+    this.targetMouseEnterHandler = (event) => {
+      const triggerStrategy = this.getTriggerStrategy();
+      if (triggerStrategy.canEvaluate('target-mouseenter')) {
+        this.executeTriggerStrategy(triggerStrategy, event, 'target-mouseenter');
         this.clearDelayHideTimer();
       }
     };
     /* It's a function that listens to the mouseleave event on the dropdown. It checks if the trigger
     property is equal to 'hover'. If it is, then it creates a timer that will hide the dropdown after a
     certain amount of time. */
-    this.targetMouseLeaveHandler = () => {
-      if (this.shouldListenerWork('hover')) {
-        this.createDelayHideTimer();
+    this.targetMouseLeaveHandler = (event) => {
+      const triggerStrategy = this.getTriggerStrategy();
+      if (triggerStrategy.canEvaluate('target-mouseleave')) {
+        this.createDelayHideTimer(event, 'target-mouseleave');
       }
     };
     /* istanbul ignore next */
@@ -62,7 +69,7 @@ export class ElementAppenderSlimmer extends VegaSlimmer {
     this.targetFocusoutHandler = (e) => {
       var _a;
       if (!isParent(e.relatedTarget, (_a = this.showConfig) === null || _a === void 0 ? void 0 : _a.appendableElement)) {
-        this.targetMouseLeaveHandler();
+        this.targetMouseLeaveHandler(e);
       }
     };
     /* It's a function that listens to the mouseenter event on the dropdown. It checks if the trigger
@@ -70,18 +77,20 @@ export class ElementAppenderSlimmer extends VegaSlimmer {
     this.elementMouseEnterHandler = () => {
       var _a;
       (_a = this.hierarchyTreeManager.getParent()) === null || _a === void 0 ? void 0 : _a.elementMouseEnterHandler();
-      if (this.shouldListenerWork('hover') && !this.disableInteractiveGetter()) {
+      const triggerStrategy = this.getTriggerStrategy();
+      if (triggerStrategy.canEvaluate('element-mouseenter') && !this.disableInteractiveGetter()) {
         this.clearDelayHideTimer();
       }
     };
     /* It's a function that listens to the mouseleave event on the dropdown. It checks if the trigger
     property is equal to 'hover'. If it is, then it creates a timer that will hide the dropdown after a
     certain amount of time. */
-    this.elementMouseLeaveHandler = () => {
+    this.elementMouseLeaveHandler = (event) => {
       var _a;
-      (_a = this.hierarchyTreeManager.getParent()) === null || _a === void 0 ? void 0 : _a.elementMouseLeaveHandler();
-      if (this.shouldListenerWork('hover') && !this.disableInteractiveGetter()) {
-        this.createDelayHideTimer();
+      (_a = this.hierarchyTreeManager.getParent()) === null || _a === void 0 ? void 0 : _a.elementMouseLeaveHandler(event);
+      const triggerStrategy = this.getTriggerStrategy();
+      if (triggerStrategy.canEvaluate('element-mouseleave') && !this.disableInteractiveGetter()) {
+        this.createDelayHideTimer(event, 'element-mouseleave');
       }
     };
     /* It's a function that listens to the global mousedown event. It checks if the dropdown is showing,
@@ -92,15 +101,15 @@ export class ElementAppenderSlimmer extends VegaSlimmer {
       const hasChildShowing = this.hierarchyTreeManager
         .getChildren()
         .some((child) => child.isShowing());
+      const triggerStrategy = this.getTriggerStrategy();
       if (!hasChildShowing &&
-        this.shouldListenerWork('custom') &&
-        this.isShowing() &&
+        triggerStrategy.canEvaluate('click-outside') &&
         this.showConfig &&
         !isParent(currentTarget, this.showConfig.appendableElement) &&
         !isParent(currentTarget, this.showConfig.target) &&
         (this.showConfig.isScreenPosition ||
           findParent(currentTarget, 'vega-modal') === findParent(this.showConfig.target, 'vega-modal'))) {
-        this.hide();
+        this.executeTriggerStrategy(triggerStrategy, e, 'click-outside');
       }
     };
     /* istanbul ignore next */
@@ -112,9 +121,10 @@ export class ElementAppenderSlimmer extends VegaSlimmer {
       }
     };
     /* A timer that will hide the dropdown after a certain amount of time. */
-    this.createDelayHideTimer = () => {
+    this.createDelayHideTimer = (event, eventType) => {
+      const triggerStrategy = this.getTriggerStrategy();
       this.delayHideTimer = setTimeout(() => {
-        this.hide();
+        this.executeTriggerStrategy(triggerStrategy, event, eventType);
         clearTimeout(this.delayHideTimer);
       }, ElementAppenderSlimmer.DELAY_HIDE_TIME);
     };
@@ -122,19 +132,22 @@ export class ElementAppenderSlimmer extends VegaSlimmer {
     this.clearDelayHideTimer = () => {
       this.delayHideTimer && clearTimeout(this.delayHideTimer);
     };
-    /* It's a function that checks if the listener should work or not. */
-    this.shouldListenerWork = (trigger) => {
-      const currentTrigger = this.getTrigger();
-      switch (trigger) {
-        case 'custom':
-          return currentTrigger !== 'none';
-        case 'click':
-          return currentTrigger === 'click';
-        case 'hover':
-          return currentTrigger === 'hover';
+    this.executeTriggerStrategy = (triggerStrategy, event, eventType) => {
+      if (this.showConfig) {
+        const result = triggerStrategy.evaluate({
+          target: this.showConfig.target,
+          appendableElement: this.showConfig.appendableElement,
+          htmlEvent: event,
+          eventType: eventType,
+          currentState: {
+            isVisible: this.isShowing(),
+          },
+        });
+        if (result) {
+          result.nextAction === 'hide' && this.hide();
+          result.nextAction === 'show' && this.show();
+        }
       }
-      /* istanbul ignore next */
-      throw new Error(`Unexpected trigger: ${trigger}. Expected values are custom, click, or hover.`);
     };
     this.showConfigFactory = showConfigFactory;
     this.getTrigger = getTrigger;
@@ -236,6 +249,21 @@ export class ElementAppenderSlimmer extends VegaSlimmer {
   removeShadowRootElementScrolling() {
     ChangeManager.unregister(SHADOW_ROOT_ELEMENT_SCROLLING, this.shadowRootElementScrollingObserver);
   }
+  getTriggerStrategy() {
+    const trigger = this.getTrigger();
+    if (trigger === 'click') {
+      return new ClickTriggerStrategy();
+    }
+    else if (trigger === 'hover') {
+      return new HoverTriggerStrategy();
+    }
+    else if (isEATriggerStrategy(trigger)) {
+      return trigger;
+    }
+    else {
+      return new NoneTriggerStrategy();
+    }
+  }
 }
 ElementAppenderSlimmer.DELAY_HIDE_TIME = 100;
 __decorate([

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

@@ -12,6 +12,7 @@ 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 { ClickOutsideOnlyToDismissStrategy } from '../trigger-strategies/click-outside-only-to-dismiss-strategy';
 describe('ElementAppender slimmer test suite', () => {
   const mockedComponentDidLoadMethod = jest.fn();
   const mockedComponentDisconnectedCallbackMethod = jest.fn();
@@ -184,14 +185,14 @@ describe('ElementAppender slimmer test suite', () => {
       expect((appendableElement.style.display = 'block'));
       jest.useRealTimers();
     });
-    test('should listen event proper while trigger is custom', () => {
+    test('should listen event proper while trigger is custom trigger', () => {
       const mockedComponent = new MockedComponent();
       const target = new MockHTMLElement('body', 'div');
       const appendableElement = new MockHTMLElement('body', 'div');
       appendableElement.classList.add('vega-force-hidden');
       mockedComponent.target = target;
       mockedComponent.appendableElement = appendableElement;
-      mockedComponent.trigger = 'custom';
+      mockedComponent.trigger = new ClickOutsideOnlyToDismissStrategy();
       mockedComponent.componentDidLoad();
       mockedComponent.show();
       expect(mockedComponent.appendableElement).not.toHaveClass('vega-force-hidden');

package/dist/collection/helpers/slimmers/element-appender/trigger-strategies/click-outside-only-to-dismiss-strategy.js

@@ -0,0 +1,28 @@
+/**
+ * A trigger strategy that hides the appendable element when a global mouse down event occurs outside the element.
+ */
+export class ClickOutsideOnlyToDismissStrategy {
+  /**
+   * 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) {
+    return type === 'click-outside';
+  }
+  /**
+   * 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) {
+    if (context.eventType === 'click-outside' && context.currentState.isVisible) {
+      return {
+        nextAction: 'hide',
+      };
+    }
+    return {};
+  }
+}

package/dist/collection/helpers/slimmers/element-appender/trigger-strategies/click-trigger-strategy.js

@@ -0,0 +1,33 @@
+/**
+ * ClickTriggerStrategy handles 'targetClick' and 'globalMouseDown' events to toggle or hide the appendable element.
+ */
+export class ClickTriggerStrategy {
+  /**
+   * 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) {
+    return type === 'target-click' || type === 'click-outside';
+  }
+  /**
+   * 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) {
+    if (context.eventType === 'target-click') {
+      return {
+        nextAction: context.currentState.isVisible ? 'hide' : 'show',
+      };
+    }
+    if (context.eventType === 'click-outside' && context.currentState.isVisible) {
+      return {
+        nextAction: 'hide',
+      };
+    }
+    return {};
+  }
+}

package/dist/collection/helpers/slimmers/element-appender/trigger-strategies/hover-trigger-strategy.js

@@ -0,0 +1,42 @@
+/**
+ * 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 class HoverTriggerStrategy {
+  /**
+   * 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) {
+    return [
+      'target-mouseenter',
+      'target-mouseleave',
+      'element-mouseenter',
+      'element-mouseleave',
+    ].includes(type);
+  }
+  /**
+   * 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) {
+    if (['target-mouseenter', 'element-mouseenter'].includes(context.eventType)) {
+      return !context.currentState.isVisible
+        ? {
+          nextAction: 'show',
+        }
+        : {};
+    }
+    if (['target-mouseleave', 'element-mouseleave'].includes(context.eventType)) {
+      return {
+        nextAction: 'hide',
+      };
+    }
+    /* istanbul ignore next */
+    return {};
+  }
+}

package/dist/collection/helpers/slimmers/element-appender/trigger-strategies/none-trigger-strategy.js

@@ -0,0 +1,22 @@
+/**
+ * NoneTriggerStrategy does not respond to any events and always indicates no action.
+ */
+export class NoneTriggerStrategy {
+  /**
+   * Determines if the strategy can evaluate the given event type.
+   *
+   * @returns {boolean} Always false as this strategy does not respond to any events.
+   */
+  canEvaluate() {
+    return false;
+  }
+  /* istanbul ignore next */
+  /**
+   * Evaluates the trigger context and always indicates no action.
+   *
+   * @returns {VegaEATriggerResult} An object indicating no action (no show, hide, or toggle).
+   */
+  evaluate() {
+    return {};
+  }
+}

package/dist/collection/helpers/slimmers/element-appender/trigger-strategies/trigger-strategy.interface.js

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

package/dist/collection/types/test/type-guard.test.js

@@ -1,4 +1,5 @@
-import { isFlexWrapType, isResponsiveType, isSpacingDirection, isStateVariantTokenType } from '../type-guard';
+import { ClickOutsideOnlyToDismissStrategy } from '../../helpers/slimmers/element-appender/trigger-strategies/click-outside-only-to-dismiss-strategy';
+import { isEATriggerStrategy, isFlexWrapType, isResponsiveType, isSpacingDirection, isStateVariantTokenType, } from '../type-guard';
 test('should get expect result when call function isResponsiveType', async () => {
   const sizeWithDefault = {
     default: 'default',
@@ -37,3 +38,9 @@ test('should get expect result when call function isFlexWrapType', async () => {
   expect(isFlexWrapType('wrap')).toBeTruthy();
   expect(isFlexWrapType('wrap1')).toBeFalsy();
 });
+test('should get expect result when call function isEATriggerStrategy', async () => {
+  expect(isEATriggerStrategy(undefined)).toBeFalsy();
+  expect(isEATriggerStrategy(null)).toBeFalsy();
+  expect(isEATriggerStrategy('wrap')).toBeFalsy();
+  expect(isEATriggerStrategy(new ClickOutsideOnlyToDismissStrategy())).toBeTruthy();
+});

package/dist/collection/types/type-guard.js

@@ -395,3 +395,14 @@ export const isVegaTableColumnGroupingModelType = (input) => {
 export const isCalendarDateType = (input) => {
   return input instanceof 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 const isEATriggerStrategy = (instance) => {
+  return (!!instance &&
+    typeof instance.evaluate === 'function' &&
+    typeof instance.canEvaluate === 'function');
+};

package/dist/collection/utils/sanitize.js

@@ -0,0 +1,126 @@
+import { tryGetDocument } from './try-get-document';
+/**
+ * Helper utilities for sanitizing string from harmful tags
+ * This utility is intentionally restrictive of allowed tags depending on expected output.
+ *
+ * - Uses DOM-based parsing (no regex)
+ * - All attributes are stripped
+ * - Disallowed elements are unwrapped (children preserved)
+ */
+export class SanitizeUtility {
+  /**
+   * It cleans up string for labels and allow minor formatting like bold, italic, strong
+   *
+   * @param {string} input - the passed label input string for sanitization
+   * @returns {string} returns sanitized string
+   */
+  static sanitizeHtmlLabel(input) {
+    return this.sanitize(input, this.LABEL_ALLOWED_TAGS);
+  }
+  /**
+   * Sanitizes the provided HTML string by parsing it into a DOM tree and
+   * removing all disallowed elements and attributes.
+   *
+   * @param {string} input - raw HTML string to sanitize
+   * @param {ReadonlySet<string>} allowedTags - set of allowed HTML tag names
+   * @returns {string} sanitized HTML string
+   */
+  static sanitize(input, allowedTags) {
+    if (input.trim() === '')
+      return '';
+    const doc = tryGetDocument();
+    if (!doc)
+      return '';
+    const parser = new DOMParser();
+    const parsedDocument = parser.parseFromString(input, 'text/html');
+    const outputFragment = doc.createDocumentFragment();
+    parsedDocument.body.childNodes.forEach((node) => {
+      const cleanNode = this.sanitizeNode(node, allowedTags, doc);
+      if (cleanNode) {
+        outputFragment.appendChild(cleanNode);
+      }
+    });
+    return this.serializeFragment(outputFragment, doc);
+  }
+  /**
+   * Sanitizes a DOM node recursively.
+   * - Text nodes are preserved
+   * - Element nodes are sanitized based on allowed tags
+   * - Other node types are discarded
+   *
+   * @param {Node} node - DOM node to sanitize
+   * @param {ReadonlySet<string>} allowedTags - set of allowed HTML tag names
+   * @param {Document} doc - document reference
+   * @returns {Nullable<Node>} sanitized node or null if not allowed
+   */
+  static sanitizeNode(node, allowedTags, doc) {
+    switch (node.nodeType) {
+      case Node.TEXT_NODE:
+        return node.cloneNode(true);
+      case Node.ELEMENT_NODE:
+        return this.sanitizeElement(node, allowedTags, doc);
+      default:
+        return null;
+    }
+  }
+  /**
+   * Sanitizes an HTML element.
+   * - If the element tag is not allowed, it is removed but its children are preserved
+   * - If allowed, a clean element is created with no attributes
+   *
+   * @param {HTMLElement} element - element to sanitize
+   * @param {ReadonlySet<string>} allowedTags - set of allowed HTML tag names
+   * @param {Document} doc - document reference
+   * @returns {Node} sanitized node or fragment
+   */
+  static sanitizeElement(element, allowedTags, doc) {
+    if (!allowedTags.has(element.tagName)) {
+      const fragment = doc.createDocumentFragment();
+      element.childNodes.forEach((child) => {
+        const cleanChild = this.sanitizeNode(child, allowedTags, doc);
+        if (cleanChild) {
+          fragment.appendChild(cleanChild);
+        }
+      });
+      return fragment;
+    }
+    const cleanElement = doc.createElement(element.tagName.toLowerCase());
+    element.childNodes.forEach((child) => {
+      const cleanChild = this.sanitizeNode(child, allowedTags, doc);
+      if (cleanChild) {
+        cleanElement.appendChild(cleanChild);
+      }
+    });
+    return cleanElement;
+  }
+  /**
+   * Serializes a DocumentFragment back into an HTML string.
+   *
+   * @param {DocumentFragment} fragment - fragment to serialize
+   * @param {Document} doc - document reference
+   * @returns {string} serialized HTML string
+   */
+  static serializeFragment(fragment, doc) {
+    var _a;
+    const container = doc.createElement('div');
+    container.appendChild(fragment);
+    // If no HTML elements exist, return textContent
+    return container.children.length === 0 ? (_a = container.textContent) !== null && _a !== void 0 ? _a : '' : container.innerHTML;
+  }
+}
+/**
+ * Set of allowed HTML tags for label rendering.
+ * Tags must be uppercase to match DOMParser element.tagName output.
+ */
+SanitizeUtility.LABEL_ALLOWED_TAGS = new Set(['B', 'I', 'STRONG', 'EM']);
+/**
+ * Standalone helper (keeps parity with existing utility exports pattern)
+ *
+ * It cleans up string for labels and allow minor formatting like bold, italic, strong
+ *
+ * @param {string} input - the passed label input string for sanitization
+ * @returns {string} returns sanitized string
+ */
+export function sanitizeHtmlLabel(input) {
+  return SanitizeUtility.sanitizeHtmlLabel(input);
+}