@ionic/core 7.5.8-dev.11703088210.14a72b83 → 7.5.8-dev.11705350665.1a40ee3a

package/dist/collection/components/picker-legacy-column/picker-column.js

@@ -0,0 +1,419 @@
+/*!
+ * (C) Ionic http://ionicframework.com - MIT License
+ */
+import { Host, h } from "@stencil/core";
+import { clamp } from "../../utils/helpers";
+import { hapticSelectionChanged, hapticSelectionEnd, hapticSelectionStart } from "../../utils/native/haptic";
+import { getClassMap } from "../../utils/theme";
+import { getIonMode } from "../../global/ionic-global";
+/**
+ * @internal
+ */
+export class PickerColumnCmp {
+    constructor() {
+        this.optHeight = 0;
+        this.rotateFactor = 0;
+        this.scaleFactor = 1;
+        this.velocity = 0;
+        this.y = 0;
+        this.noAnimate = true;
+        // `colDidChange` is a flag that gets set when the column is changed
+        // dynamically. When this flag is set, the column will refresh
+        // after the component re-renders to incorporate the new column data.
+        // This is necessary because `this.refresh` queries for the option elements,
+        // so it needs to wait for the latest elements to be available in the DOM.
+        // Ex: column is created with 3 options. User updates the column data
+        // to have 5 options. The column will still think it only has 3 options.
+        this.colDidChange = false;
+        this.col = undefined;
+    }
+    colChanged() {
+        this.colDidChange = true;
+    }
+    async connectedCallback() {
+        let pickerRotateFactor = 0;
+        let pickerScaleFactor = 0.81;
+        const mode = getIonMode(this);
+        if (mode === 'ios') {
+            pickerRotateFactor = -0.46;
+            pickerScaleFactor = 1;
+        }
+        this.rotateFactor = pickerRotateFactor;
+        this.scaleFactor = pickerScaleFactor;
+        this.gesture = (await import('../../utils/gesture')).createGesture({
+            el: this.el,
+            gestureName: 'picker-swipe',
+            gesturePriority: 100,
+            threshold: 0,
+            passive: false,
+            onStart: (ev) => this.onStart(ev),
+            onMove: (ev) => this.onMove(ev),
+            onEnd: (ev) => this.onEnd(ev),
+        });
+        this.gesture.enable();
+        // Options have not been initialized yet
+        // Animation must be disabled through the `noAnimate` flag
+        // Otherwise, the options will render
+        // at the top of the column and transition down
+        this.tmrId = setTimeout(() => {
+            this.noAnimate = false;
+            // After initialization, `refresh()` will be called
+            // At this point, animation will be enabled. The options will
+            // animate as they are being selected.
+            this.refresh(true);
+        }, 250);
+    }
+    componentDidLoad() {
+        this.onDomChange();
+    }
+    componentDidUpdate() {
+        // Options may have changed since last update.
+        if (this.colDidChange) {
+            // Animation must be disabled through the `onDomChange` parameter.
+            // Otherwise, the recently added options will render
+            // at the top of the column and transition down
+            this.onDomChange(true, false);
+            this.colDidChange = false;
+        }
+    }
+    disconnectedCallback() {
+        if (this.rafId !== undefined)
+            cancelAnimationFrame(this.rafId);
+        if (this.tmrId)
+            clearTimeout(this.tmrId);
+        if (this.gesture) {
+            this.gesture.destroy();
+            this.gesture = undefined;
+        }
+    }
+    emitColChange() {
+        this.ionPickerColChange.emit(this.col);
+    }
+    setSelected(selectedIndex, duration) {
+        // if there is a selected index, then figure out it's y position
+        // if there isn't a selected index, then just use the top y position
+        const y = selectedIndex > -1 ? -(selectedIndex * this.optHeight) : 0;
+        this.velocity = 0;
+        // set what y position we're at
+        if (this.rafId !== undefined)
+            cancelAnimationFrame(this.rafId);
+        this.update(y, duration, true);
+        this.emitColChange();
+    }
+    update(y, duration, saveY) {
+        if (!this.optsEl) {
+            return;
+        }
+        // ensure we've got a good round number :)
+        let translateY = 0;
+        let translateZ = 0;
+        const { col, rotateFactor } = this;
+        const prevSelected = col.selectedIndex;
+        const selectedIndex = (col.selectedIndex = this.indexForY(-y));
+        const durationStr = duration === 0 ? '' : duration + 'ms';
+        const scaleStr = `scale(${this.scaleFactor})`;
+        const children = this.optsEl.children;
+        for (let i = 0; i < children.length; i++) {
+            const button = children[i];
+            const opt = col.options[i];
+            const optOffset = i * this.optHeight + y;
+            let transform = '';
+            if (rotateFactor !== 0) {
+                const rotateX = optOffset * rotateFactor;
+                if (Math.abs(rotateX) <= 90) {
+                    translateY = 0;
+                    translateZ = 90;
+                    transform = `rotateX(${rotateX}deg) `;
+                }
+                else {
+                    translateY = -9999;
+                }
+            }
+            else {
+                translateZ = 0;
+                translateY = optOffset;
+            }
+            const selected = selectedIndex === i;
+            transform += `translate3d(0px,${translateY}px,${translateZ}px) `;
+            if (this.scaleFactor !== 1 && !selected) {
+                transform += scaleStr;
+            }
+            // Update transition duration
+            if (this.noAnimate) {
+                opt.duration = 0;
+                button.style.transitionDuration = '';
+            }
+            else if (duration !== opt.duration) {
+                opt.duration = duration;
+                button.style.transitionDuration = durationStr;
+            }
+            // Update transform
+            if (transform !== opt.transform) {
+                opt.transform = transform;
+            }
+            button.style.transform = transform;
+            /**
+             * Ensure that the select column
+             * item has the selected class
+             */
+            opt.selected = selected;
+            if (selected) {
+                button.classList.add(PICKER_OPT_SELECTED);
+            }
+            else {
+                button.classList.remove(PICKER_OPT_SELECTED);
+            }
+        }
+        this.col.prevSelected = prevSelected;
+        if (saveY) {
+            this.y = y;
+        }
+        if (this.lastIndex !== selectedIndex) {
+            // have not set a last index yet
+            hapticSelectionChanged();
+            this.lastIndex = selectedIndex;
+        }
+    }
+    decelerate() {
+        if (this.velocity !== 0) {
+            // still decelerating
+            this.velocity *= DECELERATION_FRICTION;
+            // do not let it go slower than a velocity of 1
+            this.velocity = this.velocity > 0 ? Math.max(this.velocity, 1) : Math.min(this.velocity, -1);
+            let y = this.y + this.velocity;
+            if (y > this.minY) {
+                // whoops, it's trying to scroll up farther than the options we have!
+                y = this.minY;
+                this.velocity = 0;
+            }
+            else if (y < this.maxY) {
+                // gahh, it's trying to scroll down farther than we can!
+                y = this.maxY;
+                this.velocity = 0;
+            }
+            this.update(y, 0, true);
+            const notLockedIn = Math.round(y) % this.optHeight !== 0 || Math.abs(this.velocity) > 1;
+            if (notLockedIn) {
+                // isn't locked in yet, keep decelerating until it is
+                this.rafId = requestAnimationFrame(() => this.decelerate());
+            }
+            else {
+                this.velocity = 0;
+                this.emitColChange();
+                hapticSelectionEnd();
+            }
+        }
+        else if (this.y % this.optHeight !== 0) {
+            // needs to still get locked into a position so options line up
+            const currentPos = Math.abs(this.y % this.optHeight);
+            // create a velocity in the direction it needs to scroll
+            this.velocity = currentPos > this.optHeight / 2 ? 1 : -1;
+            this.decelerate();
+        }
+    }
+    indexForY(y) {
+        return Math.min(Math.max(Math.abs(Math.round(y / this.optHeight)), 0), this.col.options.length - 1);
+    }
+    onStart(detail) {
+        // We have to prevent default in order to block scrolling under the picker
+        // but we DO NOT have to stop propagation, since we still want
+        // some "click" events to capture
+        if (detail.event.cancelable) {
+            detail.event.preventDefault();
+        }
+        detail.event.stopPropagation();
+        hapticSelectionStart();
+        // reset everything
+        if (this.rafId !== undefined)
+            cancelAnimationFrame(this.rafId);
+        const options = this.col.options;
+        let minY = options.length - 1;
+        let maxY = 0;
+        for (let i = 0; i < options.length; i++) {
+            if (!options[i].disabled) {
+                minY = Math.min(minY, i);
+                maxY = Math.max(maxY, i);
+            }
+        }
+        this.minY = -(minY * this.optHeight);
+        this.maxY = -(maxY * this.optHeight);
+    }
+    onMove(detail) {
+        if (detail.event.cancelable) {
+            detail.event.preventDefault();
+        }
+        detail.event.stopPropagation();
+        // update the scroll position relative to pointer start position
+        let y = this.y + detail.deltaY;
+        if (y > this.minY) {
+            // scrolling up higher than scroll area
+            y = Math.pow(y, 0.8);
+            this.bounceFrom = y;
+        }
+        else if (y < this.maxY) {
+            // scrolling down below scroll area
+            y += Math.pow(this.maxY - y, 0.9);
+            this.bounceFrom = y;
+        }
+        else {
+            this.bounceFrom = 0;
+        }
+        this.update(y, 0, false);
+    }
+    onEnd(detail) {
+        if (this.bounceFrom > 0) {
+            // bounce back up
+            this.update(this.minY, 100, true);
+            this.emitColChange();
+            return;
+        }
+        else if (this.bounceFrom < 0) {
+            // bounce back down
+            this.update(this.maxY, 100, true);
+            this.emitColChange();
+            return;
+        }
+        this.velocity = clamp(-MAX_PICKER_SPEED, detail.velocityY * 23, MAX_PICKER_SPEED);
+        if (this.velocity === 0 && detail.deltaY === 0) {
+            const opt = detail.event.target.closest('.picker-opt');
+            if (opt === null || opt === void 0 ? void 0 : opt.hasAttribute('opt-index')) {
+                this.setSelected(parseInt(opt.getAttribute('opt-index'), 10), TRANSITION_DURATION);
+            }
+        }
+        else {
+            this.y += detail.deltaY;
+            if (Math.abs(detail.velocityY) < 0.05) {
+                const isScrollingUp = detail.deltaY > 0;
+                const optHeightFraction = (Math.abs(this.y) % this.optHeight) / this.optHeight;
+                if (isScrollingUp && optHeightFraction > 0.5) {
+                    this.velocity = Math.abs(this.velocity) * -1;
+                }
+                else if (!isScrollingUp && optHeightFraction <= 0.5) {
+                    this.velocity = Math.abs(this.velocity);
+                }
+            }
+            this.decelerate();
+        }
+    }
+    refresh(forceRefresh, animated) {
+        var _a;
+        let min = this.col.options.length - 1;
+        let max = 0;
+        const options = this.col.options;
+        for (let i = 0; i < options.length; i++) {
+            if (!options[i].disabled) {
+                min = Math.min(min, i);
+                max = Math.max(max, i);
+            }
+        }
+        /**
+         * Only update selected value if column has a
+         * velocity of 0. If it does not, then the
+         * column is animating might land on
+         * a value different than the value at
+         * selectedIndex
+         */
+        if (this.velocity !== 0) {
+            return;
+        }
+        const selectedIndex = clamp(min, (_a = this.col.selectedIndex) !== null && _a !== void 0 ? _a : 0, max);
+        if (this.col.prevSelected !== selectedIndex || forceRefresh) {
+            const y = selectedIndex * this.optHeight * -1;
+            const duration = animated ? TRANSITION_DURATION : 0;
+            this.velocity = 0;
+            this.update(y, duration, true);
+        }
+    }
+    onDomChange(forceRefresh, animated) {
+        const colEl = this.optsEl;
+        if (colEl) {
+            // DOM READ
+            // We perfom a DOM read over a rendered item, this needs to happen after the first render or after the the column has changed
+            this.optHeight = colEl.firstElementChild ? colEl.firstElementChild.clientHeight : 0;
+        }
+        this.refresh(forceRefresh, animated);
+    }
+    render() {
+        const col = this.col;
+        const mode = getIonMode(this);
+        return (h(Host, { class: Object.assign({ [mode]: true, 'picker-col': true, 'picker-opts-left': this.col.align === 'left', 'picker-opts-right': this.col.align === 'right' }, getClassMap(col.cssClass)), style: {
+                'max-width': this.col.columnWidth,
+            } }, col.prefix && (h("div", { class: "picker-prefix", style: { width: col.prefixWidth } }, col.prefix)), h("div", { class: "picker-opts", style: { maxWidth: col.optionsWidth }, ref: (el) => (this.optsEl = el) }, col.options.map((o, index) => (h("button", { "aria-label": o.ariaLabel, class: { 'picker-opt': true, 'picker-opt-disabled': !!o.disabled }, "opt-index": index }, o.text)))), col.suffix && (h("div", { class: "picker-suffix", style: { width: col.suffixWidth } }, col.suffix))));
+    }
+    static get is() { return "ion-picker-legacy-column"; }
+    static get originalStyleUrls() {
+        return {
+            "ios": ["picker-column.ios.scss"],
+            "md": ["picker-column.md.scss"]
+        };
+    }
+    static get styleUrls() {
+        return {
+            "ios": ["picker-column.ios.css"],
+            "md": ["picker-column.md.css"]
+        };
+    }
+    static get properties() {
+        return {
+            "col": {
+                "type": "unknown",
+                "mutable": false,
+                "complexType": {
+                    "original": "PickerColumn",
+                    "resolved": "PickerColumn",
+                    "references": {
+                        "PickerColumn": {
+                            "location": "import",
+                            "path": "../picker-legacy/picker-interface",
+                            "id": "src/components/picker-legacy/picker-interface.ts::PickerColumn"
+                        }
+                    }
+                },
+                "required": true,
+                "optional": false,
+                "docs": {
+                    "tags": [],
+                    "text": "Picker column data"
+                }
+            }
+        };
+    }
+    static get events() {
+        return [{
+                "method": "ionPickerColChange",
+                "name": "ionPickerColChange",
+                "bubbles": true,
+                "cancelable": true,
+                "composed": true,
+                "docs": {
+                    "tags": [{
+                            "name": "internal",
+                            "text": undefined
+                        }],
+                    "text": "Emitted when the selected value has changed"
+                },
+                "complexType": {
+                    "original": "PickerColumn",
+                    "resolved": "PickerColumn",
+                    "references": {
+                        "PickerColumn": {
+                            "location": "import",
+                            "path": "../picker-legacy/picker-interface",
+                            "id": "src/components/picker-legacy/picker-interface.ts::PickerColumn"
+                        }
+                    }
+                }
+            }];
+    }
+    static get elementRef() { return "el"; }
+    static get watchers() {
+        return [{
+                "propName": "col",
+                "methodName": "colChanged"
+            }];
+    }
+}
+const PICKER_OPT_SELECTED = 'picker-opt-selected';
+const DECELERATION_FRICTION = 0.97;
+const MAX_PICKER_SPEED = 90;
+const TRANSITION_DURATION = 150;

