@ionic/core 8.7.17-dev.11767647939.17c197c2 → 8.7.17-dev.11767796972.148e4bc4

package/dist/cjs/ion-modal.cjs.entry.js

@@ -1505,6 +1505,8 @@ const Modal = class {
         this.gestureAnimationDismissing = false;
         // Whether to skip coordinate-based safe-area detection (for fullscreen phone modals)
         this.skipSafeAreaCoordinateDetection = false;
+        // Track previous safe-area state to avoid redundant DOM writes
+        this.prevSafeAreaState = { top: false, bottom: false, left: false, right: false };
         this.presented = false;
         /** @internal */
         this.hasController = false;
@@ -1695,7 +1697,8 @@ const Modal = class {
         }
     }
     onWindowResize() {
-        // Update safe-area overrides for all modal types on resize
+        // Invalidate safe-area cache on resize (device rotation may change values)
+        this.cachedSafeAreas = undefined;
         this.updateSafeAreaOverrides();
         // Only handle view transition for iOS card modals when no custom animations are provided
         if (ionicGlobal.getIonMode(this) !== 'ios' || !this.presentingElement || this.enterAnimation || this.leaveAnimation) {
@@ -2154,8 +2157,26 @@ const Modal = class {
      */
     applyFullscreenSafeArea() {
         this.skipSafeAreaCoordinateDetection = true;
+        this.updateFooterPadding();
+        // Watch for dynamic footer additions/removals (e.g., async data loading)
+        if (!this.footerObserver) {
+            this.footerObserver = new MutationObserver(() => this.updateFooterPadding());
+            this.footerObserver.observe(this.el, { childList: true, subtree: true });
+        }
+    }
+    /**
+     * Updates wrapper padding based on footer presence.
+     * Called initially and when footer is dynamically added/removed.
+     */
+    updateFooterPadding() {
+        if (!this.wrapperEl)
+            return;
         const hasFooter = this.el.querySelector('ion-footer') !== null;
-        if (!hasFooter && this.wrapperEl) {
+        if (hasFooter) {
+            this.wrapperEl.style.removeProperty('padding-bottom');
+            this.wrapperEl.style.removeProperty('box-sizing');
+        }
+        else {
             this.wrapperEl.style.setProperty('padding-bottom', 'var(--ion-safe-area-bottom, 0px)');
             this.wrapperEl.style.setProperty('box-sizing', 'border-box');
         }
@@ -2173,21 +2194,26 @@ const Modal = class {
     }
     /**
      * Gets the root safe-area values from the document element.
-     * These represent the actual device safe areas before any overlay overrides.
+     * Uses cached values during gestures to avoid getComputedStyle calls.
      */
-    getRootSafeAreaValues() {
-        const rootStyle = getComputedStyle(document.documentElement);
-        return {
-            top: parseFloat(rootStyle.getPropertyValue('--ion-safe-area-top')) || 0,
-            bottom: parseFloat(rootStyle.getPropertyValue('--ion-safe-area-bottom')) || 0,
-            left: parseFloat(rootStyle.getPropertyValue('--ion-safe-area-left')) || 0,
-            right: parseFloat(rootStyle.getPropertyValue('--ion-safe-area-right')) || 0,
-        };
+    getSafeAreaValues() {
+        if (!this.cachedSafeAreas) {
+            const rootStyle = getComputedStyle(document.documentElement);
+            this.cachedSafeAreas = {
+                top: parseFloat(rootStyle.getPropertyValue('--ion-safe-area-top')) || 0,
+                bottom: parseFloat(rootStyle.getPropertyValue('--ion-safe-area-bottom')) || 0,
+                left: parseFloat(rootStyle.getPropertyValue('--ion-safe-area-left')) || 0,
+                right: parseFloat(rootStyle.getPropertyValue('--ion-safe-area-right')) || 0,
+            };
+        }
+        return this.cachedSafeAreas;
     }
     /**
      * Updates safe-area CSS variable overrides based on whether the modal
      * extends into each safe-area region. Called after animation
      * and during gestures to handle dynamic position changes.
+     *
+     * Optimized to avoid redundant DOM writes by tracking previous state.
      */
     updateSafeAreaOverrides() {
         if (this.skipSafeAreaCoordinateDetection) {
@@ -2198,20 +2224,34 @@ const Modal = class {
             return;
         }
         const rect = wrapper.getBoundingClientRect();
-        const safeAreas = this.getRootSafeAreaValues();
+        const safeAreas = this.getSafeAreaValues();
         const extendsIntoTop = rect.top < safeAreas.top;
         const extendsIntoBottom = rect.bottom > window.innerHeight - safeAreas.bottom;
         const extendsIntoLeft = rect.left < safeAreas.left;
         const extendsIntoRight = rect.right > window.innerWidth - safeAreas.right;
+        // Only update DOM when state actually changes
+        const prev = this.prevSafeAreaState;
         const style = this.el.style;
-        extendsIntoTop ? style.removeProperty('--ion-safe-area-top') : style.setProperty('--ion-safe-area-top', '0px');
-        extendsIntoBottom
-            ? style.removeProperty('--ion-safe-area-bottom')
-            : style.setProperty('--ion-safe-area-bottom', '0px');
-        extendsIntoLeft ? style.removeProperty('--ion-safe-area-left') : style.setProperty('--ion-safe-area-left', '0px');
-        extendsIntoRight
-            ? style.removeProperty('--ion-safe-area-right')
-            : style.setProperty('--ion-safe-area-right', '0px');
+        if (extendsIntoTop !== prev.top) {
+            extendsIntoTop ? style.removeProperty('--ion-safe-area-top') : style.setProperty('--ion-safe-area-top', '0px');
+            prev.top = extendsIntoTop;
+        }
+        if (extendsIntoBottom !== prev.bottom) {
+            extendsIntoBottom
+                ? style.removeProperty('--ion-safe-area-bottom')
+                : style.setProperty('--ion-safe-area-bottom', '0px');
+            prev.bottom = extendsIntoBottom;
+        }
+        if (extendsIntoLeft !== prev.left) {
+            extendsIntoLeft ? style.removeProperty('--ion-safe-area-left') : style.setProperty('--ion-safe-area-left', '0px');
+            prev.left = extendsIntoLeft;
+        }
+        if (extendsIntoRight !== prev.right) {
+            extendsIntoRight
+                ? style.removeProperty('--ion-safe-area-right')
+                : style.setProperty('--ion-safe-area-right', '0px');
+            prev.right = extendsIntoRight;
+        }
     }
     sheetOnDismiss() {
         /**
@@ -2243,7 +2283,7 @@ const Modal = class {
      * For example, `cancel` or `backdrop`.
      */
     async dismiss(data, role) {
-        var _a;
+        var _a, _b;
         if (this.gestureAnimationDismissing && role !== overlays.GESTURE) {
             return false;
         }
@@ -2305,8 +2345,23 @@ const Modal = class {
         }
         this.currentBreakpoint = undefined;
         this.animation = undefined;
-        // Reset safe-area detection flag for potential re-presentation
+        // Reset safe-area state for potential re-presentation
         this.skipSafeAreaCoordinateDetection = false;
+        this.cachedSafeAreas = undefined;
+        this.prevSafeAreaState = { top: false, bottom: false, left: false, right: false };
+        (_b = this.footerObserver) === null || _b === void 0 ? void 0 : _b.disconnect();
+        this.footerObserver = undefined;
+        // Clear styles that may have been set for safe-area handling
+        if (this.wrapperEl) {
+            this.wrapperEl.style.removeProperty('padding-bottom');
+            this.wrapperEl.style.removeProperty('box-sizing');
+        }
+        // Clear safe-area CSS variable overrides
+        const style = this.el.style;
+        style.removeProperty('--ion-safe-area-top');
+        style.removeProperty('--ion-safe-area-bottom');
+        style.removeProperty('--ion-safe-area-left');
+        style.removeProperty('--ion-safe-area-right');
         unlock();
         return dismissed;
     }
@@ -2556,20 +2611,20 @@ const Modal = class {
         const isCardModal = presentingElement !== undefined && mode === 'ios';
         const isHandleCycle = handleBehavior === 'cycle';
         const isSheetModalWithHandle = isSheetModal && showHandle;
-        return (index$3.h(index$3.Host, Object.assign({ key: '07ebca6a70eb99f8a2236e1d66a03097a7bb67d8', "no-router": true,
+        return (index$3.h(index$3.Host, Object.assign({ key: '11cd16cc481093a38a327abdd94467be3f71718d', "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, [overlays.FOCUS_TRAP_DISABLE_CLASS]: focusTrap === false }, theme.getClassMap(this.cssClass)), onIonBackdropTap: this.onBackdropTap, onIonModalDidPresent: this.onLifecycle, onIonModalWillPresent: this.onLifecycle, onIonModalWillDismiss: this.onLifecycle, onIonModalDidDismiss: this.onLifecycle, onFocus: this.onModalFocus }), index$3.h("ion-backdrop", { key: '1b6850d9b9f6e8f3865b49e0a14399e2ef43a5d6', ref: (el) => (this.backdropEl = el), visible: this.showBackdrop, tappable: this.backdropDismiss, part: "backdrop" }), mode === 'ios' && index$3.h("div", { key: 'eab52c0ebccb820781e92392dc6fa90db93525d5', class: "modal-shadow" }), index$3.h("div", Object.assign({ key: 'ab9448cabdf03a633319999771ce1ca1edce5699',
+            }, class: Object.assign({ [mode]: true, ['modal-default']: !isCardModal && !isSheetModal, [`modal-card`]: isCardModal, [`modal-sheet`]: isSheetModal, [`modal-no-expand-scroll`]: isSheetModal && !expandToScroll, 'overlay-hidden': true, [overlays.FOCUS_TRAP_DISABLE_CLASS]: focusTrap === false }, theme.getClassMap(this.cssClass)), onIonBackdropTap: this.onBackdropTap, onIonModalDidPresent: this.onLifecycle, onIonModalWillPresent: this.onLifecycle, onIonModalWillDismiss: this.onLifecycle, onIonModalDidDismiss: this.onLifecycle, onFocus: this.onModalFocus }), index$3.h("ion-backdrop", { key: '125658fbb071960da3905854668078e15bce56da', ref: (el) => (this.backdropEl = el), visible: this.showBackdrop, tappable: this.backdropDismiss, part: "backdrop" }), mode === 'ios' && index$3.h("div", { key: '4a63815ef165e5806fef85ef48bf509813ff55c9', class: "modal-shadow" }), index$3.h("div", Object.assign({ key: 'cfc4b20354cbf2c0f873f6aee91c9b8f553de61d',
             /*
               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 && (index$3.h("button", { key: 'b2b8c0a8d8add0d43e928dd3d3519f184551e62b', class: "modal-handle",
+            role: "dialog" }, inheritedAttributes, { "aria-modal": "true", class: "modal-wrapper ion-overlay-wrapper", part: "content", ref: (el) => (this.wrapperEl = el) }), showHandle && (index$3.h("button", { key: '33a4ee89bb8b6512883cb8756641c1e27fdb0ebc', 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) })), index$3.h("slot", { key: 'b994f206765f7b340971d378f00999c0da334102', 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) })), index$3.h("slot", { key: '986fafb71234591c96e927f92b7330bb5c76fc2e', onSlotchange: this.onSlotChange }))));
     }
     get el() { return index$3.getElement(this); }
     static get watchers() { return {

package/dist/collection/components/content/content.css

@@ -263,6 +263,16 @@
   transform: scaleX(-1);
 }
 
+:host(.safe-area-top) #background-content,
+:host(.safe-area-top) .inner-scroll {
+  top: var(--ion-safe-area-top, 0px);
+}
+
+:host(.safe-area-bottom) #background-content,
+:host(.safe-area-bottom) .inner-scroll {
+  bottom: var(--ion-safe-area-bottom, 0px);
+}
+
 ::slotted([slot=fixed]) {
   position: absolute;
   /**

package/dist/collection/components/content/content.js

@@ -25,6 +25,12 @@ export class Content {
         this.isMainContent = true;
         this.resizeTimeout = null;
         this.inheritedAttributes = {};
+        /**
+         * Track whether this content has sibling header/footer elements.
+         * When absent, we need to apply safe-area padding directly.
+         */
+        this.hasHeader = false;
+        this.hasFooter = false;
         this.tabsElement = null;
         // Detail is used in a hot loop in the scroll event, by allocating it here
         // V8 will be able to inline any read/write to it since it's a monomorphic class.
@@ -80,6 +86,8 @@ export class Content {
     }
     connectedCallback() {
         this.isMainContent = this.el.closest('ion-menu, ion-popover, ion-modal') === null;
+        // Detect sibling header/footer for safe-area handling
+        this.detectSiblingElements();
         /**
          * The fullscreen content offsets need to be
          * computed after the tab bar has loaded. Since
@@ -115,8 +123,71 @@ export class Content {
             }
         }
     }
+    /**
+     * Detects sibling ion-header and ion-footer elements and sets up
+     * a mutation observer to handle dynamic changes (e.g., conditional rendering).
+     */
+    detectSiblingElements() {
+        this.updateSiblingDetection();
+        // Watch for dynamic header/footer changes (common in React conditional rendering)
+        const parent = this.el.parentElement;
+        if (parent && !this.parentMutationObserver) {
+            this.parentMutationObserver = new MutationObserver(() => {
+                this.updateSiblingDetection();
+                forceUpdate(this);
+            });
+            this.parentMutationObserver.observe(parent, { childList: true });
+        }
+    }
+    /**
+     * Updates hasHeader/hasFooter based on current DOM state.
+     * Checks both direct siblings and elements wrapped in custom components
+     * (e.g., <my-header><ion-header>...</ion-header></my-header>).
+     */
+    updateSiblingDetection() {
+        const parent = this.el.parentElement;
+        if (parent) {
+            // First check for direct ion-header/ion-footer siblings
+            this.hasHeader = parent.querySelector(':scope > ion-header') !== null;
+            this.hasFooter = parent.querySelector(':scope > ion-footer') !== null;
+            // If not found, check if any sibling contains them (wrapped components)
+            if (!this.hasHeader) {
+                this.hasHeader = this.siblingContainsElement(parent, 'ion-header');
+            }
+            if (!this.hasFooter) {
+                this.hasFooter = this.siblingContainsElement(parent, 'ion-footer');
+            }
+        }
+        // If no footer found, check if we're inside ion-tabs which has ion-tab-bar
+        if (!this.hasFooter) {
+            const tabs = this.el.closest('ion-tabs');
+            if (tabs) {
+                this.hasFooter = tabs.querySelector(':scope > ion-tab-bar') !== null;
+            }
+        }
+    }
+    /**
+     * Checks if any sibling element of ion-content contains the specified element.
+     * Only searches one level deep to avoid finding elements in nested pages.
+     */
+    siblingContainsElement(parent, tagName) {
+        for (const sibling of parent.children) {
+            // Skip ion-content itself
+            if (sibling === this.el)
+                continue;
+            // Check if this sibling contains the target element as an immediate child
+            if (sibling.querySelector(`:scope > ${tagName}`) !== null) {
+                return true;
+            }
+        }
+        return false;
+    }
     disconnectedCallback() {
+        var _a;
         this.onScrollEnd();
+        // Clean up mutation observer to prevent memory leaks
+        (_a = this.parentMutationObserver) === null || _a === void 0 ? void 0 : _a.disconnect();
+        this.parentMutationObserver = undefined;
         if (hasLazyBuild(this.el)) {
             /**
              * The event listener and tabs caches need to
@@ -363,26 +434,28 @@ export class Content {
         }
     }
     render() {
-        const { fixedSlotPlacement, inheritedAttributes, isMainContent, scrollX, scrollY, el } = this;
+        const { fixedSlotPlacement, hasFooter, hasHeader, inheritedAttributes, isMainContent, scrollX, scrollY, el } = this;
         const rtl = isRTL(el) ? 'rtl' : 'ltr';
         const mode = getIonMode(this);
         const forceOverscroll = this.shouldForceOverscroll();
         const transitionShadow = mode === 'ios';
         this.resize();
-        return (h(Host, Object.assign({ key: 'cd8781f848d8dc926fe66f43d43c49564425a507', role: isMainContent ? 'main' : undefined, class: createColorClasses(this.color, {
+        return (h(Host, Object.assign({ key: 'c8e3a93e0b1ba6f7aa81a6a6065145ece9a6e2ef', role: isMainContent ? 'main' : undefined, class: createColorClasses(this.color, {
                 [mode]: true,
                 'content-sizing': hostContext('ion-popover', this.el),
                 overscroll: forceOverscroll,
                 [`content-${rtl}`]: true,
+                'safe-area-top': isMainContent && !hasHeader,
+                'safe-area-bottom': isMainContent && !hasFooter,
             }), style: {
                 '--offset-top': `${this.cTop}px`,
                 '--offset-bottom': `${this.cBottom}px`,
-            } }, inheritedAttributes), h("div", { key: '95b112d7cae30f22ef778ceffb88edb4d941c170', ref: (el) => (this.backgroundContentEl = el), id: "background-content", part: "background" }), fixedSlotPlacement === 'before' ? h("slot", { name: "fixed" }) : null, h("div", { key: '2fdfcbc39fb66f11b6191911f2941c660f4c12e5', class: {
+            } }, inheritedAttributes), h("div", { key: '4c0482cda885348eea9eb66d7f076af6b38c52e5', ref: (el) => (this.backgroundContentEl = el), id: "background-content", part: "background" }), fixedSlotPlacement === 'before' ? h("slot", { name: "fixed" }) : null, h("div", { key: '6fbb39bf7ab7120009c56aea9340de45c934eeed', class: {
                 'inner-scroll': true,
                 'scroll-x': scrollX,
                 'scroll-y': scrollY,
                 overscroll: (scrollX || scrollY) && forceOverscroll,
-            }, ref: (scrollEl) => (this.scrollEl = scrollEl), onScroll: this.scrollEvents ? (ev) => this.onScroll(ev) : undefined, part: "scroll" }, h("slot", { key: '6bc77e0054ec8e21635a7f2abfe0ca46e0962e03' })), transitionShadow ? (h("div", { class: "transition-effect" }, h("div", { class: "transition-cover" }), h("div", { class: "transition-shadow" }))) : null, fixedSlotPlacement === 'after' ? h("slot", { name: "fixed" }) : null));
+            }, ref: (scrollEl) => (this.scrollEl = scrollEl), onScroll: this.scrollEvents ? (ev) => this.onScroll(ev) : undefined, part: "scroll" }, h("slot", { key: '6425bc84edbc0c5b1f2764a1d611df1b46628274' })), transitionShadow ? (h("div", { class: "transition-effect" }, h("div", { class: "transition-cover" }), h("div", { class: "transition-shadow" }))) : null, fixedSlotPlacement === 'after' ? h("slot", { name: "fixed" }) : null));
     }
     static get is() { return "ion-content"; }
     static get encapsulation() { return "shadow"; }

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

@@ -44,6 +44,8 @@ export class Modal {
         this.gestureAnimationDismissing = false;
         // Whether to skip coordinate-based safe-area detection (for fullscreen phone modals)
         this.skipSafeAreaCoordinateDetection = false;
+        // Track previous safe-area state to avoid redundant DOM writes
+        this.prevSafeAreaState = { top: false, bottom: false, left: false, right: false };
         this.presented = false;
         /** @internal */
         this.hasController = false;
@@ -234,7 +236,8 @@ export class Modal {
         }
     }
     onWindowResize() {
-        // Update safe-area overrides for all modal types on resize
+        // Invalidate safe-area cache on resize (device rotation may change values)
+        this.cachedSafeAreas = undefined;
         this.updateSafeAreaOverrides();
         // Only handle view transition for iOS card modals when no custom animations are provided
         if (getIonMode(this) !== 'ios' || !this.presentingElement || this.enterAnimation || this.leaveAnimation) {
@@ -693,8 +696,26 @@ export class Modal {
      */
     applyFullscreenSafeArea() {
         this.skipSafeAreaCoordinateDetection = true;
+        this.updateFooterPadding();
+        // Watch for dynamic footer additions/removals (e.g., async data loading)
+        if (!this.footerObserver) {
+            this.footerObserver = new MutationObserver(() => this.updateFooterPadding());
+            this.footerObserver.observe(this.el, { childList: true, subtree: true });
+        }
+    }
+    /**
+     * Updates wrapper padding based on footer presence.
+     * Called initially and when footer is dynamically added/removed.
+     */
+    updateFooterPadding() {
+        if (!this.wrapperEl)
+            return;
         const hasFooter = this.el.querySelector('ion-footer') !== null;
-        if (!hasFooter && this.wrapperEl) {
+        if (hasFooter) {
+            this.wrapperEl.style.removeProperty('padding-bottom');
+            this.wrapperEl.style.removeProperty('box-sizing');
+        }
+        else {
             this.wrapperEl.style.setProperty('padding-bottom', 'var(--ion-safe-area-bottom, 0px)');
             this.wrapperEl.style.setProperty('box-sizing', 'border-box');
         }
@@ -712,21 +733,26 @@ export class Modal {
     }
     /**
      * Gets the root safe-area values from the document element.
-     * These represent the actual device safe areas before any overlay overrides.
+     * Uses cached values during gestures to avoid getComputedStyle calls.
      */
-    getRootSafeAreaValues() {
-        const rootStyle = getComputedStyle(document.documentElement);
-        return {
-            top: parseFloat(rootStyle.getPropertyValue('--ion-safe-area-top')) || 0,
-            bottom: parseFloat(rootStyle.getPropertyValue('--ion-safe-area-bottom')) || 0,
-            left: parseFloat(rootStyle.getPropertyValue('--ion-safe-area-left')) || 0,
-            right: parseFloat(rootStyle.getPropertyValue('--ion-safe-area-right')) || 0,
-        };
+    getSafeAreaValues() {
+        if (!this.cachedSafeAreas) {
+            const rootStyle = getComputedStyle(document.documentElement);
+            this.cachedSafeAreas = {
+                top: parseFloat(rootStyle.getPropertyValue('--ion-safe-area-top')) || 0,
+                bottom: parseFloat(rootStyle.getPropertyValue('--ion-safe-area-bottom')) || 0,
+                left: parseFloat(rootStyle.getPropertyValue('--ion-safe-area-left')) || 0,
+                right: parseFloat(rootStyle.getPropertyValue('--ion-safe-area-right')) || 0,
+            };
+        }
+        return this.cachedSafeAreas;
     }
     /**
      * Updates safe-area CSS variable overrides based on whether the modal
      * extends into each safe-area region. Called after animation
      * and during gestures to handle dynamic position changes.
+     *
+     * Optimized to avoid redundant DOM writes by tracking previous state.
      */
     updateSafeAreaOverrides() {
         if (this.skipSafeAreaCoordinateDetection) {
@@ -737,20 +763,34 @@ export class Modal {
             return;
         }
         const rect = wrapper.getBoundingClientRect();
-        const safeAreas = this.getRootSafeAreaValues();
+        const safeAreas = this.getSafeAreaValues();
         const extendsIntoTop = rect.top < safeAreas.top;
         const extendsIntoBottom = rect.bottom > window.innerHeight - safeAreas.bottom;
         const extendsIntoLeft = rect.left < safeAreas.left;
         const extendsIntoRight = rect.right > window.innerWidth - safeAreas.right;
+        // Only update DOM when state actually changes
+        const prev = this.prevSafeAreaState;
         const style = this.el.style;
-        extendsIntoTop ? style.removeProperty('--ion-safe-area-top') : style.setProperty('--ion-safe-area-top', '0px');
-        extendsIntoBottom
-            ? style.removeProperty('--ion-safe-area-bottom')
-            : style.setProperty('--ion-safe-area-bottom', '0px');
-        extendsIntoLeft ? style.removeProperty('--ion-safe-area-left') : style.setProperty('--ion-safe-area-left', '0px');
-        extendsIntoRight
-            ? style.removeProperty('--ion-safe-area-right')
-            : style.setProperty('--ion-safe-area-right', '0px');
+        if (extendsIntoTop !== prev.top) {
+            extendsIntoTop ? style.removeProperty('--ion-safe-area-top') : style.setProperty('--ion-safe-area-top', '0px');
+            prev.top = extendsIntoTop;
+        }
+        if (extendsIntoBottom !== prev.bottom) {
+            extendsIntoBottom
+                ? style.removeProperty('--ion-safe-area-bottom')
+                : style.setProperty('--ion-safe-area-bottom', '0px');
+            prev.bottom = extendsIntoBottom;
+        }
+        if (extendsIntoLeft !== prev.left) {
+            extendsIntoLeft ? style.removeProperty('--ion-safe-area-left') : style.setProperty('--ion-safe-area-left', '0px');
+            prev.left = extendsIntoLeft;
+        }
+        if (extendsIntoRight !== prev.right) {
+            extendsIntoRight
+                ? style.removeProperty('--ion-safe-area-right')
+                : style.setProperty('--ion-safe-area-right', '0px');
+            prev.right = extendsIntoRight;
+        }
     }
     sheetOnDismiss() {
         /**
@@ -782,7 +822,7 @@ export class Modal {
      * For example, `cancel` or `backdrop`.
      */
     async dismiss(data, role) {
-        var _a;
+        var _a, _b;
         if (this.gestureAnimationDismissing && role !== GESTURE) {
             return false;
         }
@@ -844,8 +884,23 @@ export class Modal {
         }
         this.currentBreakpoint = undefined;
         this.animation = undefined;
-        // Reset safe-area detection flag for potential re-presentation
+        // Reset safe-area state for potential re-presentation
         this.skipSafeAreaCoordinateDetection = false;
+        this.cachedSafeAreas = undefined;
+        this.prevSafeAreaState = { top: false, bottom: false, left: false, right: false };
+        (_b = this.footerObserver) === null || _b === void 0 ? void 0 : _b.disconnect();
+        this.footerObserver = undefined;
+        // Clear styles that may have been set for safe-area handling
+        if (this.wrapperEl) {
+            this.wrapperEl.style.removeProperty('padding-bottom');
+            this.wrapperEl.style.removeProperty('box-sizing');
+        }
+        // Clear safe-area CSS variable overrides
+        const style = this.el.style;
+        style.removeProperty('--ion-safe-area-top');
+        style.removeProperty('--ion-safe-area-bottom');
+        style.removeProperty('--ion-safe-area-left');
+        style.removeProperty('--ion-safe-area-right');
         unlock();
         return dismissed;
     }
@@ -1103,20 +1158,20 @@ export class Modal {
         const isCardModal = presentingElement !== undefined && mode === 'ios';
         const isHandleCycle = handleBehavior === 'cycle';
         const isSheetModalWithHandle = isSheetModal && showHandle;
-        return (h(Host, Object.assign({ key: '07ebca6a70eb99f8a2236e1d66a03097a7bb67d8', "no-router": true,
+        return (h(Host, Object.assign({ key: '11cd16cc481093a38a327abdd94467be3f71718d', "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: '1b6850d9b9f6e8f3865b49e0a14399e2ef43a5d6', ref: (el) => (this.backdropEl = el), visible: this.showBackdrop, tappable: this.backdropDismiss, part: "backdrop" }), mode === 'ios' && h("div", { key: 'eab52c0ebccb820781e92392dc6fa90db93525d5', class: "modal-shadow" }), h("div", Object.assign({ key: 'ab9448cabdf03a633319999771ce1ca1edce5699',
+            }, 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: '125658fbb071960da3905854668078e15bce56da', ref: (el) => (this.backdropEl = el), visible: this.showBackdrop, tappable: this.backdropDismiss, part: "backdrop" }), mode === 'ios' && h("div", { key: '4a63815ef165e5806fef85ef48bf509813ff55c9', class: "modal-shadow" }), h("div", Object.assign({ key: 'cfc4b20354cbf2c0f873f6aee91c9b8f553de61d',
             /*
               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: 'b2b8c0a8d8add0d43e928dd3d3519f184551e62b', 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: '33a4ee89bb8b6512883cb8756641c1e27fdb0ebc', 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: 'b994f206765f7b340971d378f00999c0da334102', 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: '986fafb71234591c96e927f92b7330bb5c76fc2e', onSlotchange: this.onSlotChange }))));
     }
     static get is() { return "ion-modal"; }
     static get encapsulation() { return "shadow"; }

package/dist/docs.json

@@ -1,5 +1,5 @@
 {
-  "timestamp": "2026-01-05T21:20:51",
+  "timestamp": "2026-01-07T14:44:35",
   "compiler": {
     "name": "@stencil/core",
     "version": "4.38.0",