@ionic/core 8.5.4-dev.11743814940.14e938eb → 8.5.4-dev.11744052844.17c6a004

package/dist/cjs/index-48b2a28e.js

@@ -0,0 +1,46 @@
+/*!
+ * (C) Ionic http://ionicframework.com - MIT License
+ */
+'use strict';
+
+const ionicGlobal = require('./ionic-global-acb665ad.js');
+
+/**
+ * Logs a warning to the console with an Ionic prefix
+ * to indicate the library that is warning the developer.
+ *
+ * @param message - The string message to be logged to the console.
+ */
+const printIonWarning = (message, ...params) => {
+    const logLevel = ionicGlobal.config.get('logLevel', "WARN" /* LogLevel.WARN */);
+    if (["WARN" /* LogLevel.WARN */].includes(logLevel)) {
+        return console.warn(`[Ionic Warning]: ${message}`, ...params);
+    }
+};
+/**
+ * Logs an error to the console with an Ionic prefix
+ * to indicate the library that is warning the developer.
+ *
+ * @param message - The string message to be logged to the console.
+ * @param params - Additional arguments to supply to the console.error.
+ */
+const printIonError = (message, ...params) => {
+    const logLevel = ionicGlobal.config.get('logLevel', "ERROR" /* LogLevel.ERROR */);
+    if (["ERROR" /* LogLevel.ERROR */, "WARN" /* LogLevel.WARN */].includes(logLevel)) {
+        return console.error(`[Ionic Error]: ${message}`, ...params);
+    }
+};
+/**
+ * Prints an error informing developers that an implementation requires an element to be used
+ * within a specific selector.
+ *
+ * @param el The web component element this is requiring the element.
+ * @param targetSelectors The selector or selectors that were not found.
+ */
+const printRequiredElementError = (el, ...targetSelectors) => {
+    return console.error(`<${el.tagName.toLowerCase()}> must be used inside ${targetSelectors.join(' or ')}.`);
+};
+
+exports.printIonError = printIonError;
+exports.printIonWarning = printIonWarning;
+exports.printRequiredElementError = printRequiredElementError;

package/dist/cjs/index-4b70187a.js