package/dist/collection/components/{picker-column → picker-legacy-column}/test/picker-column-aria.spec.js

@@ -25,10 +25,10 @@ describe('picker-column', () => {
         };
         const page = await newSpecPage({
             components: [PickerColumnCmp],
-            template: () => h("ion-picker-column", { col: col }),
+            template: () => h("ion-picker-legacy-column", { col: col }),
         });
-        const firstOption = page.body.querySelector('ion-picker-column .picker-opt:nth-child(1)');
-        const secondOption = page.body.querySelector('ion-picker-column .picker-opt:nth-child(2)');
+        const firstOption = page.body.querySelector('ion-picker-legacy-column .picker-opt:nth-child(1)');
+        const secondOption = page.body.querySelector('ion-picker-legacy-column .picker-opt:nth-child(2)');
         expect(firstOption.getAttribute('aria-label')).toBe('C Sharp');
         expect(secondOption.getAttribute('aria-label')).toBe(null);
     });

package/dist/collection/components/{picker-column → picker-legacy-column}/test/picker-column-dynamic.spec.js

@@ -15,9 +15,9 @@ describe('picker-column: dynamic options', () => {
         ];
         const page = await newSpecPage({
             components: [PickerColumnCmp],
-            template: () => h("ion-picker-column", { col: { options: defaultOptions, name: 'animals' } }),
+            template: () => (h("ion-picker-legacy-column", { col: { options: defaultOptions, name: 'animals' } })),
         });
-        const pickerCol = page.body.querySelector('ion-picker-column');
+        const pickerCol = page.body.querySelector('ion-picker-legacy-column');
         pickerCol.col = {
             options: [...defaultOptions, { text: 'Carrot', value: 'carrot' }],
             name: 'vegetables',

package/dist/collection/components/{picker-column → picker-legacy-column}/test/picker-column.spec.js

@@ -9,9 +9,9 @@ describe('picker-column', () => {
         const col = { cssClass: 'test-class', options: [], name: 'col' };
         const page = await newSpecPage({
             components: [PickerColumnCmp],
-            template: () => h("ion-picker-column", { col: col }),
+            template: () => h("ion-picker-legacy-column", { col: col }),
         });
-        const pickerCol = page.body.querySelector('ion-picker-column');
+        const pickerCol = page.body.querySelector('ion-picker-legacy-column');
         expect(pickerCol.classList.contains('test-class')).toBe(true);
     });
 });

