voyager-ionic-core 8.6.1 → 8.7.2

package/dist/collection/components/menu/menu.js

@@ -237,7 +237,7 @@ export class Menu {
         return Promise.resolve(this._isOpen);
     }
     /**
-     * Returns `true` is the menu is active.
+     * Returns `true` if the menu is active.
      *
      * A menu is active when it can be opened or closed, meaning it's enabled
      * and it's not part of a `ion-split-pane`.
@@ -248,6 +248,10 @@ export class Menu {
     /**
      * Opens the menu. If the menu is already open or it can't be opened,
      * it returns `false`.
+     *
+     * @param animated If `true`, the menu will animate when opening.
+     * If `false`, the menu will open instantly without animation.
+     * Defaults to `true`.
      */
     open(animated = true) {
         return this.setOpen(true, animated);
@@ -255,20 +259,38 @@ export class Menu {
     /**
      * Closes the menu. If the menu is already closed or it can't be closed,
      * it returns `false`.
+     *
+     * @param animated If `true`, the menu will animate when closing. If `false`,
+     * the menu will close instantly without animation. Defaults to `true`.
+     * @param role The role of the element that is closing the menu.
+     * This can be useful in a button handler for determining which button was
+     * clicked to close the menu. Some examples include:
+     * `"cancel"`, `"destructive"`, `"selected"`, and `"backdrop"`.
      */
     close(animated = true, role) {
         return this.setOpen(false, animated, role);
     }
     /**
-     * Toggles the menu. If the menu is already open, it will try to close, otherwise it will try to open it.
+     * Toggles the menu. If the menu is already open, it will try to close,
+     * otherwise it will try to open it.
      * If the operation can't be completed successfully, it returns `false`.
+     *
+     * @param animated If `true`, the menu will animate when opening/closing.
+     * If `false`, the menu will open/close instantly without animation.
+     * Defaults to `true`.
      */
     toggle(animated = true) {
         return this.setOpen(!this._isOpen, animated);
     }
     /**
-     * Opens or closes the button.
+     * Opens or closes the menu.
      * If the operation can't be completed successfully, it returns `false`.
+     *
+     * @param shouldOpen If `true`, the menu will open. If `false`, the menu
+     * will close.
+     * @param animated If `true`, the menu will animate when opening/closing.
+     * If `false`, the menu will open/close instantly without animation.
+     * @param role The role of the element that is closing the menu.
      */
     setOpen(shouldOpen, animated = true, role) {
         return menuController._setOpen(this, shouldOpen, animated, role);
@@ -633,14 +655,14 @@ export class Menu {
          * the ionBackButton listener in the menu controller
          * will handle closing the menu when Escape is pressed.
          */
-        return (h(Host, { key: '9e4ae9476a76781f1d228395c9af9e1c39ec82bb', onKeyDown: shouldUseCloseWatcher() ? null : this.onKeydown, role: "navigation", "aria-label": inheritedAttributes['aria-label'] || 'menu', class: {
+        return (h(Host, { key: 'a5c75aa40a34530b56ee3b98d706a5ac5ae300de', onKeyDown: shouldUseCloseWatcher() ? null : this.onKeydown, role: "navigation", "aria-label": inheritedAttributes['aria-label'] || 'menu', class: {
                 [mode]: true,
                 [`menu-type-${type}`]: true,
                 'menu-enabled': !disabled,
                 [`menu-side-${side}`]: true,
                 'menu-pane-visible': isPaneVisible,
                 'split-pane-side': hostContext('ion-split-pane', el),
-            } }, h("div", { key: 'c6153589d872ac7e3fdf5eedfdb858eb64ccd713', class: "menu-inner", part: "container", ref: (el) => (this.menuInnerEl = el) }, h("slot", { key: '9994aac4b22f17db34c9b8b2aa56b8710b9df645' })), h("ion-backdrop", { key: 'f09ac30cc4dd2dcb10628965e659dae5a23baf98', ref: (el) => (this.backdropEl = el), class: "menu-backdrop", tappable: false, stopPropagation: false, part: "backdrop" })));
+            } }, h("div", { key: '3f5f70acd4d3ed6bb445122f4f01d73db738a75f', class: "menu-inner", part: "container", ref: (el) => (this.menuInnerEl = el) }, h("slot", { key: '3161326c9330e7f7441299c428b87a91b31a83e9' })), h("ion-backdrop", { key: '917b50f38489bdf03d0c642af8b4e4e172c7dc4c', ref: (el) => (this.backdropEl = el), class: "menu-backdrop", tappable: false, stopPropagation: false, part: "backdrop" })));
     }
     static get is() { return "ion-menu"; }
     static get encapsulation() { return "shadow"; }
@@ -946,7 +968,7 @@ export class Menu {
                     "return": "Promise<boolean>"
                 },
                 "docs": {
-                    "text": "Returns `true` is the menu is active.\n\nA menu is active when it can be opened or closed, meaning it's enabled\nand it's not part of a `ion-split-pane`.",
+                    "text": "Returns `true` if the menu is active.\n\nA menu is active when it can be opened or closed, meaning it's enabled\nand it's not part of a `ion-split-pane`.",
                     "tags": []
                 }
             },
@@ -956,7 +978,7 @@ export class Menu {
                     "parameters": [{
                             "name": "animated",
                             "type": "boolean",
-                            "docs": ""
+                            "docs": "If `true`, the menu will animate when opening.\nIf `false`, the menu will open instantly without animation.\nDefaults to `true`."
                         }],
                     "references": {
                         "Promise": {
@@ -968,7 +990,10 @@ export class Menu {
                 },
                 "docs": {
                     "text": "Opens the menu. If the menu is already open or it can't be opened,\nit returns `false`.",
-                    "tags": []
+                    "tags": [{
+                            "name": "param",
+                            "text": "animated If `true`, the menu will animate when opening.\nIf `false`, the menu will open instantly without animation.\nDefaults to `true`."
+                        }]
                 }
             },
             "close": {
@@ -977,11 +1002,11 @@ export class Menu {
                     "parameters": [{
                             "name": "animated",
                             "type": "boolean",
-                            "docs": ""
+                            "docs": "If `true`, the menu will animate when closing. If `false`,\nthe menu will close instantly without animation. Defaults to `true`."
                         }, {
                             "name": "role",
                             "type": "string | undefined",
-                            "docs": ""
+                            "docs": "The role of the element that is closing the menu.\nThis can be useful in a button handler for determining which button was\nclicked to close the menu. Some examples include:\n`\"cancel\"`, `\"destructive\"`, `\"selected\"`, and `\"backdrop\"`."
                         }],
                     "references": {
                         "Promise": {
@@ -993,7 +1018,13 @@ export class Menu {
                 },
                 "docs": {
                     "text": "Closes the menu. If the menu is already closed or it can't be closed,\nit returns `false`.",
-                    "tags": []
+                    "tags": [{
+                            "name": "param",
+                            "text": "animated If `true`, the menu will animate when closing. If `false`,\nthe menu will close instantly without animation. Defaults to `true`."
+                        }, {
+                            "name": "param",
+                            "text": "role The role of the element that is closing the menu.\nThis can be useful in a button handler for determining which button was\nclicked to close the menu. Some examples include:\n`\"cancel\"`, `\"destructive\"`, `\"selected\"`, and `\"backdrop\"`."
+                        }]
                 }
             },
             "toggle": {
@@ -1002,7 +1033,7 @@ export class Menu {
                     "parameters": [{
                             "name": "animated",
                             "type": "boolean",
-                            "docs": ""
+                            "docs": "If `true`, the menu will animate when opening/closing.\nIf `false`, the menu will open/close instantly without animation.\nDefaults to `true`."
                         }],
                     "references": {
                         "Promise": {
@@ -1013,8 +1044,11 @@ export class Menu {
                     "return": "Promise<boolean>"
                 },
                 "docs": {
-                    "text": "Toggles the menu. If the menu is already open, it will try to close, otherwise it will try to open it.\nIf the operation can't be completed successfully, it returns `false`.",
-                    "tags": []
+                    "text": "Toggles the menu. If the menu is already open, it will try to close,\notherwise it will try to open it.\nIf the operation can't be completed successfully, it returns `false`.",
+                    "tags": [{
+                            "name": "param",
+                            "text": "animated If `true`, the menu will animate when opening/closing.\nIf `false`, the menu will open/close instantly without animation.\nDefaults to `true`."
+                        }]
                 }
             },
             "setOpen": {
@@ -1023,15 +1057,15 @@ export class Menu {
                     "parameters": [{
                             "name": "shouldOpen",
                             "type": "boolean",
-                            "docs": ""
+                            "docs": "If `true`, the menu will open. If `false`, the menu\nwill close."
                         }, {
                             "name": "animated",
                             "type": "boolean",
-                            "docs": ""
+                            "docs": "If `true`, the menu will animate when opening/closing.\nIf `false`, the menu will open/close instantly without animation."
                         }, {
                             "name": "role",
                             "type": "string | undefined",
-                            "docs": ""
+                            "docs": "The role of the element that is closing the menu."
                         }],
                     "references": {
                         "Promise": {
@@ -1042,8 +1076,17 @@ export class Menu {
                     "return": "Promise<boolean>"
                 },
                 "docs": {
-                    "text": "Opens or closes the button.\nIf the operation can't be completed successfully, it returns `false`.",
-                    "tags": []
+                    "text": "Opens or closes the menu.\nIf the operation can't be completed successfully, it returns `false`.",
+                    "tags": [{
+                            "name": "param",
+                            "text": "shouldOpen If `true`, the menu will open. If `false`, the menu\nwill close."
+                        }, {
+                            "name": "param",
+                            "text": "animated If `true`, the menu will animate when opening/closing.\nIf `false`, the menu will open/close instantly without animation."
+                        }, {
+                            "name": "param",
+                            "text": "role The role of the element that is closing the menu."
+                        }]
                 }
             }
         };

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

@@ -36,7 +36,7 @@ export const iosEnterAnimation = (baseEl, opts) => {
         baseAnimation.addAnimation(contentAnimation);
     }
     if (presentingEl) {
-        const isMobile = window.innerWidth < 768;
+        const isPortrait = window.innerWidth < 768;
         const hasCardModal = presentingEl.tagName === 'ION-MODAL' && presentingEl.presentingElement !== undefined;
         const presentingElRoot = getElementRoot(presentingEl);
         const presentingAnimation = createAnimation().beforeStyles({
@@ -45,7 +45,7 @@ export const iosEnterAnimation = (baseEl, opts) => {
             overflow: 'hidden',
         });
         const appEl = baseEl.closest('ion-app');
-        if (isMobile && appEl) {
+        if (isPortrait && appEl) {
             /**
              * Fallback for browsers that does not support `max()` (ex: Firefox)
              * No need to worry about statusbar padding since engines like Gecko

package/dist/collection/components/modal/animations/ios.leave.js

@@ -26,7 +26,7 @@ export const iosLeaveAnimation = (baseEl, opts, duration = 500) => {
         .addAnimation(wrapperAnimation);
     const appEl = baseEl.closest('ion-app');
     if (presentingEl && appEl) {
-        const isMobile = window.innerWidth < 768;
+        const isPortrait = window.innerWidth < 768;
         const hasCardModal = presentingEl.tagName === 'ION-MODAL' && presentingEl.presentingElement !== undefined;
         const presentingElRoot = getElementRoot(presentingEl);
         const presentingAnimation = createAnimation()
@@ -43,7 +43,7 @@ export const iosLeaveAnimation = (baseEl, opts, duration = 500) => {
                 appEl.style.setProperty('background-color', '');
             }
         });
-        if (isMobile) {
+        if (isPortrait) {
             const transformOffset = !CSS.supports('width', 'max(0px, 1px)') ? '30px' : 'max(30px, var(--ion-safe-area-top))';
             const modalTransform = hasCardModal ? '-10px' : transformOffset;
             const toPresentingScale = SwipeToCloseDefaults.MIN_PRESENTING_SCALE;

package/dist/collection/components/modal/animations/ios.transition.js

@@ -0,0 +1,152 @@
+/*!
+ * (C) Ionic http://ionicframework.com - MIT License
+ */
+import { createAnimation } from "../../../utils/animation/animation";
+import { getElementRoot } from "../../../utils/helpers";
+import { SwipeToCloseDefaults } from "../gestures/swipe-to-close";
+/**
+ * Transition animation from portrait view to landscape view
+ * This handles the case where a card modal is open in portrait view
+ * and the user switches to landscape view
+ */
+export const portraitToLandscapeTransition = (baseEl, opts, duration = 300) => {
+    const { presentingEl } = opts;
+    if (!presentingEl) {
+        // No transition needed for non-card modals
+        return createAnimation('portrait-to-landscape-transition');
+    }
+    const presentingElIsCardModal = presentingEl.tagName === 'ION-MODAL' && presentingEl.presentingElement !== undefined;
+    const presentingElRoot = getElementRoot(presentingEl);
+    const bodyEl = document.body;
+    const baseAnimation = createAnimation('portrait-to-landscape-transition')
+        .addElement(baseEl)
+        .easing('cubic-bezier(0.32,0.72,0,1)')
+        .duration(duration);
+    const presentingAnimation = createAnimation().beforeStyles({
+        transform: 'translateY(0)',
+        'transform-origin': 'top center',
+        overflow: 'hidden',
+    });
+    if (!presentingElIsCardModal) {
+        // The presenting element is not a card modal, so we do not
+        // need to care about layering and modal-specific styles.
+        const root = getElementRoot(baseEl);
+        const wrapperAnimation = createAnimation()
+            .addElement(root.querySelectorAll('.modal-wrapper, .modal-shadow'))
+            .fromTo('opacity', '1', '1'); // Keep wrapper visible in landscape
+        const backdropAnimation = createAnimation()
+            .addElement(root.querySelector('ion-backdrop'))
+            .fromTo('opacity', 'var(--backdrop-opacity)', 'var(--backdrop-opacity)'); // Keep backdrop visible
+        // Animate presentingEl from portrait state back to normal
+        const transformOffset = !CSS.supports('width', 'max(0px, 1px)') ? '30px' : 'max(30px, var(--ion-safe-area-top))';
+        const toPresentingScale = SwipeToCloseDefaults.MIN_PRESENTING_SCALE;
+        const fromTransform = `translateY(${transformOffset}) scale(${toPresentingScale})`;
+        presentingAnimation
+            .addElement(presentingEl)
+            .afterStyles({
+            transform: 'translateY(0px) scale(1)',
+            'border-radius': '0px',
+        })
+            .beforeAddWrite(() => bodyEl.style.setProperty('background-color', ''))
+            .fromTo('transform', fromTransform, 'translateY(0px) scale(1)')
+            .fromTo('filter', 'contrast(0.85)', 'contrast(1)')
+            .fromTo('border-radius', '10px 10px 0 0', '0px');
+        baseAnimation.addAnimation([presentingAnimation, wrapperAnimation, backdropAnimation]);
+    }
+    else {
+        // The presenting element is a card modal, so we do
+        // need to care about layering and modal-specific styles.
+        const toPresentingScale = SwipeToCloseDefaults.MIN_PRESENTING_SCALE;
+        const fromTransform = `translateY(-10px) scale(${toPresentingScale})`;
+        const toTransform = `translateY(0px) scale(1)`;
+        presentingAnimation
+            .addElement(presentingEl)
+            .afterStyles({
+            transform: toTransform,
+        })
+            .fromTo('transform', fromTransform, toTransform)
+            .fromTo('filter', 'contrast(0.85)', 'contrast(1)');
+        const shadowAnimation = createAnimation()
+            .addElement(presentingElRoot.querySelector('.modal-shadow'))
+            .afterStyles({
+            transform: toTransform,
+            opacity: '0',
+        })
+            .fromTo('transform', fromTransform, toTransform);
+        baseAnimation.addAnimation([presentingAnimation, shadowAnimation]);
+    }
+    return baseAnimation;
+};
+/**
+ * Transition animation from landscape view to portrait view
+ * This handles the case where a card modal is open in landscape view
+ * and the user switches to portrait view
+ */
+export const landscapeToPortraitTransition = (baseEl, opts, duration = 300) => {
+    const { presentingEl } = opts;
+    if (!presentingEl) {
+        // No transition needed for non-card modals
+        return createAnimation('landscape-to-portrait-transition');
+    }
+    const presentingElIsCardModal = presentingEl.tagName === 'ION-MODAL' && presentingEl.presentingElement !== undefined;
+    const presentingElRoot = getElementRoot(presentingEl);
+    const bodyEl = document.body;
+    const baseAnimation = createAnimation('landscape-to-portrait-transition')
+        .addElement(baseEl)
+        .easing('cubic-bezier(0.32,0.72,0,1)')
+        .duration(duration);
+    const presentingAnimation = createAnimation().beforeStyles({
+        transform: 'translateY(0)',
+        'transform-origin': 'top center',
+        overflow: 'hidden',
+    });
+    if (!presentingElIsCardModal) {
+        // The presenting element is not a card modal, so we do not
+        // need to care about layering and modal-specific styles.
+        const root = getElementRoot(baseEl);
+        const wrapperAnimation = createAnimation()
+            .addElement(root.querySelectorAll('.modal-wrapper, .modal-shadow'))
+            .fromTo('opacity', '1', '1'); // Keep wrapper visible
+        const backdropAnimation = createAnimation()
+            .addElement(root.querySelector('ion-backdrop'))
+            .fromTo('opacity', 'var(--backdrop-opacity)', 'var(--backdrop-opacity)'); // Keep backdrop visible
+        // Animate presentingEl from normal state to portrait state
+        const transformOffset = !CSS.supports('width', 'max(0px, 1px)') ? '30px' : 'max(30px, var(--ion-safe-area-top))';
+        const toPresentingScale = SwipeToCloseDefaults.MIN_PRESENTING_SCALE;
+        const toTransform = `translateY(${transformOffset}) scale(${toPresentingScale})`;
+        presentingAnimation
+            .addElement(presentingEl)
+            .afterStyles({
+            transform: toTransform,
+        })
+            .beforeAddWrite(() => bodyEl.style.setProperty('background-color', 'black'))
+            .keyframes([
+            { offset: 0, transform: 'translateY(0px) scale(1)', filter: 'contrast(1)', borderRadius: '0px' },
+            { offset: 0.2, transform: 'translateY(0px) scale(1)', filter: 'contrast(1)', borderRadius: '10px 10px 0 0' },
+            { offset: 1, transform: toTransform, filter: 'contrast(0.85)', borderRadius: '10px 10px 0 0' },
+        ]);
+        baseAnimation.addAnimation([presentingAnimation, wrapperAnimation, backdropAnimation]);
+    }
+    else {
+        // The presenting element is also a card modal, so we need
+        // to handle layering and modal-specific styles.
+        const toPresentingScale = SwipeToCloseDefaults.MIN_PRESENTING_SCALE;
+        const fromTransform = `translateY(-10px) scale(${toPresentingScale})`;
+        const toTransform = `translateY(0) scale(1)`;
+        presentingAnimation
+            .addElement(presentingEl)
+            .afterStyles({
+            transform: toTransform,
+        })
+            .fromTo('transform', fromTransform, toTransform);
+        const shadowAnimation = createAnimation()
+            .addElement(presentingElRoot.querySelector('.modal-shadow'))
+            .afterStyles({
+            transform: toTransform,
+            opacity: '0',
+        })
+            .fromTo('transform', fromTransform, toTransform);
+        baseAnimation.addAnimation([presentingAnimation, shadowAnimation]);
+    }
+    return baseAnimation;
+};