@heartlandone/vega 2.75.0 → 2.76.0

package/dist/esm/{element-appender-slimmer-7cb08343.js → element-appender-slimmer-e4713a72.js}

@@ -1,16 +1,18 @@
 import { c as MapToComponentField, I as InjectVegaSlimmer, V as VegaSlimmer, L as LogUtility, M as MapToComponentMethod } from './global-slimmer-registry-17c4efd4.js';
-import { f as findParent, d as isElementVisible, b as isParent } from './ui-bb99c0c2.js';
-import { n as InternalVegaZIndexManager } from './function-extension-63028f20.js';
+import { f as findParent, d as isElementVisible, b as isParent } from './ui-ee31416b.js';
+import { I as InternalVegaZIndexManager } from './internal-vega-z-index-manager-7d2b54c3.js';
 import { c as createDynamicSlimmer } from './dynamic-slimmer-90b8af32.js';
-import { P as PageResizeObserverSlimmer } from './page-resize-observer-slimmer-8744cb44.js';
-import { P as Placements, A as Alignments } from './ui-28fd4193.js';
-import { H as isTranslocationType, a3 as isEATriggerStrategy } from './type-guard-c65a227d.js';
-import { R as ResponsiveFormatFacade } from './responsive-format-facade-05e53016.js';
+import { P as PageResizeObserverSlimmer } from './page-resize-observer-slimmer-d6af0d86.js';
+import { A as Alignments, P as Placements } from './ui-28fd4193.js';
+import { H as isTranslocationType, a3 as isEATriggerStrategy } from './type-guard-f50e34d6.js';
+import { R as ResponsiveFormatFacade } from './responsive-format-facade-7a071174.js';
+import { t as tryGetDocument } from './try-get-document-bef0f526.js';
+import { F as FeatureFlag } from './feature-flag-controller-09ea7e87.js';
 import { C as ChangeManager } from './change-manager-6a7eb88c.js';
 import { S as SHADOW_ROOT_ELEMENT_SCROLLING } from './static-subject-title-52f93124.js';
 import { O as Observer } from './observer-3959f9dd.js';