package/dist/collection/components/{picker-column → picker-legacy-column}/test/standalone/picker-column.e2e.js

@@ -6,11 +6,11 @@ import { configs, test } from "../../../../utils/test/playwright/index";
 configs({ modes: ['ios'], directions: ['ltr'] }).forEach(({ title, config }) => {
     test.describe(title('picker-column'), () => {
         test.beforeEach(async ({ page }) => {
-            await page.goto(`/src/components/picker-column/test/standalone`, config);
+            await page.goto(`/src/components/picker-legacy-column/test/standalone`, config);
         });
         test('should present picker without ion-app', async ({ page }) => {
             const ionPickerDidPresent = await page.spyOnEvent('ionPickerDidPresent');
-            const picker = page.locator('ion-picker');
+            const picker = page.locator('ion-picker-legacy');
             await page.click('#single-column-button');
             await ionPickerDidPresent.next();
             await expect(picker).toBeVisible();
@@ -22,7 +22,7 @@ configs({ modes: ['ios'], directions: ['ltr'] }).forEach(({ title, config }) =>
             });
             const ionPickerDidPresent = await page.spyOnEvent('ionPickerDidPresent');
             const ionPickerColChangeEvent = await page.spyOnEvent('ionPickerColChange');
-            const column = page.locator('ion-picker-column');
+            const column = page.locator('ion-picker-legacy-column');
             const secondOption = column.locator('.picker-opt').nth(1);
             await page.click('#single-column-button');
             await ionPickerDidPresent.next();

package/dist/collection/components/refresher/refresher.utils.js

@@ -4,6 +4,7 @@
 import { writeTask } from "@stencil/core";
 import { createAnimation } from "../../utils/animation/animation";
 import { clamp, componentOnReady, transitionEndAsync } from "../../utils/helpers";
+import { isPlatform } from "../../utils/platform";
 export const getRefresherAnimationType = (contentEl) => {
     const previousSibling = contentEl.previousElementSibling;
     const hasHeader = previousSibling !== null && previousSibling.tagName === 'ION-HEADER';
@@ -161,24 +162,6 @@ export const translateElement = (el, value, duration = 200) => {
 };
 // Utils
 // -----------------------------
-/**
- * In order to use the native iOS refresher the device must support rubber band scrolling.
- * As part of this, we need to exclude Desktop Safari because it has a slightly different rubber band effect that is not compatible with the native refresher in Ionic.
- *
- * We also need to be careful not to include devices that spoof their user agent.
- * For example, when using iOS emulation in Chrome the user agent will be spoofed such that
- * navigator.maxTouchPointer > 0. To work around this,
- * we check to see if the apple-pay-logo is supported as a named image which is only
- * true on Apple devices.
- *
- * We previously checked referencEl.style.webkitOverflowScrolling to explicitly check
- * for rubber band support. However, this property was removed on iPadOS and it's possible
- * that this will be removed on iOS in the future too.
- *
- */
-export const supportsRubberBandScrolling = () => {
-    return navigator.maxTouchPoints > 0 && CSS.supports('background: -webkit-named-image(apple-pay-logo-black)');
-};
 export const shouldUseNativeRefresher = async (referenceEl, mode) => {
     const refresherContent = referenceEl.querySelector('ion-refresher-content');
     if (!refresherContent) {
@@ -189,5 +172,14 @@ export const shouldUseNativeRefresher = async (referenceEl, mode) => {
     const refreshingSpinner = referenceEl.querySelector('ion-refresher-content .refresher-refreshing ion-spinner');
     return (pullingSpinner !== null &&
         refreshingSpinner !== null &&
-        ((mode === 'ios' && supportsRubberBandScrolling()) || mode === 'md'));
+        /**
+         * We use webkitOverflowScrolling for feature detection with rubber band scrolling
+         * on iOS. When doing referenceEl.style, webkitOverflowScrolling is undefined on non-iOS platforms.
+         * However, it will be the empty string on iOS.
+         * Note that we do not use getPropertyValue (and thus need to cast as any) because calling
+         * getPropertyValue('-webkit-overflow-scrolling') will return the empty string if it is not
+         * set on the element, even if the platform does not support that.
+         */
+        ((mode === 'ios' && isPlatform('mobile') && referenceEl.style.webkitOverflowScrolling !== undefined) ||
+            mode === 'md'));
 };

package/dist/collection/components/refresher-content/refresher-content.js

@@ -3,11 +3,11 @@
  */
 import { Host, h } from "@stencil/core";
 import { ENABLE_HTML_CONTENT_DEFAULT } from "../../utils/config";
+import { isPlatform } from "../../utils/platform";
 import { sanitizeDOMString } from "../../utils/sanitization/index";
 import { arrowDown, caretBackSharp } from "ionicons/icons";
 import { config } from "../../global/config";
 import { getIonMode } from "../../global/ionic-global";
-import { supportsRubberBandScrolling } from "../refresher/refresher.utils";
 import { SPINNERS } from "../spinner/spinner-configs";
 export class RefresherContent {
     constructor() {
@@ -19,15 +19,9 @@ export class RefresherContent {
     }
     componentWillLoad() {
         if (this.pullingIcon === undefined) {
-            /**
-             * The native iOS refresher uses a spinner instead of
-             * an icon, so we need to see if this device supports
-             * the native iOS refresher.
-             */
-            const hasRubberBandScrolling = supportsRubberBandScrolling();
             const mode = getIonMode(this);
-            const overflowRefresher = hasRubberBandScrolling ? 'lines' : arrowDown;
-            this.pullingIcon = config.get('refreshingIcon', mode === 'ios' && hasRubberBandScrolling ? config.get('spinner', overflowRefresher) : 'circular');
+            const overflowRefresher = this.el.style.webkitOverflowScrolling !== undefined ? 'lines' : arrowDown;
+            this.pullingIcon = config.get('refreshingIcon', mode === 'ios' && isPlatform('mobile') ? config.get('spinner', overflowRefresher) : 'circular');
         }
         if (this.refreshingSpinner === undefined) {
             const mode = getIonMode(this);

package/dist/collection/components/searchbar/searchbar.js

@@ -180,6 +180,8 @@ export class Searchbar {
      *
      * Developers who wish to focus an input when an overlay is presented
      * should call `setFocus` after `didPresent` has resolved.
+     *
+     * See [managing focus](/docs/developing/managing-focus) for more information.
      */
     async setFocus() {
         if (this.nativeInput) {
@@ -890,7 +892,7 @@ export class Searchbar {
                     "return": "Promise<void>"
                 },
                 "docs": {
-                    "text": "Sets focus on the native `input` in `ion-searchbar`. Use this method instead of the global\n`input.focus()`.\n\nDevelopers who wish to focus an input when a page enters\nshould call `setFocus()` in the `ionViewDidEnter()` lifecycle method.\n\nDevelopers who wish to focus an input when an overlay is presented\nshould call `setFocus` after `didPresent` has resolved.",
+                    "text": "Sets focus on the native `input` in `ion-searchbar`. Use this method instead of the global\n`input.focus()`.\n\nDevelopers who wish to focus an input when a page enters\nshould call `setFocus()` in the `ionViewDidEnter()` lifecycle method.\n\nDevelopers who wish to focus an input when an overlay is presented\nshould call `setFocus` after `didPresent` has resolved.\n\nSee [managing focus](/docs/developing/managing-focus) for more information.",
                     "tags": []
                 }
             },

package/dist/collection/components/textarea/textarea.js

@@ -160,6 +160,8 @@ export class Textarea {
     /**
      * Sets focus on the native `textarea` in `ion-textarea`. Use this method instead of the global
      * `textarea.focus()`.
+     *
+     * See [managing focus](/docs/developing/managing-focus) for more information.
      */
     async setFocus() {
         if (this.nativeInput) {
@@ -448,7 +450,7 @@ Developers can use the "legacy" property to continue using the legacy form marku
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": "This Boolean attribute lets you specify that a form control should have input focus when the page loads."
+                    "text": "Sets the [`autofocus` attribute](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/autofocus) on the native input element.\n\nThis may not be sufficient for the element to be focused on page load. See [managing focus](/docs/developing/managing-focus) for more information."
                 },
                 "attribute": "autofocus",
                 "reflect": false,
@@ -1035,7 +1037,7 @@ Developers can use the "legacy" property to continue using the legacy form marku
                     "return": "Promise<void>"
                 },
                 "docs": {
-                    "text": "Sets focus on the native `textarea` in `ion-textarea`. Use this method instead of the global\n`textarea.focus()`.",
+                    "text": "Sets focus on the native `textarea` in `ion-textarea`. Use this method instead of the global\n`textarea.focus()`.\n\nSee [managing focus](/docs/developing/managing-focus) for more information.",
                     "tags": []
                 }
             },

package/dist/collection/utils/gesture/gesture-controller.js

@@ -189,5 +189,5 @@ class BlockerDelegate {
         this.ctrl = undefined;
     }
 }
-const BACKDROP_NO_SCROLL = 'backdrop-no-scroll';
+export const BACKDROP_NO_SCROLL = 'backdrop-no-scroll';
 export const GESTURE_CONTROLLER = new GestureController();