@ionic/core 8.7.18-dev.11771365900.125bf49c → 8.7.18-dev.11772037614.10c71570

package/dist/collection/components/modal/modal.ios.css

@@ -135,10 +135,6 @@ ion-backdrop {
   :host {
     --width: 600px;
     --height: 500px;
-    --ion-safe-area-top: 0px;
-    --ion-safe-area-bottom: 0px;
-    --ion-safe-area-right: 0px;
-    --ion-safe-area-left: 0px;
   }
 }
 @media only screen and (min-width: 768px) and (min-height: 768px) {
@@ -190,9 +186,14 @@ ion-backdrop {
 /**
  * Ensure that the sheet modal does not
  * completely cover the content.
+ *
+ * --ion-modal-offset-top is an internal property set by modal.tsx
+ * with the resolved root safe-area-top pixel value. This decouples
+ * the height calculation from --ion-safe-area-top (which is zeroed
+ * for sheet modals to prevent header double-padding).
  */
 :host(.modal-sheet) {
-  --height: calc(100% - (var(--ion-safe-area-top) + 10px));
+  --height: calc(100% - (var(--ion-modal-offset-top, 0px) + 10px));
 }
 
 :host(.modal-sheet) .modal-wrapper,

package/dist/collection/components/modal/modal.js

@@ -21,6 +21,7 @@ import { mdEnterAnimation } from "./animations/md.enter";
 import { mdLeaveAnimation } from "./animations/md.leave";
 import { createSheetGesture } from "./gestures/sheet";
 import { createSwipeToCloseGesture, SwipeToCloseDefaults } from "./gestures/swipe-to-close";
+import { getInitialSafeAreaConfig, getPositionBasedSafeAreaConfig, applySafeAreaOverrides, clearSafeAreaOverrides, getRootSafeAreaTop, } from "./safe-area-utils";
 import { setCardStatusBarDark, setCardStatusBarDefault } from "./utils";
 // TODO(FW-2832): types
 /**
@@ -232,13 +233,31 @@ export class Modal {
         }
     }
     onWindowResize() {
-        // Only handle resize for iOS card modals when no custom animations are provided
-        if (getIonMode(this) !== 'ios' || !this.presentingElement || this.enterAnimation || this.leaveAnimation) {
+        if (!this.presented)
             return;
-        }
         clearTimeout(this.resizeTimeout);
         this.resizeTimeout = setTimeout(() => {
-            this.handleViewTransition();
+            const context = this.getSafeAreaContext();
+            // iOS card modals: handle portrait/landscape view transitions
+            if (context.isCardModal && !this.enterAnimation && !this.leaveAnimation) {
+                this.handleViewTransition();
+            }
+            // Sheet modals: re-compute the internal offset property since safe-area
+            // values may change on device rotation (e.g., portrait notch vs landscape).
+            if (context.isSheetModal) {
+                this.updateSheetOffsetTop();
+            }
+            // Regular (non-sheet, non-card) modals: update safe-area overrides
+            // since the viewport may have crossed the centered-dialog breakpoint.
+            if (!context.isSheetModal && !context.isCardModal) {
+                this.updateSafeAreaOverrides();
+                // Re-evaluate fullscreen safe-area padding: clear first, then re-apply
+                if (this.wrapperEl) {
+                    this.wrapperEl.style.removeProperty('height');
+                    this.wrapperEl.style.removeProperty('padding-bottom');
+                }
+                this.applyFullscreenSafeArea();
+            }
         }, 50); // Debounce to avoid excessive calls during active resizing
     }
     breakpointsChanged(breakpoints) {
@@ -255,6 +274,9 @@ export class Modal {
         this.triggerController.removeClickListener();
         this.cleanupViewTransitionListener();
         this.cleanupParentRemovalObserver();
+        // Also called in dismiss() — intentional dual cleanup covers both
+        // dismiss-then-remove and direct DOM removal without dismiss.
+        this.cleanupSafeAreaOverrides();
     }
     componentWillLoad() {
         var _a;
@@ -415,6 +437,11 @@ export class Modal {
             await waitForMount();
         }
         writeTask(() => this.el.classList.add('show-modal'));
+        // Recalculate isSheetModal before safe-area setup because framework
+        // bindings (e.g., Angular) may not have been applied when componentWillLoad ran.
+        this.isSheetModal = this.breakpoints !== undefined && this.initialBreakpoint !== undefined;
+        // Set initial safe-area overrides before animation
+        this.setInitialSafeAreaOverrides();
         const hasCardModal = presentingElement !== undefined;
         /**
          * We need to change the status bar at the
@@ -432,6 +459,10 @@ export class Modal {
             backdropBreakpoint: this.backdropBreakpoint,
             expandToScroll: this.expandToScroll,
         });
+        // Update safe-area based on actual position after animation
+        this.updateSafeAreaOverrides();
+        // Apply fullscreen safe-area padding if needed
+        this.applyFullscreenSafeArea();
         /* tslint:disable-next-line */
         if (typeof window !== 'undefined') {
             /**
@@ -463,13 +494,7 @@ export class Modal {
             };
             window.addEventListener(KEYBOARD_DID_OPEN, this.keyboardOpenCallback);
         }
-        /**
-         * Recalculate isSheetModal because framework bindings (e.g., Angular)
-         * may not have been applied when componentWillLoad ran.
-         */
-        const isSheetModal = this.breakpoints !== undefined && this.initialBreakpoint !== undefined;
-        this.isSheetModal = isSheetModal;
-        if (isSheetModal) {
+        if (this.isSheetModal) {
             this.initSheetGesture();
         }
         else if (hasCardModal) {
@@ -659,6 +684,9 @@ export class Modal {
         if (this.gestureAnimationDismissing && role !== GESTURE) {
             return false;
         }
+        // Cancel any pending resize timeout to prevent stale updates during dismiss
+        clearTimeout(this.resizeTimeout);
+        this.resizeTimeout = undefined;
         /**
          * Because the canDismiss check below is async,
          * we need to claim a lock before the check happens,
@@ -713,6 +741,7 @@ export class Modal {
             }
             this.cleanupViewTransitionListener();
             this.cleanupParentRemovalObserver();
+            this.cleanupSafeAreaOverrides();
             this.cleanupChildRoutePassthrough();
         }
         this.currentBreakpoint = undefined;
@@ -841,6 +870,9 @@ export class Modal {
         this.viewTransitionAnimation = transitionAnimation;
         transitionAnimation.play().then(() => {
             this.viewTransitionAnimation = undefined;
+            // Wait for a layout pass after the transition so getBoundingClientRect()
+            // in getPositionBasedSafeAreaConfig() reflects the new dimensions.
+            raf(() => this.updateSafeAreaOverrides());
             // After orientation transition, recreate the swipe-to-close gesture
             // with updated animation that reflects the new presenting element state
             this.reinitSwipeToClose();
@@ -967,6 +999,123 @@ export class Modal {
         (_a = this.parentRemovalObserver) === null || _a === void 0 ? void 0 : _a.disconnect();
         this.parentRemovalObserver = undefined;
     }
+    /**
+     * Creates the context object for safe-area utilities.
+     */
+    getSafeAreaContext() {
+        return {
+            isSheetModal: this.isSheetModal,
+            isCardModal: this.presentingElement !== undefined && getIonMode(this) === 'ios',
+            presentingElement: this.presentingElement,
+            breakpoints: this.breakpoints,
+            currentBreakpoint: this.currentBreakpoint,
+        };
+    }
+    /**
+     * Sets initial safe-area overrides before modal animation.
+     * Called in present() before animation starts.
+     *
+     * For sheet modals, the SCSS --height formula uses --ion-modal-offset-top
+     * (an internal property) instead of --ion-safe-area-top. We resolve the
+     * root safe-area-top to pixels and set --ion-modal-offset-top, decoupling
+     * the height calculation from --ion-safe-area-top (which is zeroed for
+     * sheets to prevent header content from getting double-offset padding).
+     */
+    setInitialSafeAreaOverrides() {
+        const context = this.getSafeAreaContext();
+        const safeAreaConfig = getInitialSafeAreaConfig(context);
+        applySafeAreaOverrides(this.el, safeAreaConfig);
+        // Set the internal offset property with the resolved root safe-area-top value
+        if (context.isSheetModal) {
+            this.updateSheetOffsetTop();
+        }
+    }
+    /**
+     * Resolves the current root --ion-safe-area-top value and sets the
+     * internal --ion-modal-offset-top property on the host element.
+     * Called on present and on resize (e.g., device rotation changes safe-area).
+     */
+    updateSheetOffsetTop() {
+        const safeAreaTop = getRootSafeAreaTop();
+        this.el.style.setProperty('--ion-modal-offset-top', `${safeAreaTop}px`);
+    }
+    /**
+     * Updates safe-area overrides during dynamic state changes.
+     * Called after animations, during gestures, and on orientation changes.
+     */
+    updateSafeAreaOverrides() {
+        const { wrapperEl, el } = this;
+        const context = this.getSafeAreaContext();
+        // Sheet modals: safe-area is fully determined at presentation time
+        // (top is always 0px, height is frozen). Nothing to update.
+        if (context.isSheetModal)
+            return;
+        // Card modals have fixed safe-area requirements set by initial prediction.
+        if (context.isCardModal)
+            return;
+        // wrapperEl is required for position-based detection below
+        if (!wrapperEl)
+            return;
+        // Regular modals: use position-based detection to correctly handle both
+        // fullscreen modals and centered dialogs with custom dimensions.
+        const safeAreaConfig = getPositionBasedSafeAreaConfig(wrapperEl);
+        applySafeAreaOverrides(el, safeAreaConfig);
+    }
+    /**
+     * Applies padding-bottom to fullscreen modal wrapper to prevent
+     * content from overlapping system navigation bar.
+     */
+    applyFullscreenSafeArea() {
+        const { wrapperEl, el } = this;
+        if (!wrapperEl)
+            return;
+        const context = this.getSafeAreaContext();
+        if (context.isSheetModal || context.isCardModal)
+            return;
+        // Check for standard Ionic layout children (ion-content, ion-footer),
+        // searching one level deep for wrapped components (e.g.,
+        // <app-footer><ion-footer>...</ion-footer></app-footer>).
+        // Note: uses a manual loop instead of querySelector(':scope > ...') because
+        // Stencil's mock-doc (used in spec tests) does not support :scope.
+        let hasContent = false;
+        let hasFooter = false;
+        for (const child of Array.from(el.children)) {
+            if (child.tagName === 'ION-CONTENT')
+                hasContent = true;
+            if (child.tagName === 'ION-FOOTER')
+                hasFooter = true;
+            for (const grandchild of Array.from(child.children)) {
+                if (grandchild.tagName === 'ION-CONTENT')
+                    hasContent = true;
+                if (grandchild.tagName === 'ION-FOOTER')
+                    hasFooter = true;
+            }
+        }
+        // Only apply wrapper padding for standard Ionic layouts (has ion-content
+        // but no ion-footer). Custom modals with raw HTML are fully
+        // developer-controlled and should not be modified.
+        if (!hasContent || hasFooter)
+            return;
+        // Reduce wrapper height by safe-area and add equivalent padding so the
+        // total visual size stays the same but the flex content area shrinks.
+        // Using height + padding instead of box-sizing: border-box avoids
+        // breaking custom modals that set --border-width (border-box would
+        // include the border inside the height, changing the layout).
+        wrapperEl.style.setProperty('height', 'calc(var(--height) - var(--ion-safe-area-bottom, 0px))');
+        wrapperEl.style.setProperty('padding-bottom', 'var(--ion-safe-area-bottom, 0px)');
+    }
+    /**
+     * Clears all safe-area overrides and padding from wrapper.
+     */
+    cleanupSafeAreaOverrides() {
+        clearSafeAreaOverrides(this.el);
+        // Remove internal sheet offset property
+        this.el.style.removeProperty('--ion-modal-offset-top');
+        if (this.wrapperEl) {
+            this.wrapperEl.style.removeProperty('height');
+            this.wrapperEl.style.removeProperty('padding-bottom');
+        }
+    }
     render() {
         const { handle, isSheetModal, presentingElement, htmlAttributes, handleBehavior, inheritedAttributes, focusTrap, expandToScroll, } = this;
         const showHandle = handle !== false && isSheetModal;
@@ -974,20 +1123,20 @@ export class Modal {
         const isCardModal = presentingElement !== undefined && mode === 'ios';
         const isHandleCycle = handleBehavior === 'cycle';
         const isSheetModalWithHandle = isSheetModal && showHandle;
-        return (h(Host, Object.assign({ key: '978ba9cc81464b2d9b4caaf36285d5f7bf7e568d', "no-router": true,
+        return (h(Host, Object.assign({ key: '952cbd52d1fc737332a23d523b02d5fa60abf30a', "no-router": true,
             // Allow the modal to be navigable when the handle is focusable
             tabIndex: isHandleCycle && isSheetModalWithHandle ? 0 : -1 }, htmlAttributes, { style: {
                 zIndex: `${20000 + this.overlayIndex}`,
-            }, class: Object.assign({ [mode]: true, ['modal-default']: !isCardModal && !isSheetModal, [`modal-card`]: isCardModal, [`modal-sheet`]: isSheetModal, [`modal-no-expand-scroll`]: isSheetModal && !expandToScroll, 'overlay-hidden': true, [FOCUS_TRAP_DISABLE_CLASS]: focusTrap === false }, getClassMap(this.cssClass)), onIonBackdropTap: this.onBackdropTap, onIonModalDidPresent: this.onLifecycle, onIonModalWillPresent: this.onLifecycle, onIonModalWillDismiss: this.onLifecycle, onIonModalDidDismiss: this.onLifecycle, onFocus: this.onModalFocus }), h("ion-backdrop", { key: '9f95566d8e0c06bb9607f514484848c250f35f1f', ref: (el) => (this.backdropEl = el), visible: this.showBackdrop, tappable: this.backdropDismiss, part: "backdrop" }), mode === 'ios' && h("div", { key: '91ff26d4f3ab4367f3a2940f51c6a5a3d4c972c3', class: "modal-shadow" }), h("div", Object.assign({ key: '064b2dba13854505a4eb1f5e54296ac79cb7a2bd',
+            }, class: Object.assign({ [mode]: true, ['modal-default']: !isCardModal && !isSheetModal, [`modal-card`]: isCardModal, [`modal-sheet`]: isSheetModal, [`modal-no-expand-scroll`]: isSheetModal && !expandToScroll, 'overlay-hidden': true, [FOCUS_TRAP_DISABLE_CLASS]: focusTrap === false }, getClassMap(this.cssClass)), onIonBackdropTap: this.onBackdropTap, onIonModalDidPresent: this.onLifecycle, onIonModalWillPresent: this.onLifecycle, onIonModalWillDismiss: this.onLifecycle, onIonModalDidDismiss: this.onLifecycle, onFocus: this.onModalFocus }), h("ion-backdrop", { key: '66e3658cfcc2961d99ecc1174f26b1794ceb65e9', ref: (el) => (this.backdropEl = el), visible: this.showBackdrop, tappable: this.backdropDismiss, part: "backdrop" }), mode === 'ios' && h("div", { key: '3d1b9b26daf87374e2029d0e0a7fc09b9257fd77', class: "modal-shadow" }), h("div", Object.assign({ key: 'e652c2b3eb66afa8367d94c3b14ba0e825877a82',
             /*
               role and aria-modal must be used on the
               same element. They must also be set inside the
               shadow DOM otherwise ion-button will not be highlighted
               when using VoiceOver: https://bugs.webkit.org/show_bug.cgi?id=247134
             */
-            role: "dialog" }, inheritedAttributes, { "aria-modal": "true", class: "modal-wrapper ion-overlay-wrapper", part: "content", ref: (el) => (this.wrapperEl = el) }), showHandle && (h("button", { key: 'b579b08b114022032d078a527111456ceefc7b35', class: "modal-handle",
+            role: "dialog" }, inheritedAttributes, { "aria-modal": "true", class: "modal-wrapper ion-overlay-wrapper", part: "content", ref: (el) => (this.wrapperEl = el) }), showHandle && (h("button", { key: '41662183450e8ef2f7d96dac2bea5952bad8b7a5', class: "modal-handle",
             // Prevents the handle from receiving keyboard focus when it does not cycle
-            tabIndex: !isHandleCycle ? -1 : 0, "aria-label": "Activate to adjust the size of the dialog overlaying the screen", onClick: isHandleCycle ? this.onHandleClick : undefined, part: "handle", ref: (el) => (this.dragHandleEl = el) })), h("slot", { key: 'dacea58475b72d9c0209934ff31f3be6b9ac8c85', onSlotchange: this.onSlotChange }))));
+            tabIndex: !isHandleCycle ? -1 : 0, "aria-label": "Activate to adjust the size of the dialog overlaying the screen", onClick: isHandleCycle ? this.onHandleClick : undefined, part: "handle", ref: (el) => (this.dragHandleEl = el) })), h("slot", { key: '4aac4e2928929b9e5e59b33c83395182105da529', onSlotchange: this.onSlotChange }))));
     }
     static get is() { return "ion-modal"; }
     static get encapsulation() { return "shadow"; }

package/dist/collection/components/modal/modal.md.css

@@ -135,10 +135,6 @@ ion-backdrop {
   :host {
     --width: 600px;
     --height: 500px;
-    --ion-safe-area-top: 0px;
-    --ion-safe-area-bottom: 0px;
-    --ion-safe-area-right: 0px;
-    --ion-safe-area-left: 0px;
   }
 }
 @media only screen and (min-width: 768px) and (min-height: 768px) {
@@ -190,9 +186,14 @@ ion-backdrop {
 /**
  * Ensure that the sheet modal does not
  * completely cover the content.
+ *
+ * --ion-modal-offset-top is an internal property set by modal.tsx
+ * with the resolved root safe-area-top pixel value. This decouples
+ * the height calculation from --ion-safe-area-top (which is zeroed
+ * for sheet modals to prevent header double-padding).
  */
 :host(.modal-sheet) {
-  --height: calc(100% - (var(--ion-safe-area-top) + 10px));
+  --height: calc(100% - (var(--ion-modal-offset-top, 0px) + 10px));
 }
 
 :host(.modal-sheet) .modal-wrapper,

package/dist/collection/components/modal/safe-area-utils.js

@@ -0,0 +1,165 @@
+/*!
+ * (C) Ionic http://ionicframework.com - MIT License
+ */
+import { win } from "../../utils/browser/index";
+import { raf } from "../../utils/helpers";
+/**
+ * These thresholds match the SCSS media query breakpoints in modal.vars.scss
+ * that trigger the centered dialog layout (non-fullscreen modal).
+ *
+ * SCSS defines two height breakpoints: $modal-inset-min-height-small (600px)
+ * and $modal-inset-min-height-large (768px). We use the smaller one because
+ * that's the threshold where the modal transitions from fullscreen to centered
+ * dialog — the larger breakpoint only increases the dialog's height.
+ */
+const MODAL_INSET_MIN_WIDTH = 768;
+const MODAL_INSET_MIN_HEIGHT = 600;
+const EDGE_THRESHOLD = 5;
+/**
+ * Cache for resolved root safe-area-top value, invalidated once per frame.
+ */
+let cachedRootSafeAreaTop = null;
+let cacheInvalidationScheduled = false;
+/**
+ * Determines if the current viewport meets the CSS media query conditions
+ * that cause regular modals to render as centered dialogs instead of fullscreen.
+ * Matches: @media (min-width: 768px) and (min-height: 600px)
+ */
+const isCenteredDialogViewport = () => {
+    if (!win)
+        return false;
+    return win.matchMedia(`(min-width: ${MODAL_INSET_MIN_WIDTH}px) and (min-height: ${MODAL_INSET_MIN_HEIGHT}px)`)
+        .matches;
+};
+/**
+ * Resolves the current root --ion-safe-area-top value to pixels.
+ * Uses a temporary element because getComputedStyle on :root returns
+ * the declared value of custom properties (e.g. "env(safe-area-inset-top)")
+ * rather than a resolved number.
+ *
+ * Results are cached for the current frame to avoid repeated reflows.
+ */
+export const getRootSafeAreaTop = () => {
+    if (cachedRootSafeAreaTop !== null) {
+        return cachedRootSafeAreaTop;
+    }
+    const doc = win === null || win === void 0 ? void 0 : win.document;
+    if (!(doc === null || doc === void 0 ? void 0 : doc.body)) {
+        return 0;
+    }
+    const el = doc.createElement('div');
+    el.style.cssText =
+        'position:fixed;visibility:hidden;pointer-events:none;top:0;left:0;' + 'padding-top:var(--ion-safe-area-top,0px);';
+    doc.body.appendChild(el);
+    const value = parseFloat(getComputedStyle(el).paddingTop) || 0;
+    el.remove();
+    cachedRootSafeAreaTop = value;
+    if (!cacheInvalidationScheduled) {
+        cacheInvalidationScheduled = true;
+        raf(() => {
+            cachedRootSafeAreaTop = null;
+            cacheInvalidationScheduled = false;
+        });
+    }
+    return value;
+};
+/**
+ * Returns the initial safe-area configuration based on modal type.
+ * This is called before animation starts and uses configuration-based prediction.
+ *
+ * @param context - Modal context information
+ * @returns SafeAreaConfig with initial safe-area values
+ */
+export const getInitialSafeAreaConfig = (context) => {
+    const { isSheetModal, isCardModal } = context;
+    // Sheet modals always zero top safe-area. The sheet height offset from the
+    // top edge is handled by --ion-modal-offset-top (set in modal.tsx) using
+    // the resolved root value, so --ion-safe-area-top is never needed for
+    // height calculation. Keeping it at 0px prevents header content from
+    // getting double-offset padding.
+    if (isSheetModal) {
+        return {
+            top: '0px',
+            bottom: 'inherit',
+            left: '0px',
+            right: '0px',
+        };
+    }
+    // Card modals need safe-area for height calculation.
+    // Note: isCardModal is already gated on mode === 'ios' by the caller.
+    if (isCardModal) {
+        return {
+            top: 'inherit',
+            bottom: 'inherit',
+            left: '0px',
+            right: '0px',
+        };
+    }
+    // On viewports that meet the centered dialog media query breakpoints,
+    // regular modals render as centered dialogs (not fullscreen), so they
+    // don't touch any screen edges and don't need safe-area insets.
+    if (isCenteredDialogViewport()) {
+        return {
+            top: '0px',
+            bottom: '0px',
+            left: '0px',
+            right: '0px',
+        };
+    }
+    // Fullscreen modals on phone - inherit all safe areas
+    return {
+        top: 'inherit',
+        bottom: 'inherit',
+        left: 'inherit',
+        right: 'inherit',
+    };
+};
+/**
+ * Returns safe-area configuration based on actual modal position.
+ * Detects which edges the modal overlaps with and only applies safe-area to those edges.
+ *
+ * Note: On Android edge-to-edge (API 36+), getBoundingClientRect() may report
+ * inconsistent values. Sheet and card modals avoid this by using configuration-based
+ * prediction instead. Regular modals use coordinate detection which works reliably
+ * on web and iOS; Android edge-to-edge may need a configuration-based fallback
+ * once a reliable detection mechanism is available.
+ *
+ * @param wrapperEl - The modal wrapper element to measure
+ * @returns SafeAreaConfig based on position
+ */
+export const getPositionBasedSafeAreaConfig = (wrapperEl) => {
+    var _a, _b;
+    const rect = wrapperEl.getBoundingClientRect();
+    const vh = (_a = win === null || win === void 0 ? void 0 : win.innerHeight) !== null && _a !== void 0 ? _a : 0;
+    const vw = (_b = win === null || win === void 0 ? void 0 : win.innerWidth) !== null && _b !== void 0 ? _b : 0;
+    // Only apply safe-area to sides where modal overlaps with screen edge
+    return {
+        top: rect.top <= EDGE_THRESHOLD ? 'inherit' : '0px',
+        bottom: rect.bottom >= vh - EDGE_THRESHOLD ? 'inherit' : '0px',
+        left: rect.left <= EDGE_THRESHOLD ? 'inherit' : '0px',
+        right: rect.right >= vw - EDGE_THRESHOLD ? 'inherit' : '0px',
+    };
+};
+/**
+ * Applies safe-area CSS custom property overrides to the modal host element.
+ *
+ * @param hostEl - The modal host element (ion-modal)
+ * @param config - Safe-area configuration to apply
+ */
+export const applySafeAreaOverrides = (hostEl, config) => {
+    hostEl.style.setProperty('--ion-safe-area-top', config.top);
+    hostEl.style.setProperty('--ion-safe-area-bottom', config.bottom);
+    hostEl.style.setProperty('--ion-safe-area-left', config.left);
+    hostEl.style.setProperty('--ion-safe-area-right', config.right);
+};
+/**
+ * Clears safe-area CSS custom property overrides from the modal host element.
+ *
+ * @param hostEl - The modal host element (ion-modal)
+ */
+export const clearSafeAreaOverrides = (hostEl) => {
+    hostEl.style.removeProperty('--ion-safe-area-top');
+    hostEl.style.removeProperty('--ion-safe-area-bottom');
+    hostEl.style.removeProperty('--ion-safe-area-left');
+    hostEl.style.removeProperty('--ion-safe-area-right');
+};

package/dist/collection/components/popover/animations/ios.enter.js

@@ -3,8 +3,17 @@
  */
 import { createAnimation } from "../../../utils/animation/animation";
 import { getElementRoot } from "../../../utils/helpers";
-import { calculateWindowAdjustment, getArrowDimensions, getPopoverDimensions, getPopoverPosition, shouldShowArrow, } from "../utils";
+import { calculateWindowAdjustment, getArrowDimensions, getPopoverDimensions, getPopoverPosition, getSafeAreaInsets, shouldShowArrow, } from "../utils";
 const POPOVER_IOS_BODY_PADDING = 5;
+/**
+ * Minimum edge margin for iOS popovers ensures visual spacing from screen
+ * edges on devices without safe areas (e.g., older iPhones without notches).
+ * Previously this was a hardcoded `safeAreaMargin = 25` that served dual
+ * purpose: safe-area avoidance AND visual spacing. Now that actual safe-area
+ * insets are read dynamically, this floor preserves the visual spacing when
+ * safe-area values are 0.
+ */
+const POPOVER_IOS_MIN_EDGE_MARGIN = 25;
 /**
  * iOS Popover Enter Animation
  */
@@ -30,8 +39,16 @@ export const iosEnterAnimation = (baseEl, opts) => {
     };
     const results = getPopoverPosition(isRTL, contentWidth, contentHeight, arrowWidth, arrowHeight, reference, side, align, defaultPosition, trigger, ev);
     const padding = size === 'cover' ? 0 : POPOVER_IOS_BODY_PADDING;
-    const margin = size === 'cover' ? 0 : 25;
-    const { originX, originY, top, left, bottom, checkSafeAreaLeft, checkSafeAreaRight, arrowTop, arrowLeft, addPopoverBottomClass, } = calculateWindowAdjustment(side, results.top, results.left, padding, bodyWidth, bodyHeight, contentWidth, contentHeight, margin, results.originX, results.originY, results.referenceCoordinates, results.arrowTop, results.arrowLeft, arrowHeight);
+    const rawSafeArea = getSafeAreaInsets(doc);
+    const safeArea = size === 'cover'
+        ? { top: 0, bottom: 0, left: 0, right: 0 }
+        : {
+            top: Math.max(rawSafeArea.top, POPOVER_IOS_MIN_EDGE_MARGIN),
+            bottom: Math.max(rawSafeArea.bottom, POPOVER_IOS_MIN_EDGE_MARGIN),
+            left: Math.max(rawSafeArea.left, POPOVER_IOS_MIN_EDGE_MARGIN),
+            right: Math.max(rawSafeArea.right, POPOVER_IOS_MIN_EDGE_MARGIN),
+        };
+    const { originX, originY, top, left, bottom, checkSafeAreaLeft, checkSafeAreaRight, checkSafeAreaTop, checkSafeAreaBottom, arrowTop, arrowLeft, addPopoverBottomClass, hideArrow, } = calculateWindowAdjustment(side, results.top, results.left, padding, bodyWidth, bodyHeight, contentWidth, contentHeight, safeArea, results.originX, results.originY, results.referenceCoordinates, results.arrowTop, results.arrowLeft, arrowHeight);
     const baseAnimation = createAnimation();
     const backdropAnimation = createAnimation();
     const contentAnimation = createAnimation();
@@ -62,10 +79,14 @@ export const iosEnterAnimation = (baseEl, opts) => {
             baseEl.classList.add('popover-bottom');
         }
         if (bottom !== undefined) {
-            contentEl.style.setProperty('bottom', `${bottom}px`);
+            let bottomValue = `${bottom}px`;
+            if (checkSafeAreaBottom) {
+                bottomValue = `${bottom}px + var(--ion-safe-area-bottom, 0px)`;
+            }
+            contentEl.style.setProperty('bottom', `calc(${bottomValue})`);
         }
-        const safeAreaLeft = ' + var(--ion-safe-area-left, 0)';
-        const safeAreaRight = ' - var(--ion-safe-area-right, 0)';
+        const safeAreaLeft = ' + var(--ion-safe-area-left, 0px)';
+        const safeAreaRight = ' - var(--ion-safe-area-right, 0px)';
         let leftValue = `${left}px`;
         if (checkSafeAreaLeft) {
             leftValue = `${left}px${safeAreaLeft}`;
@@ -73,12 +94,16 @@ export const iosEnterAnimation = (baseEl, opts) => {
         if (checkSafeAreaRight) {
             leftValue = `${left}px${safeAreaRight}`;
         }
-        contentEl.style.setProperty('top', `calc(${top}px + var(--offset-y, 0))`);
+        let topValue = `${top}px`;
+        if (checkSafeAreaTop) {
+            topValue = `${top}px + var(--ion-safe-area-top, 0px)`;
+        }
+        contentEl.style.setProperty('top', `calc(${topValue} + var(--offset-y, 0))`);
         contentEl.style.setProperty('left', `calc(${leftValue} + var(--offset-x, 0))`);
         contentEl.style.setProperty('transform-origin', `${originY} ${originX}`);
         if (arrowEl !== null) {
             const didAdjustBounds = results.top !== top || results.left !== left;
-            const showArrow = shouldShowArrow(side, didAdjustBounds, ev, trigger);
+            const showArrow = !hideArrow && shouldShowArrow(side, didAdjustBounds, ev, trigger);
             if (showArrow) {
                 arrowEl.style.setProperty('top', `calc(${arrowTop}px + var(--offset-y, 0))`);
                 arrowEl.style.setProperty('left', `calc(${arrowLeft}px + var(--offset-x, 0))`);

package/dist/collection/components/popover/animations/md.enter.js

@@ -3,7 +3,7 @@
  */
 import { createAnimation } from "../../../utils/animation/animation";
 import { getElementRoot } from "../../../utils/helpers";
-import { calculateWindowAdjustment, getPopoverDimensions, getPopoverPosition } from "../utils";
+import { calculateWindowAdjustment, getPopoverDimensions, getPopoverPosition, getSafeAreaInsets } from "../utils";
 const POPOVER_MD_BODY_PADDING = 12;
 /**
  * Md Popover Enter Animation
@@ -28,7 +28,23 @@ export const mdEnterAnimation = (baseEl, opts) => {
     };
     const results = getPopoverPosition(isRTL, contentWidth, contentHeight, 0, 0, reference, side, align, defaultPosition, trigger, ev);
     const padding = size === 'cover' ? 0 : POPOVER_MD_BODY_PADDING;
-    const { originX, originY, top, left, bottom } = calculateWindowAdjustment(side, results.top, results.left, padding, bodyWidth, bodyHeight, contentWidth, contentHeight, 0, results.originX, results.originY, results.referenceCoordinates);
+    // MD mode now applies safe-area insets (previously passed 0, ignoring all safe areas).
+    // This is needed for Android edge-to-edge (API 36+) where system bars overlap content.
+    const safeArea = size === 'cover' ? { top: 0, bottom: 0, left: 0, right: 0 } : getSafeAreaInsets(doc);
+    const { originX, originY, top, left, bottom, checkSafeAreaLeft, checkSafeAreaRight, checkSafeAreaTop, checkSafeAreaBottom, addPopoverBottomClass, } = calculateWindowAdjustment(side, results.top, results.left, padding, bodyWidth, bodyHeight, contentWidth, contentHeight, safeArea, results.originX, results.originY, results.referenceCoordinates);
+    const safeAreaLeftCalc = ' + var(--ion-safe-area-left, 0px)';
+    const safeAreaRightCalc = ' - var(--ion-safe-area-right, 0px)';
+    let leftValue = `${left}px`;
+    if (checkSafeAreaLeft) {
+        leftValue = `${left}px${safeAreaLeftCalc}`;
+    }
+    if (checkSafeAreaRight) {
+        leftValue = `${left}px${safeAreaRightCalc}`;
+    }
+    let topValue = `${top}px`;
+    if (checkSafeAreaTop) {
+        topValue = `${top}px + var(--ion-safe-area-top, 0px)`;
+    }
     const baseAnimation = createAnimation();
     const backdropAnimation = createAnimation();
     const wrapperAnimation = createAnimation();
@@ -45,13 +61,17 @@ export const mdEnterAnimation = (baseEl, opts) => {
     contentAnimation
         .addElement(contentEl)
         .beforeStyles({
-        top: `calc(${top}px + var(--offset-y, 0px))`,
-        left: `calc(${left}px + var(--offset-x, 0px))`,
+        top: `calc(${topValue} + var(--offset-y, 0px))`,
+        left: `calc(${leftValue} + var(--offset-x, 0px))`,
         'transform-origin': `${originY} ${originX}`,
     })
         .beforeAddWrite(() => {
         if (bottom !== undefined) {
-            contentEl.style.setProperty('bottom', `${bottom}px`);
+            let bottomValue = `${bottom}px`;
+            if (checkSafeAreaBottom) {
+                bottomValue = `${bottom}px + var(--ion-safe-area-bottom, 0px)`;
+            }
+            contentEl.style.setProperty('bottom', `calc(${bottomValue})`);
         }
     })
         .fromTo('transform', 'scale(0.8)', 'scale(1)');
@@ -63,7 +83,7 @@ export const mdEnterAnimation = (baseEl, opts) => {
         if (size === 'cover') {
             baseEl.style.setProperty('--width', `${contentWidth}px`);
         }
-        if (originY === 'bottom') {
+        if (addPopoverBottomClass) {
             baseEl.classList.add('popover-bottom');
         }
     })