@ionic/core 7.4.2-dev.11695832397.13fa6703 → 7.4.2-dev.11695927273.1323de22

package/dist/collection/components/router/utils/path.js

@@ -38,6 +38,7 @@ export const chainToSegments = (chain) => {
   for (const route of chain) {
     for (const segment of route.segments) {
       if (segment[0] === ':') {
+        // eslint-disable-next-line @typescript-eslint/prefer-optional-chain
         const param = route.params && route.params[segment.slice(1)];
         if (!param) {
           return null;

package/dist/collection/components/router-outlet/router-outlet.css

@@ -5,5 +5,6 @@
   bottom: 0;
   position: absolute;
   contain: layout size style;
+  overflow: hidden;
   z-index: 0;
 }

package/dist/collection/components/tab-bar/tab-bar.js

@@ -44,9 +44,6 @@ export class TabBar {
       this.keyboardCtrl.destroy();
     }
   }
-  componentDidLoad() {
-    this.ionTabBarLoaded.emit();
-  }
   render() {
     const { color, translucent, keyboardVisible } = this;
     const mode = getIonMode(this);
@@ -163,24 +160,6 @@ export class TabBar {
             }
           }
         }
-      }, {
-        "method": "ionTabBarLoaded",
-        "name": "ionTabBarLoaded",
-        "bubbles": true,
-        "cancelable": true,
-        "composed": true,
-        "docs": {
-          "tags": [{
-              "name": "internal",
-              "text": "This event is used in IonContent to correctly\ncalculate the fullscreen content offsets\nwhen IonTabBar is used."
-            }],
-          "text": ""
-        },
-        "complexType": {
-          "original": "void",
-          "resolved": "void",
-          "references": {}
-        }
       }];
   }
   static get elementRef() { return "el"; }

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

@@ -2,17 +2,54 @@
  * (C) Ionic http://ionicframework.com - MIT License
  */
 import { createAnimation } from "../../../utils/animation/animation";
+import { win } from "../../../utils/browser/index";
 import { getElementRoot } from "../../../utils/helpers";
 /**
  * iOS Toast Enter Animation
  */