@@ -0,0 +1,308 @@
+/*!
+ * (C) Ionic http://ionicframework.com - MIT License
+ */
+'use strict';
+
+const index$1 = require('./index-c8d52405.js');
+const hardwareBackButton = require('./hardware-back-button-5a99001f.js');
+const index = require('./index-48b2a28e.js');
+const helpers = require('./helpers-3a248559.js');
+const ionicGlobal = require('./ionic-global-acb665ad.js');
+const animation = require('./animation-b4fdf128.js');
+
+/**
+ * baseAnimation
+ * Base class which is extended by the various types. Each
+ * type will provide their own animations for open and close
+ * and registers itself with Menu.
+ */
+const baseAnimation = (isIos) => {
+    // https://material.io/guidelines/motion/movement.html#movement-movement-in-out-of-screen-bounds
+    // https://material.io/guidelines/motion/duration-easing.html#duration-easing-natural-easing-curves
+    /**
+     * "Apply the sharp curve to items temporarily leaving the screen that may return
+     * from the same exit point. When they return, use the deceleration curve. On mobile,
+     * this transition typically occurs over 300ms" -- MD Motion Guide
+     */
+    return animation.createAnimation().duration(isIos ? 400 : 300);
+};
+
+/**
+ * Menu Overlay Type
+ * The menu slides over the content. The content
+ * itself, which is under the menu, does not move.
+ */
+const menuOverlayAnimation = (menu) => {
+    let closedX;
+    let openedX;
+    const width = menu.width + 8;
+    const menuAnimation = animation.createAnimation();
+    const backdropAnimation = animation.createAnimation();
+    if (menu.isEndSide) {
+        // right side
+        closedX = width + 'px';
+        openedX = '0px';
+    }
+    else {
+        // left side
+        closedX = -width + 'px';
+        openedX = '0px';
+    }
+    menuAnimation.addElement(menu.menuInnerEl).fromTo('transform', `translateX(${closedX})`, `translateX(${openedX})`);
+    const mode = ionicGlobal.getIonMode(menu);
+    const isIos = mode === 'ios';
+    const opacity = isIos ? 0.2 : 0.25;
+    backdropAnimation.addElement(menu.backdropEl).fromTo('opacity', 0.01, opacity);
+    return baseAnimation(isIos).addAnimation([menuAnimation, backdropAnimation]);
+};
+
+/**
+ * Menu Push Type
+ * The content slides over to reveal the menu underneath.
+ * The menu itself also slides over to reveal its bad self.
+ */
+const menuPushAnimation = (menu) => {
+    let contentOpenedX;
+    let menuClosedX;
+    const mode = ionicGlobal.getIonMode(menu);
+    const width = menu.width;
+    if (menu.isEndSide) {
+        contentOpenedX = -width + 'px';
+        menuClosedX = width + 'px';
+    }
+    else {
+        contentOpenedX = width + 'px';
+        menuClosedX = -width + 'px';
+    }
+    const menuAnimation = animation.createAnimation()
+        .addElement(menu.menuInnerEl)
+        .fromTo('transform', `translateX(${menuClosedX})`, 'translateX(0px)');
+    const contentAnimation = animation.createAnimation()
+        .addElement(menu.contentEl)
+        .fromTo('transform', 'translateX(0px)', `translateX(${contentOpenedX})`);
+    const backdropAnimation = animation.createAnimation().addElement(menu.backdropEl).fromTo('opacity', 0.01, 0.32);
+    return baseAnimation(mode === 'ios').addAnimation([menuAnimation, contentAnimation, backdropAnimation]);
+};
+
+/**
+ * Menu Reveal Type
+ * The content slides over to reveal the menu underneath.
+ * The menu itself, which is under the content, does not move.
+ */
+const menuRevealAnimation = (menu) => {
+    const mode = ionicGlobal.getIonMode(menu);
+    const openedX = menu.width * (menu.isEndSide ? -1 : 1) + 'px';
+    const contentOpen = animation.createAnimation()
+        .addElement(menu.contentEl) // REVIEW
+        .fromTo('transform', 'translateX(0px)', `translateX(${openedX})`);
+    return baseAnimation(mode === 'ios').addAnimation(contentOpen);
+};
+
+const createMenuController = () => {
+    const menuAnimations = new Map();
+    const menus = [];
+    const open = async (menu) => {
+        const menuEl = await get(menu, true);
+        if (menuEl) {
+            return menuEl.open();
+        }
+        return false;
+    };
+    const close = async (menu) => {
+        const menuEl = await (menu !== undefined ? get(menu, true) : getOpen());
+        if (menuEl !== undefined) {
+            return menuEl.close();
+        }
+        return false;
+    };
+    const toggle = async (menu) => {
+        const menuEl = await get(menu, true);
+        if (menuEl) {
+            return menuEl.toggle();
+        }
+        return false;
+    };
+    const enable = async (shouldEnable, menu) => {
+        const menuEl = await get(menu);
+        if (menuEl) {
+            menuEl.disabled = !shouldEnable;
+        }
+        return menuEl;
+    };
+    const swipeGesture = async (shouldEnable, menu) => {
+        const menuEl = await get(menu);
+        if (menuEl) {
+            menuEl.swipeGesture = shouldEnable;
+        }
+        return menuEl;
+    };
+    const isOpen = async (menu) => {
+        if (menu != null) {
+            const menuEl = await get(menu);
+            // eslint-disable-next-line @typescript-eslint/prefer-optional-chain
+            return menuEl !== undefined && menuEl.isOpen();
+        }
+        else {
+            const menuEl = await getOpen();
+            return menuEl !== undefined;
+        }
+    };
+    const isEnabled = async (menu) => {
+        const menuEl = await get(menu);
+        if (menuEl) {
+            return !menuEl.disabled;
+        }
+        return false;
+    };
+    /**
+     * Finds and returns the menu specified by "menu" if registered.
+     * @param menu - The side or ID of the desired menu
+     * @param logOnMultipleSideMenus - If true, this function will log a warning
+     * if "menu" is a side but multiple menus on the same side were found. Since this function
+     * is used in multiple places, we default this log to false so that the calling
+     * functions can choose whether or not it is appropriate to log this warning.
+     */
+    const get = async (menu, logOnMultipleSideMenus = false) => {
+        await waitUntilReady();
+        if (menu === 'start' || menu === 'end') {
+            // there could be more than one menu on the same side
+            // so first try to get the enabled one
+            const menuRefs = menus.filter((m) => m.side === menu && !m.disabled);
+            if (menuRefs.length >= 1) {
+                if (menuRefs.length > 1 && logOnMultipleSideMenus) {
+                    index.printIonWarning(`menuController queried for a menu on the "${menu}" side, but ${menuRefs.length} menus were found. The first menu reference will be used. If this is not the behavior you want then pass the ID of the menu instead of its side.`, menuRefs.map((m) => m.el));
+                }
+                return menuRefs[0].el;
+            }
+            // didn't find a menu side that is enabled
+            // so try to get the first menu side found
+            const sideMenuRefs = menus.filter((m) => m.side === menu);
+            if (sideMenuRefs.length >= 1) {
+                if (sideMenuRefs.length > 1 && logOnMultipleSideMenus) {
+                    index.printIonWarning(`menuController queried for a menu on the "${menu}" side, but ${sideMenuRefs.length} menus were found. The first menu reference will be used. If this is not the behavior you want then pass the ID of the menu instead of its side.`, sideMenuRefs.map((m) => m.el));
+                }
+                return sideMenuRefs[0].el;
+            }
+        }
+        else if (menu != null) {
+            // the menuId was not left or right
+            // so try to get the menu by its "id"
+            return find((m) => m.menuId === menu);
+        }
+        // return the first enabled menu
+        const menuEl = find((m) => !m.disabled);
+        if (menuEl) {
+            return menuEl;
+        }
+        // get the first menu in the array, if one exists
+        return menus.length > 0 ? menus[0].el : undefined;
+    };
+    /**
+     * Get the instance of the opened menu. Returns `null` if a menu is not found.
+     */
+    const getOpen = async () => {
+        await waitUntilReady();
+        return _getOpenSync();
+    };
+    /**
+     * Get all menu instances.
+     */
+    const getMenus = async () => {
+        await waitUntilReady();
+        return getMenusSync();
+    };
+    /**
+     * Get whether or not a menu is animating. Returns `true` if any
+     * menu is currently animating.
+     */
+    const isAnimating = async () => {
+        await waitUntilReady();
+        return isAnimatingSync();
+    };
+    const registerAnimation = (name, animation) => {
+        menuAnimations.set(name, animation);
+    };
+    const _register = (menu) => {
+        if (menus.indexOf(menu) < 0) {
+            menus.push(menu);
+        }
+    };
+    const _unregister = (menu) => {
+        const index = menus.indexOf(menu);
+        if (index > -1) {
+            menus.splice(index, 1);
+        }
+    };
+    const _setOpen = async (menu, shouldOpen, animated, role) => {
+        if (isAnimatingSync()) {
+            return false;
+        }
+        if (shouldOpen) {
+            const openedMenu = await getOpen();
+            if (openedMenu && menu.el !== openedMenu) {
+                await openedMenu.setOpen(false, false);
+            }
+        }
+        return menu._setOpen(shouldOpen, animated, role);
+    };
+    const _createAnimation = (type, menuCmp) => {
+        const animationBuilder = menuAnimations.get(type); // TODO(FW-2832): type
+        if (!animationBuilder) {
+            throw new Error('animation not registered');
+        }
+        const animation = animationBuilder(menuCmp);
+        return animation;
+    };
+    const _getOpenSync = () => {
+        return find((m) => m._isOpen);
+    };
+    const getMenusSync = () => {
+        return menus.map((menu) => menu.el);
+    };
+    const isAnimatingSync = () => {
+        return menus.some((menu) => menu.isAnimating);
+    };
+    const find = (predicate) => {
+        const instance = menus.find(predicate);
+        if (instance !== undefined) {
+            return instance.el;
+        }
+        return undefined;
+    };
+    const waitUntilReady = () => {
+        return Promise.all(Array.from(document.querySelectorAll('ion-menu')).map((menu) => new Promise((resolve) => helpers.componentOnReady(menu, resolve))));
+    };
+    registerAnimation('reveal', menuRevealAnimation);
+    registerAnimation('push', menuPushAnimation);
+    registerAnimation('overlay', menuOverlayAnimation);
+    index$1.doc === null || index$1.doc === void 0 ? void 0 : index$1.doc.addEventListener('ionBackButton', (ev) => {
+        const openMenu = _getOpenSync();
+        if (openMenu) {
+            ev.detail.register(hardwareBackButton.MENU_BACK_BUTTON_PRIORITY, () => {
+                return openMenu.close();
+            });
+        }
+    });
+    return {
+        registerAnimation,
+        get,
+        getMenus,
+        getOpen,
+        isEnabled,
+        swipeGesture,
+        isAnimating,
+        isOpen,
+        enable,
+        toggle,
+        close,
+        open,
+        _getOpenSync,
+        _createAnimation,
+        _register,
+        _unregister,
+        _setOpen,
+    };
+};
+const menuController = /*@__PURE__*/ createMenuController();
+
+exports.menuController = menuController;

