@ionic/core 8.7.17-dev.11771959013.18adabe2 → 8.7.17-dev.11772055571.14fddd38

package/components/helpers.js

@@ -1,4 +1,339 @@
 /*!
  * (C) Ionic http://ionicframework.com - MIT License
  */
-import{a}from"./index4.js";const i=(a,i=0)=>new Promise((e=>{r(a,i,e)})),r=(a,i=0,r)=>{let e,t;const n={passive:!0},o=()=>{e&&e()},s=i=>{void 0!==i&&a!==i.target||(o(),r(i))};return a&&(a.addEventListener("webkitTransitionEnd",s,n),a.addEventListener("transitionend",s,n),t=setTimeout(s,i+500),e=()=>{void 0!==t&&(clearTimeout(t),t=void 0),a.removeEventListener("webkitTransitionEnd",s,n),a.removeEventListener("transitionend",s,n)}),o},e=(a,i)=>{a.componentOnReady?a.componentOnReady().then((a=>i(a))):c((()=>i(a)))},t=a=>void 0!==a.componentOnReady,n=(a,i=[])=>{const r={};return i.forEach((i=>{a.hasAttribute(i)&&(null!==a.getAttribute(i)&&(r[i]=a.getAttribute(i)),a.removeAttribute(i))})),r},o=["role","aria-activedescendant","aria-atomic","aria-autocomplete","aria-braillelabel","aria-brailleroledescription","aria-busy","aria-checked","aria-colcount","aria-colindex","aria-colindextext","aria-colspan","aria-controls","aria-current","aria-describedby","aria-description","aria-details","aria-disabled","aria-errormessage","aria-expanded","aria-flowto","aria-haspopup","aria-hidden","aria-invalid","aria-keyshortcuts","aria-label","aria-labelledby","aria-level","aria-live","aria-multiline","aria-multiselectable","aria-orientation","aria-owns","aria-placeholder","aria-posinset","aria-pressed","aria-readonly","aria-relevant","aria-required","aria-roledescription","aria-rowcount","aria-rowindex","aria-rowindextext","aria-rowspan","aria-selected","aria-setsize","aria-sort","aria-valuemax","aria-valuemin","aria-valuenow","aria-valuetext"],s=a=>n(a,o),l=(a,i,r,e)=>a.addEventListener(i,r,e),u=(a,i,r,e)=>a.removeEventListener(i,r,e),d=(a,i=a)=>a.shadowRoot||i,c=a=>"function"==typeof __zone_symbol__requestAnimationFrame?__zone_symbol__requestAnimationFrame(a):"function"==typeof requestAnimationFrame?requestAnimationFrame(a):setTimeout(a),m=a=>!!a.shadowRoot&&!!a.attachShadow,p=a=>{if(a.focus(),a.classList.contains("ion-focusable")){const i=a.closest("ion-app");i&&i.setFocus([a])}},f=(a,i,r,e,t)=>{{let a=i.querySelector("input.aux-input");a||(a=i.ownerDocument.createElement("input"),a.type="hidden",a.classList.add("aux-input"),i.appendChild(a)),a.disabled=t,a.name=r,a.value=e||""}},b=(a,i,r)=>Math.max(a,Math.min(i,r)),v=(i,r)=>{if(!i){const i="ASSERT: "+r;throw a(i),new Error(i)}},x=a=>{if(a){const i=a.changedTouches;if(i&&i.length>0){const a=i[0];return{x:a.clientX,y:a.clientY}}if(void 0!==a.pageX)return{x:a.pageX,y:a.pageY}}return{x:0,y:0}},w=a=>{const i="rtl"===document.dir;switch(a){case"start":return i;case"end":return!i;default:throw new Error(`"${a}" is not a valid value for [side]. Use "start" or "end" instead.`)}},y=(a,i)=>{const r=a._original||a;return{_original:a,emit:h(r.emit.bind(r),i)}},h=(a,i=0)=>{let r;return(...e)=>{clearTimeout(r),r=setTimeout(a,i,...e)}},_=(a,i)=>{if(null!=a||(a={}),null!=i||(i={}),a===i)return!0;const r=Object.keys(a);if(r.length!==Object.keys(i).length)return!1;for(const e of r){if(!(e in i))return!1;if(a[e]!==i[e])return!1}return!0},T=a=>"number"==typeof a&&!isNaN(a)&&isFinite(a);export{l as a,u as b,e as c,n as d,f as e,b as f,d as g,p as h,s as i,m as j,t as k,y as l,w as m,v as n,T as o,h as p,x as q,c as r,_ as s,i as t}
+import { a as printIonError } from './index4.js';
+
+const transitionEndAsync = (el, expectedDuration = 0) => {
+    return new Promise((resolve) => {
+        transitionEnd(el, expectedDuration, resolve);
+    });
+};
+/**
+ * Allows developer to wait for a transition
+ * to finish and fallback to a timer if the
+ * transition is cancelled or otherwise
+ * never finishes. Also see transitionEndAsync
+ * which is an await-able version of this.
+ */
+const transitionEnd = (el, expectedDuration = 0, callback) => {
+    let unRegTrans;
+    let animationTimeout;
+    const opts = { passive: true };
+    const ANIMATION_FALLBACK_TIMEOUT = 500;
+    const unregister = () => {
+        if (unRegTrans) {
+            unRegTrans();
+        }
+    };
+    const onTransitionEnd = (ev) => {
+        if (ev === undefined || el === ev.target) {
+            unregister();
+            callback(ev);
+        }
+    };
+    if (el) {
+        el.addEventListener('webkitTransitionEnd', onTransitionEnd, opts);
+        el.addEventListener('transitionend', onTransitionEnd, opts);
+        animationTimeout = setTimeout(onTransitionEnd, expectedDuration + ANIMATION_FALLBACK_TIMEOUT);
+        unRegTrans = () => {
+            if (animationTimeout !== undefined) {
+                clearTimeout(animationTimeout);
+                animationTimeout = undefined;
+            }
+            el.removeEventListener('webkitTransitionEnd', onTransitionEnd, opts);
+            el.removeEventListener('transitionend', onTransitionEnd, opts);
+        };
+    }
+    return unregister;
+};
+/**
+ * Waits for a component to be ready for
+ * both custom element and non-custom element builds.
+ * If non-custom element build, el.componentOnReady
+ * will be used.
+ * For custom element builds, we wait a frame
+ * so that the inner contents of the component
+ * have a chance to render.
+ *
+ * Use this utility rather than calling
+ * el.componentOnReady yourself.
+ */
+const componentOnReady = (el, callback) => {
+    if (el.componentOnReady) {
+        // eslint-disable-next-line custom-rules/no-component-on-ready-method
+        el.componentOnReady().then((resolvedEl) => callback(resolvedEl));
+    }
+    else {
+        raf(() => callback(el));
+    }
+};
+/**
+ * This functions checks if a Stencil component is using
+ * the lazy loaded build of Stencil. Returns `true` if
+ * the component is lazy loaded. Returns `false` otherwise.
+ */
+const hasLazyBuild = (stencilEl) => {
+    return stencilEl.componentOnReady !== undefined;
+};
+/**
+ * Elements inside of web components sometimes need to inherit global attributes
+ * set on the host. For example, the inner input in `ion-input` should inherit
+ * the `title` attribute that developers set directly on `ion-input`. This
+ * helper function should be called in componentWillLoad and assigned to a variable
+ * that is later used in the render function.
+ *
+ * This does not need to be reactive as changing attributes on the host element
+ * does not trigger a re-render.
+ */
+const inheritAttributes = (el, attributes = []) => {
+    const attributeObject = {};
+    attributes.forEach((attr) => {
+        if (el.hasAttribute(attr)) {
+            const value = el.getAttribute(attr);
+            if (value !== null) {
+                attributeObject[attr] = el.getAttribute(attr);
+            }
+            el.removeAttribute(attr);
+        }
+    });
+    return attributeObject;
+};
+/**
+ * List of available ARIA attributes + `role`.
+ * Removed deprecated attributes.
+ * https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Attributes
+ */
+const ariaAttributes = [
+    'role',
+    'aria-activedescendant',
+    'aria-atomic',
+    'aria-autocomplete',
+    'aria-braillelabel',
+    'aria-brailleroledescription',
+    'aria-busy',
+    'aria-checked',
+    'aria-colcount',
+    'aria-colindex',
+    'aria-colindextext',
+    'aria-colspan',
+    'aria-controls',
+    'aria-current',
+    'aria-describedby',
+    'aria-description',
+    'aria-details',
+    'aria-disabled',
+    'aria-errormessage',
+    'aria-expanded',
+    'aria-flowto',
+    'aria-haspopup',
+    'aria-hidden',
+    'aria-invalid',
+    'aria-keyshortcuts',
+    'aria-label',
+    'aria-labelledby',
+    'aria-level',
+    'aria-live',
+    'aria-multiline',
+    'aria-multiselectable',
+    'aria-orientation',
+    'aria-owns',
+    'aria-placeholder',
+    'aria-posinset',
+    'aria-pressed',
+    'aria-readonly',
+    'aria-relevant',
+    'aria-required',
+    'aria-roledescription',
+    'aria-rowcount',
+    'aria-rowindex',
+    'aria-rowindextext',
+    'aria-rowspan',
+    'aria-selected',
+    'aria-setsize',
+    'aria-sort',
+    'aria-valuemax',
+    'aria-valuemin',
+    'aria-valuenow',
+    'aria-valuetext',
+];
+/**
+ * Returns an array of aria attributes that should be copied from
+ * the shadow host element to a target within the light DOM.
+ * @param el The element that the attributes should be copied from.
+ * @param ignoreList The list of aria-attributes to ignore reflecting and removing from the host.
+ * Use this in instances where we manually specify aria attributes on the `<Host>` element.
+ */
+const inheritAriaAttributes = (el, ignoreList) => {
+    let attributesToInherit = ariaAttributes;
+    return inheritAttributes(el, attributesToInherit);
+};
+const addEventListener = (el, eventName, callback, opts) => {
+    return el.addEventListener(eventName, callback, opts);
+};
+const removeEventListener = (el, eventName, callback, opts) => {
+    return el.removeEventListener(eventName, callback, opts);
+};
+/**
+ * Gets the root context of a shadow dom element
+ * On newer browsers this will be the shadowRoot,
+ * but for older browser this may just be the
+ * element itself.
+ *
+ * Useful for whenever you need to explicitly
+ * do "myElement.shadowRoot!.querySelector(...)".
+ */
+const getElementRoot = (el, fallback = el) => {
+    return el.shadowRoot || fallback;
+};
+/**
+ * Patched version of requestAnimationFrame that avoids ngzone
+ * Use only when you know ngzone should not run
+ */
+const raf = (h) => {
+    if (typeof __zone_symbol__requestAnimationFrame === 'function') {
+        return __zone_symbol__requestAnimationFrame(h);
+    }
+    if (typeof requestAnimationFrame === 'function') {
+        return requestAnimationFrame(h);
+    }
+    return setTimeout(h);
+};
+const hasShadowDom = (el) => {
+    return !!el.shadowRoot && !!el.attachShadow;
+};
+const focusVisibleElement = (el) => {
+    el.focus();
+    /**
+     * When programmatically focusing an element,
+     * the focus-visible utility will not run because
+     * it is expecting a keyboard event to have triggered this;
+     * however, there are times when we need to manually control
+     * this behavior so we call the `setFocus` method on ion-app
+     * which will let us explicitly set the elements to focus.
+     */
+    if (el.classList.contains('ion-focusable')) {
+        const app = el.closest('ion-app');
+        if (app) {
+            app.setFocus([el]);
+        }
+    }
+};
+/**
+ * This method is used to add a hidden input to a host element that contains
+ * a Shadow DOM. It does not add the input inside of the Shadow root which
+ * allows it to be picked up inside of forms. It should contain the same
+ * values as the host element.
+ *
+ * @param always Add a hidden input even if the container does not use Shadow
+ * @param container The element where the input will be added
+ * @param name The name of the input
+ * @param value The value of the input
+ * @param disabled If true, the input is disabled
+ */
+const renderHiddenInput = (always, container, name, value, disabled) => {
+    {
+        let input = container.querySelector('input.aux-input');
+        if (!input) {
+            input = container.ownerDocument.createElement('input');
+            input.type = 'hidden';
+            input.classList.add('aux-input');
+            container.appendChild(input);
+        }
+        input.disabled = disabled;
+        input.name = name;
+        input.value = value || '';
+    }
+};
+const clamp = (min, n, max) => {
+    return Math.max(min, Math.min(n, max));
+};
+const assert = (actual, reason) => {
+    if (!actual) {
+        const message = 'ASSERT: ' + reason;
+        printIonError(message);
+        debugger; // eslint-disable-line
+        throw new Error(message);
+    }
+};
+const pointerCoord = (ev) => {
+    // get X coordinates for either a mouse click
+    // or a touch depending on the given event
+    if (ev) {
+        const changedTouches = ev.changedTouches;
+        if (changedTouches && changedTouches.length > 0) {
+            const touch = changedTouches[0];
+            return { x: touch.clientX, y: touch.clientY };
+        }
+        if (ev.pageX !== undefined) {
+            return { x: ev.pageX, y: ev.pageY };
+        }
+    }
+    return { x: 0, y: 0 };
+};
+/**
+ * @hidden
+ * Given a side, return if it should be on the end
+ * based on the value of dir
+ * @param side the side
+ * @param isRTL whether the application dir is rtl
+ */
+const isEndSide = (side) => {
+    const isRTL = document.dir === 'rtl';
+    switch (side) {
+        case 'start':
+            return isRTL;
+        case 'end':
+            return !isRTL;
+        default:
+            throw new Error(`"${side}" is not a valid value for [side]. Use "start" or "end" instead.`);
+    }
+};
+const debounceEvent = (event, wait) => {
+    const original = event._original || event;
+    return {
+        _original: event,
+        emit: debounce(original.emit.bind(original), wait),
+    };
+};
+const debounce = (func, wait = 0) => {
+    let timer;
+    return (...args) => {
+        clearTimeout(timer);
+        timer = setTimeout(func, wait, ...args);
+    };
+};
+/**
+ * Check whether the two string maps are shallow equal.
+ *
+ * undefined is treated as an empty map.
+ *
+ * @returns whether the keys are the same and the values are shallow equal.
+ */
+const shallowEqualStringMap = (map1, map2) => {
+    map1 !== null && map1 !== void 0 ? map1 : (map1 = {});
+    map2 !== null && map2 !== void 0 ? map2 : (map2 = {});
+    if (map1 === map2) {
+        return true;
+    }
+    const keys1 = Object.keys(map1);
+    if (keys1.length !== Object.keys(map2).length) {
+        return false;
+    }
+    for (const k1 of keys1) {
+        if (!(k1 in map2)) {
+            return false;
+        }
+        if (map1[k1] !== map2[k1]) {
+            return false;
+        }
+    }
+    return true;
+};
+/**
+ * Checks input for usable number. Not NaN and not Infinite.
+ */
+const isSafeNumber = (input) => {
+    return typeof input === 'number' && !isNaN(input) && isFinite(input);
+};
+
+export { addEventListener as a, removeEventListener as b, componentOnReady as c, inheritAttributes as d, renderHiddenInput as e, clamp as f, getElementRoot as g, focusVisibleElement as h, inheritAriaAttributes as i, hasShadowDom as j, hasLazyBuild as k, debounceEvent as l, isEndSide as m, assert as n, isSafeNumber as o, debounce as p, pointerCoord as q, raf as r, shallowEqualStringMap as s, transitionEndAsync as t };