-export const iosEnterAnimation = (baseEl, position) => {
+export const iosEnterAnimation = (baseEl, opts) => {
   const baseAnimation = createAnimation();
   const wrapperAnimation = createAnimation();
+  const { position, positionAnchor } = opts;
   const root = getElementRoot(baseEl);
   const wrapperEl = root.querySelector('.toast-wrapper');
-  const bottom = `calc(-10px - var(--ion-safe-area-bottom, 0px))`;
-  const top = `calc(10px + var(--ion-safe-area-top, 0px))`;
+  /**
+   * Start with a predefined offset from the edge the toast will be
+   * positioned relative to. By default, this will be the top edge
+   * of the screen.
+   */
+  let offset = position === 'top' ? 10 : -10;
+  let top, bottom;
+  /**
+   * If positionAnchor is defined, add in the distance from the top
+   * of the screen to the target anchor edge. For position="top", the
+   * bottom anchor edge is targeted. For position="bottom", the top
+   * anchor edge is targeted.
+   */
+  if (positionAnchor && win) {
+    const box = positionAnchor.getBoundingClientRect();
+    if (position === 'top') {
+      offset += box.bottom;
+    }
+    else if (position === 'bottom') {
+      /**
+       * Just box.top is the distance from the top edge of the screen
+       * to the top edge of the anchor. We want to calculate from the
+       * bottom edge of the screen instead.
+       */
+      offset -= win.innerHeight - box.top;
+    }
+    /**
+     * We don't include safe area here because that should already be
+     * accounted for when checking the position of the anchor.
+     */
+    top = `${offset}px`;
+    bottom = `${offset}px`;
+  }
+  else {
+    top = `calc(${offset}px + var(--ion-safe-area-top, 0px))`;
+    bottom = `calc(${offset}px - var(--ion-safe-area-bottom, 0px))`;
+  }
   wrapperAnimation.addElement(wrapperEl);
   switch (position) {
     case 'top':

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

@@ -11,18 +11,22 @@ export const iosLeaveAnimation = (baseEl, position) => {
   const wrapperAnimation = createAnimation();
   const root = getElementRoot(baseEl);
   const wrapperEl = root.querySelector('.toast-wrapper');
-  const bottom = `calc(-10px - var(--ion-safe-area-bottom, 0px))`;
-  const top = `calc(10px + var(--ion-safe-area-top, 0px))`;
   wrapperAnimation.addElement(wrapperEl);
+  /**
+   * For top/bottom positions, we use to() instead of fromTo() so that if
+   * the positionAnchor prop was used, we don't need to recalculate the
+   * toast and/or anchor's position and duplicate work from the enter
+   * animation.
+   */
   switch (position) {
     case 'top':
-      wrapperAnimation.fromTo('transform', `translateY(${top})`, 'translateY(-100%)');
+      wrapperAnimation.to('transform', 'translateY(-100%)');
       break;
     case 'middle':
       wrapperAnimation.fromTo('opacity', 0.99, 0);
       break;
     default:
-      wrapperAnimation.fromTo('transform', `translateY(${bottom})`, 'translateY(100%)');
+      wrapperAnimation.to('transform', 'translateY(100%)');
       break;
   }
   return baseAnimation.easing('cubic-bezier(.36,.66,.04,1)').duration(300).addAnimation(wrapperAnimation);

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

@@ -2,17 +2,55 @@
  * (C) Ionic http://ionicframework.com - MIT License
  */
 import { createAnimation } from "../../../utils/animation/animation";
+import { win } from "../../../utils/browser/index";
 import { getElementRoot } from "../../../utils/helpers";
 /**
  * MD Toast Enter Animation
  */
-export const mdEnterAnimation = (baseEl, position) => {
+export const mdEnterAnimation = (baseEl, opts) => {
   const baseAnimation = createAnimation();
   const wrapperAnimation = createAnimation();
+  const { position, positionAnchor } = opts;
   const root = getElementRoot(baseEl);
   const wrapperEl = root.querySelector('.toast-wrapper');
-  const bottom = `calc(8px + var(--ion-safe-area-bottom, 0px))`;
-  const top = `calc(8px + var(--ion-safe-area-top, 0px))`;
+  /**
+   * Start with a predefined offset from the edge the toast will be
+   * positioned relative to. By default, this will be the top edge
+   * of the screen for position="top", or the bottom edge for
+   * position="bottom".
+   */
+  let offset = 8;
+  let top, bottom;
+  /**
+   * If positionAnchor is defined, add in the distance from the target
+   * screen edge to the target anchor edge. For position="top", the
+   * bottom anchor edge is targeted. For position="bottom", the top
+   * anchor edge is targeted.
+   */
+  if (positionAnchor && win) {
+    const box = positionAnchor.getBoundingClientRect();
+    if (position === 'top') {
+      offset += box.bottom;
+    }
+    else if (position === 'bottom') {
+      /**
+       * Just box.top is the distance from the top edge of the screen
+       * to the top edge of the anchor. We want to calculate from the
+       * bottom edge of the screen instead.
+       */
+      offset += win.innerHeight - box.top;
+    }
+    /**
+     * We don't include safe area here because that should already be
+     * accounted for when checking the position of the anchor.
+     */
+    top = `${offset}px`;
+    bottom = `${offset}px`;
+  }
+  else {
+    top = `calc(${offset}px + var(--ion-safe-area-top, 0px))`;
+    bottom = `calc(${offset}px + var(--ion-safe-area-bottom, 0px))`;
+  }
   wrapperAnimation.addElement(wrapperEl);
   switch (position) {
     case 'top':

package/dist/collection/components/toast/test/position-anchor/toast.e2e.js

@@ -0,0 +1,45 @@
+/*!
+ * (C) Ionic http://ionicframework.com - MIT License
+ */
+import { expect } from "@playwright/test";
+import { configs, test } from "../../../../utils/test/playwright/index";
+configs({ directions: ['ltr'] }).forEach(({ title, screenshot, config }) => {
+  test.describe(title('toast: positionAnchor'), () => {
+    test.beforeEach(async ({ page }) => {
+      await page.goto('/src/components/toast/test/position-anchor', config);
+      /**
+       * We need to screenshot the whole page to ensure the toasts are positioned
+       * correctly, but we don't need much extra white space between the header
+       * and footer.
+       */
+      await page.setViewportSize({
+        width: 425,
+        height: 425,
+      });
+    });
+    test('should place top-position toast underneath anchor', async ({ page }) => {
+      const ionToastDidPresent = await page.spyOnEvent('ionToastDidPresent');
+      await page.click('#headerAnchor');
+      await ionToastDidPresent.next();
+      await expect(page).toHaveScreenshot(screenshot(`toast-header-anchor`));
+    });
+    test('should place bottom-position toast above anchor', async ({ page }) => {
+      const ionToastDidPresent = await page.spyOnEvent('ionToastDidPresent');
+      await page.click('#footerAnchor');
+      await ionToastDidPresent.next();
+      await expect(page).toHaveScreenshot(screenshot(`toast-footer-anchor`));
+    });
+    test('should ignore anchor for middle-position toast', async ({ page }) => {
+      const ionToastDidPresent = await page.spyOnEvent('ionToastDidPresent');
+      await page.click('#middleAnchor');
+      await ionToastDidPresent.next();
+      await expect(page).toHaveScreenshot(screenshot(`toast-middle-anchor`));
+    });
+    test('should correctly anchor toast when using an element reference', async ({ page }) => {
+      const ionToastDidPresent = await page.spyOnEvent('ionToastDidPresent');
+      await page.click('#headerElAnchor');
+      await ionToastDidPresent.next();
+      await expect(page).toHaveScreenshot(screenshot(`toast-header-el-anchor`));
+    });
+  });
+});

package/dist/collection/components/toast/toast.js

@@ -54,6 +54,7 @@ export class Toast {
     this.message = undefined;
     this.keyboardClose = false;
     this.position = 'bottom';
+    this.positionAnchor = undefined;
     this.buttons = undefined;
     this.translucent = false;
     this.animated = true;
@@ -101,7 +102,33 @@ export class Toast {
   async present() {
     const unlock = await this.lockController.lock();
     await this.delegateController.attachViewToDom();
-    await present(this, 'toastEnter', iosEnterAnimation, mdEnterAnimation, this.position);
+    const { position, positionAnchor } = this;
+    let anchor;
+    if (position === 'middle' && positionAnchor !== undefined) {
+      printIonWarning('The positionAnchor property is ignored when using position="middle".', this.el);
+    }
+    else if (typeof positionAnchor === 'string') {
+      /**
+       * If the anchor is defined as an ID, find the element.
+       * We do this on every present so the toast doesn't need
+       * to account for the surrounding DOM changing since the
+       * last time it was presented.
+       */
+      const foundEl = document.getElementById(positionAnchor);
+      if (foundEl === null) {
+        printIonWarning(`An anchor element with an ID of ${positionAnchor} was not found in the DOM.`, this.el);
+      }
+      else {
+        anchor = foundEl;
+      }
+    }
+    else {
+      anchor = positionAnchor;
+    }
+    await present(this, 'toastEnter', iosEnterAnimation, mdEnterAnimation, {
+      position,
+      positionAnchor: anchor,
+    });
     /**
      * Content is revealed to screen readers after
      * the transition to avoid jank since this
@@ -517,12 +544,34 @@ export class Toast {
         "optional": false,
         "docs": {
           "tags": [],
-          "text": "The position of the toast on the screen."
+          "text": "The starting position of the toast on the screen. Can be tweaked further\nusing the `positionAnchor` property."
         },
         "attribute": "position",
         "reflect": false,
         "defaultValue": "'bottom'"
       },
+      "positionAnchor": {
+        "type": "string",
+        "mutable": false,
+        "complexType": {
+          "original": "HTMLElement | string",
+          "resolved": "HTMLElement | string | undefined",
+          "references": {
+            "HTMLElement": {
+              "location": "global",
+              "id": "global::HTMLElement"
+            }
+          }
+        },
+        "required": false,
+        "optional": true,
+        "docs": {
+          "tags": [],
+          "text": "The element to anchor the toast's position to. Can be set as a direct reference\nor the ID of the element. With `position=\"bottom\"`, the toast will sit above the\nchosen element. With `position=\"top\"`, the toast will sit below the chosen element.\nWith `position=\"middle\"`, the value of `positionAnchor` is ignored."
+        },
+        "attribute": "position-anchor",
+        "reflect": false
+      },
       "buttons": {
         "type": "unknown",
         "mutable": false,
@@ -812,9 +861,14 @@ export class Toast {
               "location": "global",
               "id": "global::Promise"
             },
-            "ToastPresentOptions": {
+            "HTMLElement": {
               "location": "global",
-              "id": "global::ToastPresentOptions"
+              "id": "global::HTMLElement"
+            },
+            "ToastPresentOptions": {
+              "location": "import",
+              "path": "./toast-interface",
+              "id": "src/components/toast/toast-interface.ts::ToastPresentOptions"
             }
           },
           "return": "Promise<void>"
@@ -846,8 +900,9 @@ export class Toast {
               "id": "global::Promise"
             },
             "ToastDismissOptions": {
-              "location": "global",
-              "id": "global::ToastDismissOptions"
+              "location": "import",
+              "path": "./toast-interface",
+              "id": "src/components/toast/toast-interface.ts::ToastDismissOptions"
             }
           },
           "return": "Promise<boolean>"

package/dist/collection/utils/native/haptic.js

@@ -75,6 +75,7 @@ const HapticEngine = {
      * if the browser does not support the Vibrate API.
      */
     if ((capacitor === null || capacitor === void 0 ? void 0 : capacitor.getPlatform()) === 'web') {
+      // eslint-disable-next-line @typescript-eslint/prefer-optional-chain
       return typeof navigator !== 'undefined' && navigator.vibrate !== undefined;
     }
     return true;

package/dist/collection/utils/overlays.js

@@ -68,6 +68,7 @@ export const setOverlayId = (el) => {
   return el.id;
 };
 export const createOverlay = (tagName, opts) => {
+  // eslint-disable-next-line @typescript-eslint/prefer-optional-chain
   if (typeof window !== 'undefined' && typeof window.customElements !== 'undefined') {
     return window.customElements.whenDefined(tagName).then(() => {
       const element = document.createElement(tagName);

package/dist/collection/utils/transition/ios.transition.js

@@ -202,6 +202,7 @@ export const iosTransitionAnimation = (navEl, opts) => {
       .easing(opts.easing || EASING)
       .fill('both')
       .beforeRemoveClass('ion-page-invisible');
+    // eslint-disable-next-line @typescript-eslint/prefer-optional-chain
     if (leavingEl && navEl !== null && navEl !== undefined) {
       const navDecorAnimation = createAnimation();
       navDecorAnimation.addElement(navEl);

package/dist/docs.json

@@ -1,5 +1,5 @@
 {
-  "timestamp": "2023-09-27T16:36:30",
+  "timestamp": "2023-09-28T18:57:10",
   "compiler": {
     "name": "@stencil/core",
     "version": "4.3.0",
@@ -6714,6 +6714,12 @@
         }
       ],
       "listeners": [
+        {
+          "event": "appload",
+          "target": "window",
+          "capture": false,
+          "passive": false
+        },
         {
           "event": "resize",
           "target": "window",
@@ -7102,11 +7108,17 @@
         },
         {
           "name": "hourCycle",
-          "type": "\"h12\" | \"h23\" | undefined",
+          "type": "\"h11\" | \"h12\" | \"h23\" | \"h24\" | undefined",
           "complexType": {
-            "original": "'h23' | 'h12'",
-            "resolved": "\"h12\" | \"h23\" | undefined",
-            "references": {}
+            "original": "DatetimeHourCycle",
+            "resolved": "\"h11\" | \"h12\" | \"h23\" | \"h24\" | undefined",
+            "references": {
+              "DatetimeHourCycle": {
+                "location": "import",
+                "path": "./datetime-interface",
+                "id": "src/components/datetime/datetime-interface.ts::DatetimeHourCycle"
+              }
+            }
           },
           "mutable": false,
           "attr": "hour-cycle",
@@ -7114,6 +7126,10 @@
           "docs": "The hour cycle of the `ion-datetime`. If no value is set, this is\nspecified by the current locale.",
           "docsTags": [],
           "values": [
+            {
+              "value": "h11",
+              "type": "string"
+            },
             {
               "value": "h12",
               "type": "string"
@@ -7122,6 +7138,10 @@
               "value": "h23",
               "type": "string"
             },
+            {
+              "value": "h24",
+              "type": "string"
+            },
             {
               "type": "undefined"
             }
@@ -27719,7 +27739,7 @@
           "mutable": false,
           "attr": "position",
           "reflectToAttr": false,
-          "docs": "The position of the toast on the screen.",
+          "docs": "The starting position of the toast on the screen. Can be tweaked further\nusing the `positionAnchor` property.",
           "docsTags": [],
           "default": "'bottom'",
           "values": [
@@ -27739,6 +27759,38 @@
           "optional": false,
           "required": false
         },
+        {
+          "name": "positionAnchor",
+          "type": "HTMLElement | string | undefined",
+          "complexType": {
+            "original": "HTMLElement | string",
+            "resolved": "HTMLElement | string | undefined",
+            "references": {
+              "HTMLElement": {
+                "location": "global",
+                "id": "global::HTMLElement"
+              }
+            }
+          },
+          "mutable": false,
+          "attr": "position-anchor",
+          "reflectToAttr": false,
+          "docs": "The element to anchor the toast's position to. Can be set as a direct reference\nor the ID of the element. With `position=\"bottom\"`, the toast will sit above the\nchosen element. With `position=\"top\"`, the toast will sit below the chosen element.\nWith `position=\"middle\"`, the value of `positionAnchor` is ignored.",
+          "docsTags": [],
+          "values": [
+            {
+              "type": "HTMLElement"
+            },
+            {
+              "type": "string"
+            },
+            {
+              "type": "undefined"
+            }
+          ],
+          "optional": true,
+          "required": false
+        },
         {
           "name": "translucent",
           "type": "boolean",
@@ -27821,8 +27873,9 @@
                 "id": "global::Promise"
               },
               "ToastDismissOptions": {
-                "location": "global",
-                "id": "global::ToastDismissOptions"
+                "location": "import",
+                "path": "./toast-interface",
+                "id": "src/components/toast/toast-interface.ts::ToastDismissOptions"
               }
             },
             "return": "Promise<boolean>"
@@ -27917,9 +27970,14 @@
                 "location": "global",
                 "id": "global::Promise"
               },
-              "ToastPresentOptions": {
+              "HTMLElement": {
                 "location": "global",
-                "id": "global::ToastPresentOptions"
+                "id": "global::HTMLElement"
+              },
+              "ToastPresentOptions": {
+                "location": "import",
+                "path": "./toast-interface",
+                "id": "src/components/toast/toast-interface.ts::ToastPresentOptions"
               }
             },
             "return": "Promise<void>"
@@ -28995,6 +29053,11 @@
       "docstring": "",
       "path": "src/components/datetime/datetime-interface.ts"
     },
+    "src/components/datetime/datetime-interface.ts::DatetimeHourCycle": {
+      "declaration": "export type DatetimeHourCycle = 'h11' | 'h12' | 'h23' | 'h24';",
+      "docstring": "",
+      "path": "src/components/datetime/datetime-interface.ts"
+    },
     "src/components/datetime/datetime-interface.ts::DatetimeChangeEventDetail": {
       "declaration": "export interface DatetimeChangeEventDetail {\n  value?: string | string[] | null;\n}",
       "docstring": "",
@@ -29290,6 +29353,16 @@
       "docstring": "",
       "path": "src/components/toast/toast-interface.ts"
     },
+    "src/components/toast/toast-interface.ts::ToastPresentOptions": {
+      "declaration": "export interface ToastPresentOptions {\n  position: ToastPosition;\n  positionAnchor?: HTMLElement;\n}",
+      "docstring": "",
+      "path": "src/components/toast/toast-interface.ts"
+    },
+    "src/components/toast/toast-interface.ts::ToastDismissOptions": {
+      "declaration": "export type ToastPosition = 'top' | 'bottom' | 'middle';",
+      "docstring": "",
+      "path": "src/components/toast/toast-interface.ts"
+    },
     "src/components/toggle/toggle-interface.ts::ToggleChangeEventDetail": {
       "declaration": "export interface ToggleChangeEventDetail<T = any> {\n  value: T;\n  checked: boolean;\n}",
       "docstring": "",

package/dist/esm/{button-active-513e9fff.js → button-active-d2346892.js}

@@ -2,7 +2,7 @@
  * (C) Ionic http://ionicframework.com - MIT License
  */
 import { w as writeTask } from './index-2d388930.js';
-import { h as hapticSelectionEnd, a as hapticSelectionStart, b as hapticSelectionChanged } from './haptic-6447af60.js';
+import { h as hapticSelectionEnd, a as hapticSelectionStart, b as hapticSelectionChanged } from './haptic-1243b917.js';
 import { createGesture } from './index-ff313b19.js';
 
 const createButtonActiveGesture = (el, isButton) => {