package/dist/cjs/index-509ca0d3.js

@@ -0,0 +1,140 @@
+/*!
+ * (C) Ionic http://ionicframework.com - MIT License
+ */
+'use strict';
+
+const helpers = require('./helpers-3a248559.js');
+const index = require('./index-48b2a28e.js');
+
+const ION_CONTENT_TAG_NAME = 'ION-CONTENT';
+const ION_CONTENT_ELEMENT_SELECTOR = 'ion-content';
+const ION_CONTENT_CLASS_SELECTOR = '.ion-content-scroll-host';
+/**
+ * Selector used for implementations reliant on `<ion-content>` for scroll event changes.
+ *
+ * Developers should use the `.ion-content-scroll-host` selector to target the element emitting
+ * scroll events. With virtual scroll implementations this will be the host element for
+ * the scroll viewport.
+ */
+const ION_CONTENT_SELECTOR = `${ION_CONTENT_ELEMENT_SELECTOR}, ${ION_CONTENT_CLASS_SELECTOR}`;
+const isIonContent = (el) => el.tagName === ION_CONTENT_TAG_NAME;
+/**
+ * Waits for the element host fully initialize before
+ * returning the inner scroll element.
+ *
+ * For `ion-content` the scroll target will be the result
+ * of the `getScrollElement` function.
+ *
+ * For custom implementations it will be the element host
+ * or a selector within the host, if supplied through `scrollTarget`.
+ */
+const getScrollElement = async (el) => {
+    if (isIonContent(el)) {
+        await new Promise((resolve) => helpers.componentOnReady(el, resolve));
+        return el.getScrollElement();
+    }
+    return el;
+};
+/**
+ * Queries the element matching the selector for IonContent.
+ * See ION_CONTENT_SELECTOR for the selector used.
+ */
+const findIonContent = (el) => {
+    /**
+     * First we try to query the custom scroll host selector in cases where
+     * the implementation is using an outer `ion-content` with an inner custom
+     * scroll container.
+     */
+    const customContentHost = el.querySelector(ION_CONTENT_CLASS_SELECTOR);
+    if (customContentHost) {
+        return customContentHost;
+    }
+    return el.querySelector(ION_CONTENT_SELECTOR);
+};
+/**
+ * Queries the closest element matching the selector for IonContent.
+ */
+const findClosestIonContent = (el) => {
+    return el.closest(ION_CONTENT_SELECTOR);
+};
+/**
+ * Scrolls to the top of the element. If an `ion-content` is found, it will scroll
+ * using the public API `scrollToTop` with a duration.
+ */
+const scrollToTop = (el, durationMs) => {
+    if (isIonContent(el)) {
+        const content = el;
+        return content.scrollToTop(durationMs);
+    }
+    return Promise.resolve(el.scrollTo({
+        top: 0,
+        left: 0,
+        behavior: durationMs > 0 ? 'smooth' : 'auto',
+    }));
+};
+/**
+ * Scrolls by a specified X/Y distance in the component. If an `ion-content` is found, it will scroll
+ * using the public API `scrollByPoint` with a duration.
+ */
+const scrollByPoint = (el, x, y, durationMs) => {
+    if (isIonContent(el)) {
+        const content = el;
+        return content.scrollByPoint(x, y, durationMs);
+    }
+    return Promise.resolve(el.scrollBy({
+        top: y,
+        left: x,
+        behavior: durationMs > 0 ? 'smooth' : 'auto',
+    }));
+};
+/**
+ * Prints an error informing developers that an implementation requires an element to be used
+ * within either the `ion-content` selector or the `.ion-content-scroll-host` class.
+ */
+const printIonContentErrorMsg = (el) => {
+    return index.printRequiredElementError(el, ION_CONTENT_ELEMENT_SELECTOR);
+};
+/**
+ * Several components in Ionic need to prevent scrolling
+ * during a gesture (card modal, range, item sliding, etc).
+ * Use this utility to account for ion-content and custom content hosts.
+ */
+const disableContentScrollY = (contentEl) => {
+    if (isIonContent(contentEl)) {
+        const ionContent = contentEl;
+        const initialScrollY = ionContent.scrollY;
+        ionContent.scrollY = false;
+        /**
+         * This should be passed into resetContentScrollY
+         * so that we can revert ion-content's scrollY to the
+         * correct state. For example, if scrollY = false
+         * initially, we do not want to enable scrolling
+         * when we call resetContentScrollY.
+         */
+        return initialScrollY;
+    }
+    else {
+        contentEl.style.setProperty('overflow', 'hidden');
+        return true;
+    }
+};
+const resetContentScrollY = (contentEl, initialScrollY) => {
+    if (isIonContent(contentEl)) {
+        contentEl.scrollY = initialScrollY;
+    }
+    else {
+        contentEl.style.removeProperty('overflow');
+    }
+};
+
+exports.ION_CONTENT_CLASS_SELECTOR = ION_CONTENT_CLASS_SELECTOR;
+exports.ION_CONTENT_ELEMENT_SELECTOR = ION_CONTENT_ELEMENT_SELECTOR;
+exports.disableContentScrollY = disableContentScrollY;
+exports.findClosestIonContent = findClosestIonContent;
+exports.findIonContent = findIonContent;
+exports.getScrollElement = getScrollElement;
+exports.isIonContent = isIonContent;
+exports.printIonContentErrorMsg = printIonContentErrorMsg;
+exports.resetContentScrollY = resetContentScrollY;
+exports.scrollByPoint = scrollByPoint;
+exports.scrollToTop = scrollToTop;