-import { d as domNodeSubjectFactory, D as DomNodeSubjectObserverFactory } from './dom-node-subject-observer-factory-064ee2b2.js';
-import { x as VegaInternalNestEAHierarchyTreeChange } from './vega-internal-event-id-4a06d705.js';
+import { d as domNodeSubjectFactory, D as DomNodeSubjectObserverFactory } from './dom-node-subject-observer-factory-82f346e3.js';
+import { x as VegaInternalNestEAHierarchyTreeChange } from './vega-internal-event-id-799d012e.js';
 
 var __decorate$a = (undefined && undefined.__decorate) || function (decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
@@ -268,6 +270,17 @@ __decorate$6([
  * calculate position
  */
 class BasePositionCalculationStrategy extends VegaSlimmer {
+  /**
+   * Whether the controller should adjust/recompute position at this time.
+   *
+   * This hook allows strategies to avoid unnecessary work (for example, on scroll) by deciding
+   * whether a re-position is required.
+   *
+   * @returns {boolean} True when the controller should proceed with width/height/position adjustments.
+   */
+  shouldAdjustPosition() {
+    return true;
+  }
   /**
    * Get the position box.
    *
@@ -293,121 +306,46 @@ class BasePositionCalculationStrategy extends VegaSlimmer {
     return positionBox;
   }
   /**
-   * "Get the width, height, and top position of an element."
-   *
-   * The function takes an element as an argument and returns an object with three properties: width,
-   * height, and top.
-   *
-   * Note: If element is hide, we should temporary change it to `block` to get the bounding client rect of element,
-   * After do that, this element will change to origin `hide`, if not, it will be contained in the calculate of `document.documentElement.scrollHeight`
-   *
-   * @returns {ElementBoundBox} An object with the width, height, and top properties of the element.
-   */
-  getElementBoundBox() {
-    const element = this.showConfig.appendableElement;
-    const isElementHide = element.classList.contains('vega-force-hidden');
-    if (isElementHide)
-      element.classList.remove('vega-force-hidden');
-    const elementRect = element.getBoundingClientRect();
-    if (isElementHide)
-      element.classList.add('vega-force-hidden');
-    return {
-      width: elementRect.width,
-      height: elementRect.height,
-      left: elementRect.left,
-      top: elementRect.top,
-    };
-  }
-  /**
-   * It takes a placement string or array of placements and returns an array of placements
-   * if given placement is single, we should completion the placements with the default {@link Placements}
-   * and make given placement as default.
-   * if given placement is array, we should use it directly, even it partial of {@link Placements}.
-   * if not placement give. we should use {@link Placements}.
-   *
-   * @returns {PlacementType[]} ordered placements.
-   */
-  getPlacements() {
-    const placement = this.showConfig.placement;
-    if (typeof placement === 'string') {
-      const partial = Placements.filter((direction) => direction !== placement);
-      return [placement, ...partial];
-    }
-    else if (Array.isArray(placement)) {
-      return placement;
-    }
-    else {
-      return [...Placements];
-    }
-  }
-  /**
-   * It returns acceptable alignments.
-   *
-   * @returns {PositionAlignmentType[]} acceptable alignments
-   */
-  getAlignments() {
-    const alignment = this.showConfig.alignment;
-    if (typeof alignment === 'string') {
-      const partial = Alignments.filter((item) => item !== alignment);
-      return [alignment, ...partial];
-    }
-    else if (Array.isArray(alignment)) {
-      return alignment;
-    }
-    else {
-      return [...Alignments];
-    }
-  }
-  /**
-   * It takes a placement, a target box, and a element box, and returns an element box
+   * Whether the alignment space is enough
    *
-   * @param {ElementBoundBox} elementBox - The position of the element element.
+   * @param {ElementScrollDimension} containerBox - The bounding box of the container element.
    * @param {ElementBoundBox} targetBox - The position of the target element.
-   * @param {PlacementType} placement - The placement of the element.
-   * @param {PositionAlignmentType} alignment - The alignment of the element
-   * @returns {ElementPositionBox} An object with top and left properties.
-   */
-  calculatePosition(elementBox, targetBox, placement, alignment) {
-    return {
-      top: this.calculateTop(elementBox, targetBox, placement, alignment),
-      left: this.calculateLeft(elementBox, targetBox, placement, alignment),
-    };
-  }
-  /**
-   * It returns the translocation of the element relative to the target element
-   *
-   * @param {PlacementType} placement - The suitable placement of the element.
-   * @returns {TranslocationType} A translocation object with X and Y properties.
+   * @param {ElementBoundBox} elementBox - The box of the element that we're trying to position.
+   * @param {PlacementType} placement - The placement of the element relative to the target.
+   * @param {PlacementType} alignment - The alignment of the element relative to the target.
+   * @returns {boolean} return true if it has enough space, otherwise false
    */
-  getTranslocationBox(placement) {
-    const originPlacement = Array.isArray(this.showConfig.placement)
-      ? this.showConfig.placement[0]
-      : this.showConfig.placement;
-    const translocation = this.getTranslocation();
-    const result = { X: 0, Y: 0 };
-    if (isTranslocationType(translocation)) {
-      let xValue = translocation.X;
-      let yValue = translocation.Y;
-      // If originPlacement and placement is not in same axis, it should reverse axis.
-      if ((originPlacement &&
-        ['left', 'right'].includes(originPlacement) &&
-        ['top', 'bottom'].includes(placement)) ||
-        (originPlacement &&
-          ['top', 'bottom'].includes(originPlacement) &&
-          ['left', 'right'].includes(placement))) {
-        xValue = translocation.Y;
-        yValue = translocation.X;
-      }
-      if (['bottom', 'top'].includes(placement)) {
-        result.Y = placement === 'top' ? -yValue : yValue;
-        result.X = xValue;
+  hasEnoughAlignmentSpace(containerBox, targetBox, elementBox, placement, alignment) {
+    if (['top', 'bottom'].includes(placement)) {
+      switch (alignment) {
+        case 'start': {
+          return targetBox.left + elementBox.width <= containerBox.width;
+        }
+        case 'center': {
+          return (targetBox.left >= (elementBox.width - targetBox.width) / 2 &&
+            targetBox.left + targetBox.width / 2 + elementBox.width / 2 <= containerBox.width);
+        }
+        case 'end': {
+          return targetBox.left + targetBox.width >= elementBox.width;
+        }
       }
-      if (['left', 'right'].includes(placement)) {
-        result.X = placement === 'left' ? -xValue : xValue;
-        result.Y = yValue;
+    }
+    if (['right', 'left'].includes(placement)) {
+      switch (alignment) {
+        case 'start': {
+          return targetBox.top + elementBox.height <= containerBox.height;
+        }
+        case 'center': {
+          return (targetBox.top >= (elementBox.height - targetBox.height) / 2 &&
+            targetBox.top + targetBox.height / 2 + elementBox.height / 2 <= containerBox.height);
+        }
+        case 'end': {
+          return targetBox.top + targetBox.height >= elementBox.height;
+        }
       }
     }
-    return result;
+    /* istanbul ignore next */
+    return false;
   }
   /**
    * Calculate the left position of the element
@@ -477,6 +415,24 @@ class BasePositionCalculationStrategy extends VegaSlimmer {
         throw new Error(`Unexpected placement: ${placement}. Expected values are top, bottom, left, or right.`);
     }
   }
+  /**
+   * It returns acceptable alignments.
+   *
+   * @returns {PositionAlignmentType[]} acceptable alignments
+   */
+  getAlignments() {
+    const alignment = this.showConfig.alignment;
+    if (typeof alignment === 'string') {
+      const partial = Alignments.filter((item) => item !== alignment);
+      return [alignment, ...partial];
+    }
+    else if (Array.isArray(alignment)) {
+      return alignment;
+    }
+    else {
+      return [...Alignments];
+    }
+  }
   /**
    * It takes a list of placements and returns the first placement that has enough space to place the
    * element
@@ -501,6 +457,105 @@ class BasePositionCalculationStrategy extends VegaSlimmer {
       return defaultPlacement;
     }
   }
+  /**
+   * "Get the width, height, and top position of an element."
+   *
+   * The function takes an element as an argument and returns an object with three properties: width,
+   * height, and top.
+   *
+   * Note: If element is hide, we should temporary change it to `block` to get the bounding client rect of element,
+   * After do that, this element will change to origin `hide`, if not, it will be contained in the calculate of `document.documentElement.scrollHeight`
+   *
+   * @returns {ElementBoundBox} An object with the width, height, and top properties of the element.
+   */
+  getElementBoundBox() {
+    const element = this.showConfig.appendableElement;
+    const isElementHide = element.classList.contains('vega-force-hidden');
+    if (isElementHide)
+      element.classList.remove('vega-force-hidden');
+    const elementRect = element.getBoundingClientRect();
+    if (isElementHide)
+      element.classList.add('vega-force-hidden');
+    return {
+      width: elementRect.width,
+      height: elementRect.height,
+      left: elementRect.left,
+      top: elementRect.top,
+    };
+  }
+  /**
+   * It takes a placement string or array of placements and returns an array of placements
+   * if given placement is single, we should completion the placements with the default {@link Placements}
+   * and make given placement as default.
+   * if given placement is array, we should use it directly, even it partial of {@link Placements}.
+   * if not placement give. we should use {@link Placements}.
+   *
+   * @returns {PlacementType[]} ordered placements.
+   */
+  getPlacements() {
+    const placement = this.showConfig.placement;
+    if (typeof placement === 'string') {
+      const partial = Placements.filter((direction) => direction !== placement);
+      return [placement, ...partial];
+    }
+    else if (Array.isArray(placement)) {
+      return placement;
+    }
+    else {
+      return [...Placements];
+    }
+  }
+  /**
+   * It takes a placement, a target box, and a element box, and returns an element box
+   *
+   * @param {ElementBoundBox} elementBox - The position of the element element.
+   * @param {ElementBoundBox} targetBox - The position of the target element.
+   * @param {PlacementType} placement - The placement of the element.
+   * @param {PositionAlignmentType} alignment - The alignment of the element
+   * @returns {ElementPositionBox} An object with top and left properties.
+   */
+  calculatePosition(elementBox, targetBox, placement, alignment) {
+    return {
+      top: this.calculateTop(elementBox, targetBox, placement, alignment),
+      left: this.calculateLeft(elementBox, targetBox, placement, alignment),
+    };
+  }
+  /**
+   * It returns the translocation of the element relative to the target element
+   *
+   * @param {PlacementType} placement - The suitable placement of the element.
+   * @returns {TranslocationType} A translocation object with X and Y properties.
+   */
+  getTranslocationBox(placement) {
+    const originPlacement = Array.isArray(this.showConfig.placement)
+      ? this.showConfig.placement[0]
+      : this.showConfig.placement;
+    const translocation = this.getTranslocation();
+    const result = { X: 0, Y: 0 };
+    if (isTranslocationType(translocation)) {
+      let xValue = translocation.X;
+      let yValue = translocation.Y;
+      // If originPlacement and placement is not in same axis, it should reverse axis.
+      if ((originPlacement &&
+        ['left', 'right'].includes(originPlacement) &&
+        ['top', 'bottom'].includes(placement)) ||
+        (originPlacement &&
+          ['top', 'bottom'].includes(originPlacement) &&
+          ['left', 'right'].includes(placement))) {
+        xValue = translocation.Y;
+        yValue = translocation.X;
+      }
+      if (['bottom', 'top'].includes(placement)) {
+        result.Y = placement === 'top' ? -yValue : yValue;
+        result.X = xValue;
+      }
+      if (['left', 'right'].includes(placement)) {
+        result.X = placement === 'left' ? -xValue : xValue;
+        result.Y = yValue;
+      }
+    }
+    return result;
+  }
   /**
    * It takes a list of alignments and returns the suitable one that has enough space to fit the element
    *
@@ -525,48 +580,6 @@ class BasePositionCalculationStrategy extends VegaSlimmer {
       return defaultAlignment;
     }
   }
-  /**
-   * Whether the alignment space is enough
-   *
-   * @param {ElementScrollDimension} containerBox - The bounding box of the container element.
-   * @param {ElementBoundBox} targetBox - The position of the target element.
-   * @param {ElementBoundBox} elementBox - The box of the element that we're trying to position.
-   * @param {PlacementType} placement - The placement of the element relative to the target.
-   * @param {PlacementType} alignment - The alignment of the element relative to the target.
-   * @returns {boolean} return true if it has enough space, otherwise false
-   */
-  hasEnoughAlignmentSpace(containerBox, targetBox, elementBox, placement, alignment) {
-    if (['top', 'bottom'].includes(placement)) {
-      switch (alignment) {
-        case 'start': {
-          return targetBox.left + elementBox.width <= containerBox.width;
-        }
-        case 'center': {
-          return (targetBox.left >= (elementBox.width - targetBox.width) / 2 &&
-            targetBox.left + targetBox.width / 2 + elementBox.width / 2 <= containerBox.width);
-        }
-        case 'end': {
-          return targetBox.left + targetBox.width >= elementBox.width;
-        }
-      }
-    }
-    if (['right', 'left'].includes(placement)) {
-      switch (alignment) {
-        case 'start': {
-          return targetBox.top + elementBox.height <= containerBox.height;
-        }
-        case 'center': {
-          return (targetBox.top >= (elementBox.height - targetBox.height) / 2 &&
-            targetBox.top + targetBox.height / 2 + elementBox.height / 2 <= containerBox.height);
-        }
-        case 'end': {
-          return targetBox.top + targetBox.height >= elementBox.height;
-        }
-      }
-    }
-    /* istanbul ignore next */
-    return false;
-  }
   /**
    * If the placement is top or left, then the target's top or left position must be greater than or
    * equal to the element's height or width. If the placement is bottom or right, then the container's
@@ -669,6 +682,60 @@ __decorate$5([
   MapToComponentField()
 ], BodyPositionCalculationStrategy.prototype, "showConfig", void 0);
 
+/**
+ * Updates position on scroll When the target rect changes, we recompute placement/alignment.
+ */
+class ScreenScrollPositionUpdate {
+  constructor() {
+    this.viewportWidth = window.innerWidth;
+    this.viewportHeight = window.innerHeight;
+  }
+  /**
+   * Determines whether the appendable element's position should update on scroll.
+   *
+   * @param {ScrollPositionUpdateStrategyContext} context - Current/previous rectangles plus viewport size.
+   * @returns {ScrollPositionUpdateDecision} Decision that indicates whether to recompute position.
+   */
+  shouldUpdatePosition(context) {
+    const { previousTargetRect, currentTargetRect, appendableRect, viewportWidth, viewportHeight, } = context;
+    this.viewportWidth = viewportWidth;
+    this.viewportHeight = viewportHeight;
+    const targetChanged = !previousTargetRect ||
+      currentTargetRect.left !== previousTargetRect.left ||
+      currentTargetRect.top !== previousTargetRect.top;
+    const isTargetWithinViewport = !this.isRectOutsideViewport(currentTargetRect);
+    const isAppendableNotEntirelyInViewport = !this.isRectEntirelyWithinViewport(appendableRect);
+    return {
+      shouldUpdate: targetChanged && isTargetWithinViewport && isAppendableNotEntirelyInViewport,
+    };
+  }
+  /**
+   * Whether the rect is fully within the viewport bounds.
+   *
+   * @param {DOMRect} rect - The DOMRect to check.
+   * @returns {boolean} True when rect is fully within the viewport.
+   */
+  isRectEntirelyWithinViewport(rect) {
+    return (rect.left >= 0 &&
+      rect.top >= 0 &&
+      rect.right <= this.viewportWidth &&
+      rect.bottom <= this.viewportHeight);
+  }
+  /**
+   * Whether the element is fully outside the viewport.
+   * If true, the rect has "disappeared" from the viewport.
+   *
+   * @param {DOMRect} rect - The DOMRect to check.
+   * @returns {boolean} True when rect is completely outside viewport bounds.
+   */
+  isRectOutsideViewport(rect) {
+    return (rect.right <= 0 ||
+      rect.bottom <= 0 ||
+      rect.left >= this.viewportWidth ||
+      rect.top >= this.viewportHeight);
+  }
+}
+
 var __decorate$4 = (undefined && undefined.__decorate) || function (decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
@@ -679,6 +746,76 @@ var __decorate$4 = (undefined && undefined.__decorate) || function (decorators,
  * calculate position by screen container
  */
 class ScreenPositionCalculationStrategy extends BasePositionCalculationStrategy {
+  constructor() {
+    super(...arguments);
+    this.scrollFrameRequestId = null;
+    this.usePreviousPlacement = false;
+    this.scrollPositionUpdateStrategy = new ScreenScrollPositionUpdate();
+  }
+  /**
+   * For screen-positioned appendable we may get a lot of scroll events.
+   * This hook throttles the check with requestAnimationFrame and only allows an adjust when
+   * the strategy determines we should update.
+   *
+   * @returns {boolean} True when controller should perform a position adjustment.
+   */
+  shouldAdjustPosition() {
+    if (this.scrollFrameRequestId !== null) {
+      return false;
+    }
+    if (!FeatureFlag.isEnabled('VEGA_ELEMENT_APPENDER.AUTO_PLACEMENT')) {
+      this.usePreviousPlacement = true;
+      return true;
+    }
+    if (!this.previousTargetRect) {
+      this.previousTargetRect = this.showConfig.target.getBoundingClientRect();
+      this.usePreviousPlacement = false;
+      return true;
+    }
+    /**
+     * This avoids doing expensive DOM reads on every scroll event, while still
+     * updating placement/alignment when the trigger moves and the appendable
+     * would be clipped by the viewport (auto placement).
+     *
+     * The below method is e2e-test covered in @see{module:the-screen-position-scroll-RAFCallback-trigger-as-expected}
+     */
+    /* istanbul ignore next */
+    this.scrollFrameRequestId = requestAnimationFrame(() => {
+      var _a;
+      this.scrollFrameRequestId = null;
+      let viewportWidth = window.innerWidth;
+      let viewportHeight = window.innerHeight;
+      if (this.showConfig.positionRelativeTo) {
+        const containerDom = (_a = tryGetDocument()) === null || _a === void 0 ? void 0 : _a.querySelector(this.showConfig.positionRelativeTo);
+        if (containerDom) {
+          viewportWidth = containerDom.getBoundingClientRect().width;
+          viewportHeight = containerDom.getBoundingClientRect().height;
+        }
+      }
+      const currentTargetRect = this.showConfig.target.getBoundingClientRect();
+      const appendableRect = this.showConfig.appendableElement.getBoundingClientRect();
+      const { shouldUpdate } = this.scrollPositionUpdateStrategy.shouldUpdatePosition({
+        currentTargetRect,
+        previousTargetRect: this.previousTargetRect,
+        appendableRect,
+        viewportWidth,
+        viewportHeight,
+      });
+      this.usePreviousPlacement = !shouldUpdate;
+      this.previousTargetRect = currentTargetRect;
+    });
+    return true;
+  }
+  /**
+   * Clears any pending scroll animation frame callback.
+   * Call this when popover is hidden/destroyed to avoid leaks and stale callbacks.
+   */
+  clearScrollFrame() {
+    if (this.scrollFrameRequestId !== null) {
+      cancelAnimationFrame(this.scrollFrameRequestId);
+      this.scrollFrameRequestId = null;
+    }
+  }
   /**
    * Get the position of the element in the container according to the target element and the placement
    * If give a translocation, it will apply the translocation to the result.
@@ -688,7 +825,8 @@ class ScreenPositionCalculationStrategy extends BasePositionCalculationStrategy
    * returns an ElementPositionBox.
    */
   getPosition(usePreviousPlacement) {
-    const positionBox = usePreviousPlacement
+    const stayPlacement = usePreviousPlacement ? this.usePreviousPlacement : false;
+    const positionBox = stayPlacement
       ? this.getPositionBox([this.previousPositionBox.placement], [this.previousPositionBox.alignment])
       : this.getPositionBox();
     this.previousPositionBox = positionBox;
@@ -722,6 +860,43 @@ class ScreenPositionCalculationStrategy extends BasePositionCalculationStrategy
       height: window.innerHeight,
     };
   }
+  /**
+   * Whether the alignment space is enough
+   *
+   * @param {ElementScrollDimension} containerBox - The bounding box of the container element.
+   * @param {ElementBoundBox} targetBox - The position of the target element.
+   * @param {ElementBoundBox} elementBox - The box of the element that we're trying to position.
+   * @param {PlacementType} placement - The placement of the element relative to the target.
+   * @param {PlacementType} alignment - The alignment of the element relative to the target.
+   * @returns {boolean} return true if it has enough space, otherwise false
+   */
+  hasEnoughAlignmentSpace(containerBox, targetBox, elementBox, placement, alignment) {
+    const left = this.calculateLeft(elementBox, targetBox, placement, alignment);
+    const top = this.calculateTop(elementBox, targetBox, placement, alignment);
+    return (left >= 0 &&
+      top >= 0 &&
+      left + elementBox.width <= containerBox.width &&
+      top + elementBox.height <= containerBox.height);
+  }
+  /**
+   * Screen-specific suitable placement selection.
+   * Tries to find a placement that has enough alignment space within the viewport first,
+   * otherwise falls back to the base strategy.
+   *
+   * @param {ElementScrollDimension} containerBox - The bounding box of the container.
+   * @param {ElementBoundBox} elementBox - The box of the element to place.
+   * @param {ElementBoundBox} targetBox - The box of the target element.
+   * @param {PlacementType[]} placements - Ordered list of placements to try.
+   * @returns {PlacementType} The chosen placement.
+   */
+  getSuitablePlacement(containerBox, elementBox, targetBox, placements) {
+    const alignments = this.getAlignments();
+    const suitablePlacement = placements.find((placement) => alignments.some((alignment) => this.hasEnoughAlignmentSpace(containerBox, targetBox, elementBox, placement, alignment)));
+    if (suitablePlacement) {
+      return suitablePlacement;
+    }
+    return super.getSuitablePlacement(containerBox, elementBox, targetBox, placements);
+  }
 }
 __decorate$4([
   MapToComponentField()
@@ -742,6 +917,13 @@ class PositionCalculationController extends VegaSlimmer {
     this.bodyPositionStrategy = new BodyPositionCalculationStrategy();
     this.screenPositionStrategy = new ScreenPositionCalculationStrategy();
   }
+  /**
+   * Clears any pending screen-position scroll animation frame callback.
+   * Call this when the appendable is hidden/destroyed.
+   */
+  clearScreenPositionScrollFrame() {
+    this.screenPositionStrategy.clearScrollFrame();
+  }
   /**
    * Sets the calculate postion strategy.
    */
@@ -756,6 +938,8 @@ class PositionCalculationController extends VegaSlimmer {
    * @param {boolean} [usePreviousPlacement] - Should keep use previous placement and alignment.
    */
   adjustPosition(usePreviousPlacement) {
+    if (!this.positionStrategy.shouldAdjustPosition())
+      return;
     this.adjustWidth();
     this.adjustHeight();
     this.applyPosition(this.positionStrategy.getPosition(usePreviousPlacement));
@@ -918,6 +1102,7 @@ class ElementAppender {
    * @returns {void} Nothing is being returned.
    */
   show() {
+    this.positionCalculationController.clearScreenPositionScrollFrame();
     this.setShowConfig();
     if (!this.showConfig.target) {
       LogUtility.error(`No target element found, please add it at new elementAppender.`);
@@ -941,6 +1126,7 @@ class ElementAppender {
   hide() {
     if (!this.showConfig)
       return;
+    this.positionCalculationController.clearScreenPositionScrollFrame();
     this.toggleShow(false);
     this.resetContainerPosition();
     InternalVegaZIndexManager.removeZIndex(this.showConfig.appendableElement, 'base');
@@ -949,11 +1135,7 @@ class ElementAppender {
    * Update position while window scroll.
    */
   onScroll() {
-    var _a;
-    const currentTargetRect = this.showConfig.target.getBoundingClientRect();
-    if (this.showConfig.isScreenPosition &&
-      (currentTargetRect.left !== ((_a = this.previousTargetRect) === null || _a === void 0 ? void 0 : _a.left) ||
-        currentTargetRect.top !== this.previousTargetRect.top)) {
+    if (this.showConfig.isScreenPosition) {
       this.adjustPosition(true);
     }
   }
@@ -965,6 +1147,7 @@ class ElementAppender {
   destroy() {
     if (!this.showConfig)
       return;
+    this.positionCalculationController.clearScreenPositionScrollFrame();
     this.removeVisibleAppendElement(this.showConfig.appendableElement);
     this.resetContainerPosition();
     InternalVegaZIndexManager.removeZIndex(this.showConfig.appendableElement, 'base');

package/dist/esm/{event-emit-slimmer-09827cec.js → event-emit-slimmer-ffaecb9a.js}

@@ -1,8 +1,8 @@
 import { c as MapToComponentField, V as VegaSlimmer, I as InjectVegaSlimmer } from './global-slimmer-registry-17c4efd4.js';
 import { c as createDynamicSlimmer } from './dynamic-slimmer-90b8af32.js';
 import { C as ChangeManager } from './change-manager-6a7eb88c.js';
-import { d as domNodeSubjectFactory, D as DomNodeSubjectObserverFactory } from './dom-node-subject-observer-factory-064ee2b2.js';
-import { j as jqueryDelegatedStrategyController, i as internalVegaEventManager } from './internal-vega-event-manager-efb6786e.js';
+import { d as domNodeSubjectFactory, D as DomNodeSubjectObserverFactory } from './dom-node-subject-observer-factory-82f346e3.js';
+import { j as jqueryDelegatedStrategyController, i as internalVegaEventManager } from './internal-vega-event-manager-32a3d848.js';
 import { t as tryGetDocument } from './try-get-document-bef0f526.js';
 
 var __decorate$3 = (undefined && undefined.__decorate) || function (decorators, target, key, desc) {

package/dist/esm/{feature-flag-controller-51659753.js → feature-flag-controller-09ea7e87.js}

@@ -1,5 +1,5 @@
 import { L as LogUtility } from './global-slimmer-registry-17c4efd4.js';
-import k from './index-e9da316f.js';
+import k from './index-bfc6dfa2.js';
 
 /**
  * The concrete feature flag map that we are going to use to determine if a feature is enabled or not.
@@ -212,6 +212,12 @@ const FeatureFlagsMap = {
     createdAtVersion: '2.48.1',
     disabledByDefault: true,
   },
+  'VEGA_ELEMENT_APPENDER.AUTO_PLACEMENT': {
+    description: `A feature flag to automatic placement for appendable pop-ups when isScreenPosition is enabled.`,
+    createdTimestamp: 1770940800000,
+    createdAtVersion: '2.76.0',
+    disabledByDefault: false,
+  },
 };
 const FeatureFlagsMap$1 = Object.freeze(FeatureFlagsMap);