@ionic/core 8.7.5-dev.11758311583.14f4e9d9 → 8.7.5-dev.11758642453.13b1da5d

package/components/modal.js

@@ -984,6 +984,11 @@ const createSheetGesture = (baseEl, backdropEl, wrapperEl, initialBreakpoint, ba
     const backdropAnimation = animation.childAnimations.find((ani) => ani.id === 'backdropAnimation');
     const contentAnimation = animation.childAnimations.find((ani) => ani.id === 'contentAnimation');
     const enableBackdrop = () => {
+        // Respect explicit opt-out of focus trapping/backdrop interactions
+        // If focusTrap is false, do not enable the backdrop or re-enable focus trap
+        if (baseEl.focusTrap === false) {
+            return;
+        }
         baseEl.style.setProperty('pointer-events', 'auto');
         backdropEl.style.setProperty('pointer-events', 'auto');
         /**
@@ -1108,7 +1113,8 @@ const createSheetGesture = (baseEl, backdropEl, wrapperEl, initialBreakpoint, ba
          * ion-backdrop and .modal-wrapper always have pointer-events: auto
          * applied, so the modal content can still be interacted with.
          */
-        const shouldEnableBackdrop = currentBreakpoint > backdropBreakpoint;
+        const shouldEnableBackdrop = currentBreakpoint > backdropBreakpoint &&
+            baseEl.focusTrap !== false;
         if (shouldEnableBackdrop) {
             enableBackdrop();
         }
@@ -1416,7 +1422,8 @@ const createSheetGesture = (baseEl, backdropEl, wrapperEl, initialBreakpoint, ba
                              * Backdrop should become enabled
                              * after the backdropBreakpoint value
                              */
-                            const shouldEnableBackdrop = currentBreakpoint > backdropBreakpoint;
+                            const shouldEnableBackdrop = currentBreakpoint > backdropBreakpoint &&
+                                baseEl.focusTrap !== false;
                             if (shouldEnableBackdrop) {
                                 enableBackdrop();
                             }

package/components/overlays.js

@@ -524,9 +524,13 @@ const present = async (overlay, name, iosEnterAnimation, mdEnterAnimation, opts)
      * focus traps.
      *
      * All other overlays should have focus traps to prevent
-     * the keyboard focus from leaving the overlay.
+     * the keyboard focus from leaving the overlay unless
+     * developers explicitly opt out (for example, sheet
+     * modals that should permit background interaction).
      */
-    if (overlay.el.tagName !== 'ION-TOAST') {
+    const overlayEl = overlay.el;
+    const shouldTrapFocus = overlayEl.tagName !== 'ION-TOAST' && overlayEl.focusTrap !== false;
+    if (shouldTrapFocus) {
         setRootAriaHidden(true);
         document.body.classList.add(BACKDROP_NO_SCROLL);
     }
@@ -628,20 +632,21 @@ const dismiss = async (overlay, data, role, name, iosLeaveAnimation, mdLeaveAnim
      * For accessibility, toasts lack focus traps and don't receive
      * `aria-hidden` on the root element when presented.
      *
-     * All other overlays use focus traps to keep keyboard focus
-     * within the overlay, setting `aria-hidden` on the root element
-     * to enhance accessibility.
-     *
-     * Therefore, we must remove `aria-hidden` from the root element
-     * when the last non-toast overlay is dismissed.
+     * Overlays that opt into focus trapping set `aria-hidden`
+     * on the root element to keep keyboard focus and pointer
+     * events inside the overlay. We must remove `aria-hidden`
+     * from the root element when the last focus-trapping overlay
+     * is dismissed.
      */
-    const overlaysNotToast = presentedOverlays.filter((o) => o.tagName !== 'ION-TOAST');
-    const lastOverlayNotToast = overlaysNotToast.length === 1 && overlaysNotToast[0].id === overlay.el.id;
+    const overlaysTrappingFocus = presentedOverlays.filter((o) => o.tagName !== 'ION-TOAST' && o.focusTrap !== false);
+    const overlayEl = overlay.el;
+    const trapsFocus = overlayEl.tagName !== 'ION-TOAST' && overlayEl.focusTrap !== false;
     /**
-     * If this is the last visible overlay that is not a toast
+     * If this is the last visible overlay that is trapping focus
      * then we want to re-add the root to the accessibility tree.
      */
-    if (lastOverlayNotToast) {
+    const lastOverlayTrappingFocus = trapsFocus && overlaysTrappingFocus.length === 1 && overlaysTrappingFocus[0].id === overlayEl.id;
+    if (lastOverlayTrappingFocus) {
         setRootAriaHidden(false);
         document.body.classList.remove(BACKDROP_NO_SCROLL);
     }

package/dist/cjs/index.cjs.js

@@ -15,7 +15,7 @@ var index$2 = require('./index-DNh170BW.js');
 var config = require('./config-CKhELRRu.js');
 var theme = require('./theme-CeDs6Hcv.js');
 var index$3 = require('./index-D24wggHR.js');
-var overlays = require('./overlays-v_jc1Hok.js');
+var overlays = require('./overlays-CPUTc8An.js');
 require('./index-DkNv4J_i.js');
 require('./gesture-controller-dtqlP_q4.js');
 require('./hardware-back-button-BxdNu76F.js');

package/dist/cjs/ion-action-sheet.cjs.entry.js

@@ -7,7 +7,7 @@ var index = require('./index-DNh170BW.js');
 var buttonActive = require('./button-active-BzZenWWH.js');
 var helpers = require('./helpers-DgwmcYAu.js');
 var lockController = require('./lock-controller-aDB9wrEf.js');
-var overlays = require('./overlays-v_jc1Hok.js');
+var overlays = require('./overlays-CPUTc8An.js');
 var theme = require('./theme-CeDs6Hcv.js');
 var ionicGlobal = require('./ionic-global-UI5YPSi-.js');
 var animation = require('./animation-ZJ1lAkZD.js');

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

@@ -8,7 +8,7 @@ var config = require('./config-CKhELRRu.js');
 var buttonActive = require('./button-active-BzZenWWH.js');
 var helpers = require('./helpers-DgwmcYAu.js');
 var lockController = require('./lock-controller-aDB9wrEf.js');
-var overlays = require('./overlays-v_jc1Hok.js');
+var overlays = require('./overlays-CPUTc8An.js');
 var theme = require('./theme-CeDs6Hcv.js');
 var ionicGlobal = require('./ionic-global-UI5YPSi-.js');
 var animation = require('./animation-ZJ1lAkZD.js');

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

@@ -6,7 +6,7 @@
 var index = require('./index-DNh170BW.js');
 var focusVisible = require('./focus-visible-CCvKiLh3.js');
 var helpers = require('./helpers-DgwmcYAu.js');
-var overlays = require('./overlays-v_jc1Hok.js');
+var overlays = require('./overlays-CPUTc8An.js');
 var dir = require('./dir-Cn0z1rJH.js');
 var theme = require('./theme-CeDs6Hcv.js');
 var index$1 = require('./index-DqmRDbxg.js');

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

@@ -7,7 +7,7 @@ var index = require('./index-DNh170BW.js');
 var config = require('./config-CKhELRRu.js');
 var helpers = require('./helpers-DgwmcYAu.js');
 var lockController = require('./lock-controller-aDB9wrEf.js');
-var overlays = require('./overlays-v_jc1Hok.js');
+var overlays = require('./overlays-CPUTc8An.js');
 var theme = require('./theme-CeDs6Hcv.js');
 var ionicGlobal = require('./ionic-global-UI5YPSi-.js');
 var animation = require('./animation-ZJ1lAkZD.js');

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

@@ -5,7 +5,7 @@
 
 var index = require('./index-DNh170BW.js');
 var cubicBezier = require('./cubic-bezier-DAjy1V-e.js');
-var overlays = require('./overlays-v_jc1Hok.js');
+var overlays = require('./overlays-CPUTc8An.js');
 var gestureController = require('./gesture-controller-dtqlP_q4.js');
 var hardwareBackButton = require('./hardware-back-button-BxdNu76F.js');
 var helpers = require('./helpers-DgwmcYAu.js');

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

@@ -9,7 +9,7 @@ var frameworkDelegate = require('./framework-delegate-WkyjrnCx.js');
 var helpers = require('./helpers-DgwmcYAu.js');
 var lockController = require('./lock-controller-aDB9wrEf.js');
 var capacitor = require('./capacitor-DmA66EwP.js');
-var overlays = require('./overlays-v_jc1Hok.js');
+var overlays = require('./overlays-CPUTc8An.js');
 var theme = require('./theme-CeDs6Hcv.js');
 var index$4 = require('./index-BzEyuIww.js');
 var ionicGlobal = require('./ionic-global-UI5YPSi-.js');
@@ -987,6 +987,11 @@ const createSheetGesture = (baseEl, backdropEl, wrapperEl, initialBreakpoint, ba
     const backdropAnimation = animation.childAnimations.find((ani) => ani.id === 'backdropAnimation');
     const contentAnimation = animation.childAnimations.find((ani) => ani.id === 'contentAnimation');
     const enableBackdrop = () => {
+        // Respect explicit opt-out of focus trapping/backdrop interactions
+        // If focusTrap is false, do not enable the backdrop or re-enable focus trap
+        if (baseEl.focusTrap === false) {
+            return;
+        }
         baseEl.style.setProperty('pointer-events', 'auto');
         backdropEl.style.setProperty('pointer-events', 'auto');
         /**
@@ -1111,7 +1116,8 @@ const createSheetGesture = (baseEl, backdropEl, wrapperEl, initialBreakpoint, ba
          * ion-backdrop and .modal-wrapper always have pointer-events: auto
          * applied, so the modal content can still be interacted with.
          */
-        const shouldEnableBackdrop = currentBreakpoint > backdropBreakpoint;
+        const shouldEnableBackdrop = currentBreakpoint > backdropBreakpoint &&
+            baseEl.focusTrap !== false;
         if (shouldEnableBackdrop) {
             enableBackdrop();
         }
@@ -1419,7 +1425,8 @@ const createSheetGesture = (baseEl, backdropEl, wrapperEl, initialBreakpoint, ba
                              * Backdrop should become enabled
                              * after the backdropBreakpoint value
                              */
-                            const shouldEnableBackdrop = currentBreakpoint > backdropBreakpoint;
+                            const shouldEnableBackdrop = currentBreakpoint > backdropBreakpoint &&
+                                baseEl.focusTrap !== false;
                             if (shouldEnableBackdrop) {
                                 enableBackdrop();
                             }

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

@@ -4,7 +4,7 @@
 'use strict';
 
 var index = require('./index-DNh170BW.js');
-var overlays = require('./overlays-v_jc1Hok.js');
+var overlays = require('./overlays-CPUTc8An.js');
 var frameworkDelegate = require('./framework-delegate-WkyjrnCx.js');
 var helpers = require('./helpers-DgwmcYAu.js');
 var lockController = require('./lock-controller-aDB9wrEf.js');

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

@@ -5,7 +5,7 @@
 
 var index = require('./index-DNh170BW.js');
 var ionicGlobal = require('./ionic-global-UI5YPSi-.js');
-var overlays = require('./overlays-v_jc1Hok.js');
+var overlays = require('./overlays-CPUTc8An.js');
 var theme = require('./theme-CeDs6Hcv.js');
 require('./index-DkNv4J_i.js');
 require('./helpers-DgwmcYAu.js');

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

@@ -7,7 +7,7 @@ var index = require('./index-DNh170BW.js');
 var notchController = require('./notch-controller-Bf5Rr4R5.js');
 var compareWithUtils = require('./compare-with-utils-DSicavqM.js');
 var helpers = require('./helpers-DgwmcYAu.js');
-var overlays = require('./overlays-v_jc1Hok.js');
+var overlays = require('./overlays-CPUTc8An.js');
 var dir = require('./dir-Cn0z1rJH.js');
 var theme = require('./theme-CeDs6Hcv.js');
 var watchOptions = require('./watch-options-CviOsrTS.js');

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

@@ -7,7 +7,7 @@ var index$1 = require('./index-DNh170BW.js');
 var config = require('./config-CKhELRRu.js');
 var helpers = require('./helpers-DgwmcYAu.js');
 var lockController = require('./lock-controller-aDB9wrEf.js');
-var overlays = require('./overlays-v_jc1Hok.js');
+var overlays = require('./overlays-CPUTc8An.js');
 var theme = require('./theme-CeDs6Hcv.js');
 var ionicGlobal = require('./ionic-global-UI5YPSi-.js');
 var animation = require('./animation-ZJ1lAkZD.js');

package/dist/cjs/{overlays-v_jc1Hok.js → overlays-CPUTc8An.js}

@@ -526,9 +526,13 @@ const present = async (overlay, name, iosEnterAnimation, mdEnterAnimation, opts)
      * focus traps.
      *
      * All other overlays should have focus traps to prevent
-     * the keyboard focus from leaving the overlay.
+     * the keyboard focus from leaving the overlay unless
+     * developers explicitly opt out (for example, sheet
+     * modals that should permit background interaction).
      */
-    if (overlay.el.tagName !== 'ION-TOAST') {
+    const overlayEl = overlay.el;
+    const shouldTrapFocus = overlayEl.tagName !== 'ION-TOAST' && overlayEl.focusTrap !== false;
+    if (shouldTrapFocus) {
         setRootAriaHidden(true);
         document.body.classList.add(gestureController.BACKDROP_NO_SCROLL);
     }
@@ -630,20 +634,21 @@ const dismiss = async (overlay, data, role, name, iosLeaveAnimation, mdLeaveAnim
      * For accessibility, toasts lack focus traps and don't receive
      * `aria-hidden` on the root element when presented.
      *
-     * All other overlays use focus traps to keep keyboard focus
-     * within the overlay, setting `aria-hidden` on the root element
-     * to enhance accessibility.
-     *
-     * Therefore, we must remove `aria-hidden` from the root element
-     * when the last non-toast overlay is dismissed.
+     * Overlays that opt into focus trapping set `aria-hidden`
+     * on the root element to keep keyboard focus and pointer
+     * events inside the overlay. We must remove `aria-hidden`
+     * from the root element when the last focus-trapping overlay
+     * is dismissed.
      */
-    const overlaysNotToast = presentedOverlays.filter((o) => o.tagName !== 'ION-TOAST');
-    const lastOverlayNotToast = overlaysNotToast.length === 1 && overlaysNotToast[0].id === overlay.el.id;
+    const overlaysTrappingFocus = presentedOverlays.filter((o) => o.tagName !== 'ION-TOAST' && o.focusTrap !== false);
+    const overlayEl = overlay.el;
+    const trapsFocus = overlayEl.tagName !== 'ION-TOAST' && overlayEl.focusTrap !== false;
     /**
-     * If this is the last visible overlay that is not a toast
+     * If this is the last visible overlay that is trapping focus
      * then we want to re-add the root to the accessibility tree.
      */
-    if (lastOverlayNotToast) {
+    const lastOverlayTrappingFocus = trapsFocus && overlaysTrappingFocus.length === 1 && overlaysTrappingFocus[0].id === overlayEl.id;
+    if (lastOverlayTrappingFocus) {
         setRootAriaHidden(false);
         document.body.classList.remove(gestureController.BACKDROP_NO_SCROLL);
     }

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

@@ -45,6 +45,11 @@ export const createSheetGesture = (baseEl, backdropEl, wrapperEl, initialBreakpo
     const backdropAnimation = animation.childAnimations.find((ani) => ani.id === 'backdropAnimation');
     const contentAnimation = animation.childAnimations.find((ani) => ani.id === 'contentAnimation');
     const enableBackdrop = () => {
+        // Respect explicit opt-out of focus trapping/backdrop interactions
+        // If focusTrap is false, do not enable the backdrop or re-enable focus trap
+        if (baseEl.focusTrap === false) {
+            return;
+        }
         baseEl.style.setProperty('pointer-events', 'auto');
         backdropEl.style.setProperty('pointer-events', 'auto');
         /**
@@ -169,7 +174,8 @@ export const createSheetGesture = (baseEl, backdropEl, wrapperEl, initialBreakpo
          * ion-backdrop and .modal-wrapper always have pointer-events: auto
          * applied, so the modal content can still be interacted with.
          */
-        const shouldEnableBackdrop = currentBreakpoint > backdropBreakpoint;
+        const shouldEnableBackdrop = currentBreakpoint > backdropBreakpoint &&
+            baseEl.focusTrap !== false;
         if (shouldEnableBackdrop) {
             enableBackdrop();
         }
@@ -477,7 +483,8 @@ export const createSheetGesture = (baseEl, backdropEl, wrapperEl, initialBreakpo
                              * Backdrop should become enabled
                              * after the backdropBreakpoint value
                              */
-                            const shouldEnableBackdrop = currentBreakpoint > backdropBreakpoint;
+                            const shouldEnableBackdrop = currentBreakpoint > backdropBreakpoint &&
+                                baseEl.focusTrap !== false;
                             if (shouldEnableBackdrop) {
                                 enableBackdrop();
                             }

package/dist/collection/utils/overlays.js

@@ -445,9 +445,13 @@ export const present = async (overlay, name, iosEnterAnimation, mdEnterAnimation
      * focus traps.
      *
      * All other overlays should have focus traps to prevent
-     * the keyboard focus from leaving the overlay.
+     * the keyboard focus from leaving the overlay unless
+     * developers explicitly opt out (for example, sheet
+     * modals that should permit background interaction).
      */
-    if (overlay.el.tagName !== 'ION-TOAST') {
+    const overlayEl = overlay.el;
+    const shouldTrapFocus = overlayEl.tagName !== 'ION-TOAST' && overlayEl.focusTrap !== false;
+    if (shouldTrapFocus) {
         setRootAriaHidden(true);
         document.body.classList.add(BACKDROP_NO_SCROLL);
     }
@@ -549,20 +553,21 @@ export const dismiss = async (overlay, data, role, name, iosLeaveAnimation, mdLe
      * For accessibility, toasts lack focus traps and don't receive
      * `aria-hidden` on the root element when presented.
      *
-     * All other overlays use focus traps to keep keyboard focus
-     * within the overlay, setting `aria-hidden` on the root element
-     * to enhance accessibility.
-     *
-     * Therefore, we must remove `aria-hidden` from the root element
-     * when the last non-toast overlay is dismissed.
+     * Overlays that opt into focus trapping set `aria-hidden`
+     * on the root element to keep keyboard focus and pointer
+     * events inside the overlay. We must remove `aria-hidden`
+     * from the root element when the last focus-trapping overlay
+     * is dismissed.
      */
-    const overlaysNotToast = presentedOverlays.filter((o) => o.tagName !== 'ION-TOAST');
-    const lastOverlayNotToast = overlaysNotToast.length === 1 && overlaysNotToast[0].id === overlay.el.id;
+    const overlaysTrappingFocus = presentedOverlays.filter((o) => o.tagName !== 'ION-TOAST' && o.focusTrap !== false);
+    const overlayEl = overlay.el;
+    const trapsFocus = overlayEl.tagName !== 'ION-TOAST' && overlayEl.focusTrap !== false;
     /**
-     * If this is the last visible overlay that is not a toast
+     * If this is the last visible overlay that is trapping focus
      * then we want to re-add the root to the accessibility tree.
      */
-    if (lastOverlayNotToast) {
+    const lastOverlayTrappingFocus = trapsFocus && overlaysTrappingFocus.length === 1 && overlaysTrappingFocus[0].id === overlayEl.id;
+    if (lastOverlayTrappingFocus) {
         setRootAriaHidden(false);
         document.body.classList.remove(BACKDROP_NO_SCROLL);
     }

package/dist/docs.json

@@ -1,5 +1,5 @@
 {
-  "timestamp": "2025-09-19T19:55:00",
+  "timestamp": "2025-09-23T15:49:23",
   "compiler": {
     "name": "@stencil/core",
     "version": "4.36.2",

package/dist/esm/index.js

@@ -13,7 +13,7 @@ export { L as LogLevel } from './index-4DxY6_gG.js';
 export { I as IonicSafeString, g as getMode, s as setupConfig } from './config-Dx_6wPIJ.js';
 export { o as openURL } from './theme-DiVJyqlX.js';
 export { m as menuController } from './index-CXSTcaAW.js';
-export { b as actionSheetController, a as alertController, l as loadingController, m as modalController, p as pickerController, c as popoverController, t as toastController } from './overlays-BJaRj3Rj.js';
+export { b as actionSheetController, a as alertController, l as loadingController, m as modalController, p as pickerController, c as popoverController, t as toastController } from './overlays-BOalOTUe.js';
 import './index-ZjP4CjeZ.js';
 import './gesture-controller-BTEOs1at.js';
 import './hardware-back-button-Dhbd-23H.js';

package/dist/esm/ion-action-sheet.entry.js

@@ -5,7 +5,7 @@ import { r as registerInstance, c as createEvent, a as readTask, h, d as Host, g
 import { c as createButtonActiveGesture } from './button-active-DBUPuLNw.js';
 import { r as raf } from './helpers-8KSQQGQy.js';
 import { c as createLockController } from './lock-controller-B-hirT0v.js';
-import { d as createDelegateController, e as createTriggerController, B as BACKDROP, i as isCancel, f as present, g as dismiss, h as eventMethod, s as safeCall, j as prepareOverlay, k as setOverlayId } from './overlays-BJaRj3Rj.js';
+import { d as createDelegateController, e as createTriggerController, B as BACKDROP, i as isCancel, f as present, g as dismiss, h as eventMethod, s as safeCall, j as prepareOverlay, k as setOverlayId } from './overlays-BOalOTUe.js';
 import { g as getClassMap } from './theme-DiVJyqlX.js';
 import { b as getIonMode } from './ionic-global-CTSyufhF.js';
 import { c as createAnimation } from './animation-BvhAtgca.js';

package/dist/esm/ion-alert.entry.js

@@ -6,7 +6,7 @@ import { E as ENABLE_HTML_CONTENT_DEFAULT, a as sanitizeDOMString } from './conf
 import { c as createButtonActiveGesture } from './button-active-DBUPuLNw.js';
 import { r as raf } from './helpers-8KSQQGQy.js';
 import { c as createLockController } from './lock-controller-B-hirT0v.js';
-import { d as createDelegateController, e as createTriggerController, B as BACKDROP, i as isCancel, j as prepareOverlay, k as setOverlayId, f as present, g as dismiss, h as eventMethod, s as safeCall } from './overlays-BJaRj3Rj.js';
+import { d as createDelegateController, e as createTriggerController, B as BACKDROP, i as isCancel, j as prepareOverlay, k as setOverlayId, f as present, g as dismiss, h as eventMethod, s as safeCall } from './overlays-BOalOTUe.js';
 import { g as getClassMap } from './theme-DiVJyqlX.js';
 import { b as getIonMode } from './ionic-global-CTSyufhF.js';
 import { c as createAnimation } from './animation-BvhAtgca.js';

package/dist/esm/ion-datetime_3.entry.js

@@ -4,7 +4,7 @@
 import { j as printIonError, f as printIonWarning, r as registerInstance, c as createEvent, w as writeTask, h, d as Host, g as getElement } from './index-4DxY6_gG.js';
 import { startFocusVisible } from './focus-visible-BmVRXR1y.js';
 import { r as raf, g as getElementRoot, a as renderHiddenInput, e as clamp } from './helpers-8KSQQGQy.js';
-import { F as FOCUS_TRAP_DISABLE_CLASS, d as createDelegateController, e as createTriggerController, B as BACKDROP, i as isCancel, j as prepareOverlay, k as setOverlayId, f as present, g as dismiss, h as eventMethod, s as safeCall } from './overlays-BJaRj3Rj.js';
+import { F as FOCUS_TRAP_DISABLE_CLASS, d as createDelegateController, e as createTriggerController, B as BACKDROP, i as isCancel, j as prepareOverlay, k as setOverlayId, f as present, g as dismiss, h as eventMethod, s as safeCall } from './overlays-BOalOTUe.js';
 import { i as isRTL } from './dir-C53feagD.js';
 import { c as createColorClasses, g as getClassMap } from './theme-DiVJyqlX.js';
 import { l as chevronDown, o as caretUpSharp, p as chevronForward, q as caretDownSharp, c as chevronBack } from './index-DV3sJJW8.js';

package/dist/esm/ion-loading.entry.js

@@ -5,7 +5,7 @@ import { r as registerInstance, c as createEvent, e as config, h, d as Host, g a
 import { E as ENABLE_HTML_CONTENT_DEFAULT, a as sanitizeDOMString } from './config-Dx_6wPIJ.js';
 import { r as raf } from './helpers-8KSQQGQy.js';
 import { c as createLockController } from './lock-controller-B-hirT0v.js';
-import { d as createDelegateController, e as createTriggerController, B as BACKDROP, j as prepareOverlay, k as setOverlayId, f as present, g as dismiss, h as eventMethod } from './overlays-BJaRj3Rj.js';
+import { d as createDelegateController, e as createTriggerController, B as BACKDROP, j as prepareOverlay, k as setOverlayId, f as present, g as dismiss, h as eventMethod } from './overlays-BOalOTUe.js';
 import { g as getClassMap } from './theme-DiVJyqlX.js';
 import { b as getIonMode } from './ionic-global-CTSyufhF.js';
 import { c as createAnimation } from './animation-BvhAtgca.js';

package/dist/esm/ion-menu_3.entry.js

@@ -3,7 +3,7 @@
  */
 import { r as registerInstance, c as createEvent, e as config, j as printIonError, h, d as Host, g as getElement } from './index-4DxY6_gG.js';
 import { g as getTimeGivenProgression } from './cubic-bezier-hHmYLOfE.js';
-import { o as getPresentedOverlay, B as BACKDROP, n as focusFirstDescendant, q as focusLastDescendant, G as GESTURE } from './overlays-BJaRj3Rj.js';
+import { o as getPresentedOverlay, B as BACKDROP, n as focusFirstDescendant, q as focusLastDescendant, G as GESTURE } from './overlays-BOalOTUe.js';
 import { G as GESTURE_CONTROLLER } from './gesture-controller-BTEOs1at.js';
 import { shouldUseCloseWatcher } from './hardware-back-button-Dhbd-23H.js';
 import { o as isEndSide, i as inheritAriaAttributes, l as assert, e as clamp } from './helpers-8KSQQGQy.js';

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

@@ -7,7 +7,7 @@ import { C as CoreDelegate, a as attachComponent, d as detachComponent } from '.
 import { e as clamp, g as getElementRoot, r as raf, b as inheritAttributes, h as hasLazyBuild } from './helpers-8KSQQGQy.js';
 import { c as createLockController } from './lock-controller-B-hirT0v.js';
 import { g as getCapacitor } from './capacitor-CFERIeaU.js';
-import { G as GESTURE, O as OVERLAY_GESTURE_PRIORITY, F as FOCUS_TRAP_DISABLE_CLASS, e as createTriggerController, B as BACKDROP, j as prepareOverlay, k as setOverlayId, f as present, g as dismiss, h as eventMethod } from './overlays-BJaRj3Rj.js';
+import { G as GESTURE, O as OVERLAY_GESTURE_PRIORITY, F as FOCUS_TRAP_DISABLE_CLASS, e as createTriggerController, B as BACKDROP, j as prepareOverlay, k as setOverlayId, f as present, g as dismiss, h as eventMethod } from './overlays-BOalOTUe.js';
 import { g as getClassMap } from './theme-DiVJyqlX.js';
 import { e as deepReady, w as waitForMount } from './index-Dp7GXH1z.js';
 import { b as getIonMode } from './ionic-global-CTSyufhF.js';
@@ -985,6 +985,11 @@ const createSheetGesture = (baseEl, backdropEl, wrapperEl, initialBreakpoint, ba
     const backdropAnimation = animation.childAnimations.find((ani) => ani.id === 'backdropAnimation');
     const contentAnimation = animation.childAnimations.find((ani) => ani.id === 'contentAnimation');
     const enableBackdrop = () => {
+        // Respect explicit opt-out of focus trapping/backdrop interactions
+        // If focusTrap is false, do not enable the backdrop or re-enable focus trap
+        if (baseEl.focusTrap === false) {
+            return;
+        }
         baseEl.style.setProperty('pointer-events', 'auto');
         backdropEl.style.setProperty('pointer-events', 'auto');
         /**
@@ -1109,7 +1114,8 @@ const createSheetGesture = (baseEl, backdropEl, wrapperEl, initialBreakpoint, ba
          * ion-backdrop and .modal-wrapper always have pointer-events: auto
          * applied, so the modal content can still be interacted with.
          */
-        const shouldEnableBackdrop = currentBreakpoint > backdropBreakpoint;
+        const shouldEnableBackdrop = currentBreakpoint > backdropBreakpoint &&
+            baseEl.focusTrap !== false;
         if (shouldEnableBackdrop) {
             enableBackdrop();
         }
@@ -1417,7 +1423,8 @@ const createSheetGesture = (baseEl, backdropEl, wrapperEl, initialBreakpoint, ba
                              * Backdrop should become enabled
                              * after the backdropBreakpoint value
                              */
-                            const shouldEnableBackdrop = currentBreakpoint > backdropBreakpoint;
+                            const shouldEnableBackdrop = currentBreakpoint > backdropBreakpoint &&
+                                baseEl.focusTrap !== false;
                             if (shouldEnableBackdrop) {
                                 enableBackdrop();
                             }

package/dist/esm/ion-popover.entry.js

@@ -2,7 +2,7 @@
  * (C) Ionic http://ionicframework.com - MIT License
  */
 import { r as registerInstance, c as createEvent, f as printIonWarning, h, d as Host, g as getElement } from './index-4DxY6_gG.js';
-import { B as BACKDROP, j as prepareOverlay, k as setOverlayId, f as present, n as focusFirstDescendant, g as dismiss, h as eventMethod, F as FOCUS_TRAP_DISABLE_CLASS } from './overlays-BJaRj3Rj.js';
+import { B as BACKDROP, j as prepareOverlay, k as setOverlayId, f as present, n as focusFirstDescendant, g as dismiss, h as eventMethod, F as FOCUS_TRAP_DISABLE_CLASS } from './overlays-BOalOTUe.js';
 import { C as CoreDelegate, a as attachComponent, d as detachComponent } from './framework-delegate-BLEBgH06.js';
 import { g as getElementRoot, r as raf, f as addEventListener, h as hasLazyBuild } from './helpers-8KSQQGQy.js';
 import { c as createLockController } from './lock-controller-B-hirT0v.js';

package/dist/esm/ion-select-modal.entry.js

@@ -3,7 +3,7 @@
  */
 import { r as registerInstance, h, i as forceUpdate, d as Host, g as getElement } from './index-4DxY6_gG.js';
 import { b as getIonMode } from './ionic-global-CTSyufhF.js';
-import { s as safeCall } from './overlays-BJaRj3Rj.js';
+import { s as safeCall } from './overlays-BOalOTUe.js';
 import { g as getClassMap } from './theme-DiVJyqlX.js';
 import './index-ZjP4CjeZ.js';
 import './helpers-8KSQQGQy.js';

package/dist/esm/ion-select_3.entry.js

@@ -5,7 +5,7 @@ import { r as registerInstance, c as createEvent, f as printIonWarning, h, d as
 import { c as createNotchController } from './notch-controller-lb417-kU.js';
 import { i as isOptionSelected, c as compareOptions } from './compare-with-utils-sObYyvOy.js';
 import { b as inheritAttributes, a as renderHiddenInput, n as focusVisibleElement } from './helpers-8KSQQGQy.js';
-import { c as popoverController, b as actionSheetController, a as alertController, m as modalController, s as safeCall } from './overlays-BJaRj3Rj.js';
+import { c as popoverController, b as actionSheetController, a as alertController, m as modalController, s as safeCall } from './overlays-BOalOTUe.js';
 import { i as isRTL } from './dir-C53feagD.js';
 import { h as hostContext, c as createColorClasses, g as getClassMap } from './theme-DiVJyqlX.js';
 import { w as watchForOptions } from './watch-options-Dtdm8lKC.js';

package/dist/esm/ion-toast.entry.js

@@ -5,7 +5,7 @@ import { f as printIonWarning, r as registerInstance, c as createEvent, e as con
 import { E as ENABLE_HTML_CONTENT_DEFAULT, a as sanitizeDOMString } from './config-Dx_6wPIJ.js';
 import { g as getElementRoot, r as raf } from './helpers-8KSQQGQy.js';
 import { c as createLockController } from './lock-controller-B-hirT0v.js';
-import { O as OVERLAY_GESTURE_PRIORITY, d as createDelegateController, e as createTriggerController, i as isCancel, j as prepareOverlay, k as setOverlayId, f as present, g as dismiss, h as eventMethod, s as safeCall, G as GESTURE } from './overlays-BJaRj3Rj.js';
+import { O as OVERLAY_GESTURE_PRIORITY, d as createDelegateController, e as createTriggerController, i as isCancel, j as prepareOverlay, k as setOverlayId, f as present, g as dismiss, h as eventMethod, s as safeCall, G as GESTURE } from './overlays-BOalOTUe.js';
 import { c as createColorClasses, g as getClassMap } from './theme-DiVJyqlX.js';
 import { b as getIonMode } from './ionic-global-CTSyufhF.js';
 import { c as createAnimation } from './animation-BvhAtgca.js';

package/dist/esm/{overlays-BJaRj3Rj.js → overlays-BOalOTUe.js}

@@ -524,9 +524,13 @@ const present = async (overlay, name, iosEnterAnimation, mdEnterAnimation, opts)
      * focus traps.
      *
      * All other overlays should have focus traps to prevent
-     * the keyboard focus from leaving the overlay.
+     * the keyboard focus from leaving the overlay unless
+     * developers explicitly opt out (for example, sheet
+     * modals that should permit background interaction).
      */
-    if (overlay.el.tagName !== 'ION-TOAST') {
+    const overlayEl = overlay.el;
+    const shouldTrapFocus = overlayEl.tagName !== 'ION-TOAST' && overlayEl.focusTrap !== false;
+    if (shouldTrapFocus) {
         setRootAriaHidden(true);
         document.body.classList.add(BACKDROP_NO_SCROLL);
     }
@@ -628,20 +632,21 @@ const dismiss = async (overlay, data, role, name, iosLeaveAnimation, mdLeaveAnim
      * For accessibility, toasts lack focus traps and don't receive
      * `aria-hidden` on the root element when presented.
      *
-     * All other overlays use focus traps to keep keyboard focus
-     * within the overlay, setting `aria-hidden` on the root element
-     * to enhance accessibility.
-     *
-     * Therefore, we must remove `aria-hidden` from the root element
-     * when the last non-toast overlay is dismissed.
+     * Overlays that opt into focus trapping set `aria-hidden`
+     * on the root element to keep keyboard focus and pointer
+     * events inside the overlay. We must remove `aria-hidden`
+     * from the root element when the last focus-trapping overlay
+     * is dismissed.
      */
-    const overlaysNotToast = presentedOverlays.filter((o) => o.tagName !== 'ION-TOAST');
-    const lastOverlayNotToast = overlaysNotToast.length === 1 && overlaysNotToast[0].id === overlay.el.id;
+    const overlaysTrappingFocus = presentedOverlays.filter((o) => o.tagName !== 'ION-TOAST' && o.focusTrap !== false);
+    const overlayEl = overlay.el;
+    const trapsFocus = overlayEl.tagName !== 'ION-TOAST' && overlayEl.focusTrap !== false;
     /**
-     * If this is the last visible overlay that is not a toast
+     * If this is the last visible overlay that is trapping focus
      * then we want to re-add the root to the accessibility tree.
      */
-    if (lastOverlayNotToast) {
+    const lastOverlayTrappingFocus = trapsFocus && overlaysTrappingFocus.length === 1 && overlaysTrappingFocus[0].id === overlayEl.id;
+    if (lastOverlayTrappingFocus) {
         setRootAriaHidden(false);
         document.body.classList.remove(BACKDROP_NO_SCROLL);
     }

package/dist/ionic/index.esm.js

@@ -1,4 +1,4 @@
 /*!
  * (C) Ionic http://ionicframework.com - MIT License
  */
-export{c as createAnimation}from"./p-C87oPMMF.js";export{a as LIFECYCLE_DID_ENTER,c as LIFECYCLE_DID_LEAVE,L as LIFECYCLE_WILL_ENTER,b as LIFECYCLE_WILL_LEAVE,d as LIFECYCLE_WILL_UNLOAD,g as getIonPageElement}from"./p-DCuOL88l.js";export{iosTransitionAnimation}from"./p-BB-JoKGB.js";export{mdTransitionAnimation}from"./p-LaGjiAVo.js";export{g as getTimeGivenProgression}from"./p-hHmYLOfE.js";export{createGesture}from"./p-Cl0B-RWe.js";export{g as getPlatforms,i as initialize,a as isPlatform}from"./p-Br3vSlYh.js";export{c as componentOnReady}from"./p-C-Cct-6D.js";export{L as LogLevel}from"./p-4DxY6_gG.js";export{I as IonicSafeString,g as getMode,s as setupConfig}from"./p-EnaLTYYj.js";export{o as openURL}from"./p-DiVJyqlX.js";export{m as menuController}from"./p-C8d2ebIg.js";export{b as actionSheetController,a as alertController,l as loadingController,m as modalController,p as pickerController,c as popoverController,t as toastController}from"./p-CoDfkBuk.js";import"./p-ZjP4CjeZ.js";import"./p-BTEOs1at.js";import"./p-CvaZMP6T.js";import"./p-DAfH9Iif.js";const e=e=>{const{swiper:o,extendParams:t}=e,s={effect:void 0,direction:"horizontal",initialSlide:0,loop:!1,parallax:!1,slidesPerView:1,spaceBetween:0,speed:300,slidesPerColumn:1,slidesPerColumnFill:"column",slidesPerGroup:1,centeredSlides:!1,slidesOffsetBefore:0,slidesOffsetAfter:0,touchEventsTarget:"container",freeMode:!1,freeModeMomentum:!0,freeModeMomentumRatio:1,freeModeMomentumBounce:!0,freeModeMomentumBounceRatio:1,freeModeMomentumVelocityRatio:1,freeModeSticky:!1,freeModeMinimumVelocity:.02,autoHeight:!1,setWrapperSize:!1,zoom:{maxRatio:3,minRatio:1,toggle:!1},touchRatio:1,touchAngle:45,simulateTouch:!0,touchStartPreventDefault:!1,shortSwipes:!0,longSwipes:!0,longSwipesRatio:.5,longSwipesMs:300,followFinger:!0,threshold:0,touchMoveStopPropagation:!0,touchReleaseOnEdges:!1,iOSEdgeSwipeDetection:!1,iOSEdgeSwipeThreshold:20,resistance:!0,resistanceRatio:.85,watchSlidesProgress:!1,watchSlidesVisibility:!1,preventClicks:!0,preventClicksPropagation:!0,slideToClickedSlide:!1,loopAdditionalSlides:0,noSwiping:!0,runCallbacksOnInit:!0,coverflowEffect:{rotate:50,stretch:0,depth:100,modifier:1,slideShadows:!0},flipEffect:{slideShadows:!0,limitRotation:!0},cubeEffect:{slideShadows:!0,shadow:!0,shadowOffset:20,shadowScale:.94},fadeEffect:{crossFade:!1},a11y:{prevSlideMessage:"Previous slide",nextSlideMessage:"Next slide",firstSlideMessage:"This is the first slide",lastSlideMessage:"This is the last slide"}};o.pagination&&(s.pagination={type:"bullets",clickable:!1,hideOnClick:!1}),o.scrollbar&&(s.scrollbar={hide:!0}),t(s)};export{e as IonicSlides}
+export{c as createAnimation}from"./p-C87oPMMF.js";export{a as LIFECYCLE_DID_ENTER,c as LIFECYCLE_DID_LEAVE,L as LIFECYCLE_WILL_ENTER,b as LIFECYCLE_WILL_LEAVE,d as LIFECYCLE_WILL_UNLOAD,g as getIonPageElement}from"./p-DCuOL88l.js";export{iosTransitionAnimation}from"./p-BB-JoKGB.js";export{mdTransitionAnimation}from"./p-LaGjiAVo.js";export{g as getTimeGivenProgression}from"./p-hHmYLOfE.js";export{createGesture}from"./p-Cl0B-RWe.js";export{g as getPlatforms,i as initialize,a as isPlatform}from"./p-Br3vSlYh.js";export{c as componentOnReady}from"./p-C-Cct-6D.js";export{L as LogLevel}from"./p-4DxY6_gG.js";export{I as IonicSafeString,g as getMode,s as setupConfig}from"./p-EnaLTYYj.js";export{o as openURL}from"./p-DiVJyqlX.js";export{m as menuController}from"./p-C8d2ebIg.js";export{b as actionSheetController,a as alertController,l as loadingController,m as modalController,p as pickerController,c as popoverController,t as toastController}from"./p-JK8qe2uI.js";import"./p-ZjP4CjeZ.js";import"./p-BTEOs1at.js";import"./p-CvaZMP6T.js";import"./p-DAfH9Iif.js";const e=e=>{const{swiper:o,extendParams:t}=e,s={effect:void 0,direction:"horizontal",initialSlide:0,loop:!1,parallax:!1,slidesPerView:1,spaceBetween:0,speed:300,slidesPerColumn:1,slidesPerColumnFill:"column",slidesPerGroup:1,centeredSlides:!1,slidesOffsetBefore:0,slidesOffsetAfter:0,touchEventsTarget:"container",freeMode:!1,freeModeMomentum:!0,freeModeMomentumRatio:1,freeModeMomentumBounce:!0,freeModeMomentumBounceRatio:1,freeModeMomentumVelocityRatio:1,freeModeSticky:!1,freeModeMinimumVelocity:.02,autoHeight:!1,setWrapperSize:!1,zoom:{maxRatio:3,minRatio:1,toggle:!1},touchRatio:1,touchAngle:45,simulateTouch:!0,touchStartPreventDefault:!1,shortSwipes:!0,longSwipes:!0,longSwipesRatio:.5,longSwipesMs:300,followFinger:!0,threshold:0,touchMoveStopPropagation:!0,touchReleaseOnEdges:!1,iOSEdgeSwipeDetection:!1,iOSEdgeSwipeThreshold:20,resistance:!0,resistanceRatio:.85,watchSlidesProgress:!1,watchSlidesVisibility:!1,preventClicks:!0,preventClicksPropagation:!0,slideToClickedSlide:!1,loopAdditionalSlides:0,noSwiping:!0,runCallbacksOnInit:!0,coverflowEffect:{rotate:50,stretch:0,depth:100,modifier:1,slideShadows:!0},flipEffect:{slideShadows:!0,limitRotation:!0},cubeEffect:{slideShadows:!0,shadow:!0,shadowOffset:20,shadowScale:.94},fadeEffect:{crossFade:!1},a11y:{prevSlideMessage:"Previous slide",nextSlideMessage:"Next slide",firstSlideMessage:"This is the first slide",lastSlideMessage:"This is the last slide"}};o.pagination&&(s.pagination={type:"bullets",clickable:!1,hideOnClick:!1}),o.scrollbar&&(s.scrollbar={hide:!0}),t(s)};export{e as IonicSlides}