package/dist/cjs/index-c8d52405.js

@@ -0,0 +1,10 @@
+/*!
+ * (C) Ionic http://ionicframework.com - MIT License
+ */
+'use strict';
+
+const win = typeof window !== 'undefined' ? window : undefined;
+const doc = typeof document !== 'undefined' ? document : undefined;
+
+exports.doc = doc;
+exports.win = win;

package/dist/cjs/index-e36bd277.js

@@ -0,0 +1,169 @@
+/*!
+ * (C) Ionic http://ionicframework.com - MIT License
+ */
+'use strict';
+
+const index = require('./index-c8d52405.js');
+const helpers = require('./helpers-3a248559.js');
+
+const startTapClick = (config) => {
+    if (index.doc === undefined) {
+        return;
+    }
+    let lastActivated = 0;
+    let activatableEle;
+    let activeRipple;
+    let activeDefer;
+    const useRippleEffect = config.getBoolean('animated', true) && config.getBoolean('rippleEffect', true);
+    const clearDefers = new WeakMap();
+    const cancelActive = () => {
+        if (activeDefer)
+            clearTimeout(activeDefer);
+        activeDefer = undefined;
+        if (activatableEle) {
+            removeActivated(false);
+            activatableEle = undefined;
+        }
+    };
+    const pointerDown = (ev) => {
+        // Ignore right clicks
+        if (activatableEle || ev.button === 2) {
+            return;
+        }
+        setActivatedElement(getActivatableTarget(ev), ev);
+    };
+    const pointerUp = (ev) => {
+        setActivatedElement(undefined, ev);
+    };
+    const setActivatedElement = (el, ev) => {
+        // do nothing
+        if (el && el === activatableEle) {
+            return;
+        }
+        if (activeDefer)
+            clearTimeout(activeDefer);
+        activeDefer = undefined;
+        const { x, y } = helpers.pointerCoord(ev);
+        // deactivate selected
+        if (activatableEle) {
+            if (clearDefers.has(activatableEle)) {
+                throw new Error('internal error');
+            }
+            if (!activatableEle.classList.contains(ACTIVATED)) {
+                addActivated(activatableEle, x, y);
+            }
+            removeActivated(true);
+        }
+        // activate
+        if (el) {
+            const deferId = clearDefers.get(el);
+            if (deferId) {
+                clearTimeout(deferId);
+                clearDefers.delete(el);
+            }
+            el.classList.remove(ACTIVATED);
+            const callback = () => {
+                addActivated(el, x, y);
+                activeDefer = undefined;
+            };
+            if (isInstant(el)) {
+                callback();
+            }
+            else {
+                activeDefer = setTimeout(callback, ADD_ACTIVATED_DEFERS);
+            }
+        }
+        activatableEle = el;
+    };
+    const addActivated = (el, x, y) => {
+        lastActivated = Date.now();
+        el.classList.add(ACTIVATED);
+        if (!useRippleEffect)
+            return;
+        const rippleEffect = getRippleEffect(el);
+        if (rippleEffect !== null) {
+            removeRipple();
+            activeRipple = rippleEffect.addRipple(x, y);
+        }
+    };
+    const removeRipple = () => {
+        if (activeRipple !== undefined) {
+            activeRipple.then((remove) => remove());
+            activeRipple = undefined;
+        }
+    };
+    const removeActivated = (smooth) => {
+        removeRipple();
+        const active = activatableEle;
+        if (!active) {
+            return;
+        }
+        const time = CLEAR_STATE_DEFERS - Date.now() + lastActivated;
+        if (smooth && time > 0 && !isInstant(active)) {
+            const deferId = setTimeout(() => {
+                active.classList.remove(ACTIVATED);
+                clearDefers.delete(active);
+            }, CLEAR_STATE_DEFERS);
+            clearDefers.set(active, deferId);
+        }
+        else {
+            active.classList.remove(ACTIVATED);
+        }
+    };
+    index.doc.addEventListener('ionGestureCaptured', cancelActive);
+    index.doc.addEventListener('pointerdown', pointerDown, true);
+    index.doc.addEventListener('pointerup', pointerUp, true);
+    /**
+     * Tap click effects such as the ripple effect should
+     * not happen when scrolling. For example, if a user scrolls
+     * the page but also happens to do a touchstart on a button
+     * as part of the scroll, the ripple effect should not
+     * be dispatched. The ripple effect should only happen
+     * if the button is activated and the page is not scrolling.
+     *
+     * pointercancel is dispatched on a gesture when scrolling
+     * starts, so this lets us avoid having to listen for
+     * ion-content's scroll events.
+     */
+    index.doc.addEventListener('pointercancel', cancelActive, true);
+};
+// TODO(FW-2832): type
+const getActivatableTarget = (ev) => {
+    if (ev.composedPath !== undefined) {
+        /**
+         * composedPath returns EventTarget[]. However,
+         * objects other than Element can be targets too.
+         * For example, AudioContext can be a target. In this
+         * case, we know that the event is a UIEvent so we
+         * can assume that the path will contain either Element
+         * or ShadowRoot.
+         */
+        const path = ev.composedPath();
+        for (let i = 0; i < path.length - 2; i++) {
+            const el = path[i];
+            if (!(el instanceof ShadowRoot) && el.classList.contains('ion-activatable')) {
+                return el;
+            }
+        }
+    }
+    else {
+        return ev.target.closest('.ion-activatable');
+    }
+};
+const isInstant = (el) => {
+    return el.classList.contains('ion-activatable-instant');
+};
+const getRippleEffect = (el) => {
+    if (el.shadowRoot) {
+        const ripple = el.shadowRoot.querySelector('ion-ripple-effect');
+        if (ripple) {
+            return ripple;
+        }
+    }
+    return el.querySelector('ion-ripple-effect');
+};
+const ACTIVATED = 'ion-activated';
+const ADD_ACTIVATED_DEFERS = 100;
+const CLEAR_STATE_DEFERS = 150;
+
+exports.startTapClick = startTapClick;