@ionic/core 8.7.17-dev.11771870864.19b2cde1 → 8.7.17-dev.11771959013.18adabe2

package/dist/collection/components/range/range.js

@@ -1,7 +1,7 @@
 /*!
  * (C) Ionic http://ionicframework.com - MIT License
  */
-import { Host, h } from "@stencil/core";
+import { Build, Host, h } from "@stencil/core";
 import { findClosestIonContent, disableContentScrollY, resetContentScrollY } from "../../utils/content/index";
 import { inheritAriaAttributes, clamp, debounceEvent, renderHiddenInput, isSafeNumber } from "../../utils/helpers";
 import { printIonWarning } from "../../utils/logging/index";
@@ -17,13 +17,30 @@ import { roundToMaxDecimalPlaces } from "../../utils/floating-point";
  * @slot start - Content is placed to the left of the range slider in LTR, and to the right in RTL.
  * @slot end - Content is placed to the right of the range slider in LTR, and to the left in RTL.
  *
+ * @part label - The label text describing the range.
  * @part tick - An inactive tick mark.
  * @part tick-active - An active tick mark.
- * @part pin - The counter that appears above a knob.
- * @part knob - The handle that is used to drag the range.
  * @part bar - The inactive part of the bar.
  * @part bar-active - The active part of the bar.
- * @part label - The label text describing the range.
+ * @part knob-handle - The container element that wraps the knob and handles drag interactions.
+ * @part knob-handle-a - The container element for the first knob. Only available when `dualKnobs` is `true`.
+ * @part knob-handle-b - The container element for the second knob. Only available when `dualKnobs` is `true`.
+ * @part knob-handle-lower - The container element for the lower knob. Only available when `dualKnobs` is `true`.
+ * @part knob-handle-upper - The container element for the upper knob. Only available when `dualKnobs` is `true`.
+ * @part pin - The counter that appears above a knob.
+ * @part pin-a - The counter that appears above the first knob. Only available when `dualKnobs` is `true`.
+ * @part pin-b - The counter that appears above the second knob. Only available when `dualKnobs` is `true`.
+ * @part pin-lower - The counter that appears above the lower knob. Only available when `dualKnobs` is `true`.
+ * @part pin-upper - The counter that appears above the upper knob. Only available when `dualKnobs` is `true`.
+ * @part knob - The visual knob element that appears on the range track.
+ * @part knob-a - The visual knob element for the first knob. Only available when `dualKnobs` is `true`.
+ * @part knob-b - The visual knob element for the second knob. Only available when `dualKnobs` is `true`.
+ * @part knob-lower - The visual knob element for the lower knob. Only available when `dualKnobs` is `true`.
+ * @part knob-upper - The visual knob element for the upper knob. Only available when `dualKnobs` is `true`.
+ * @part activated - Added to the knob-handle, knob, and pin when the knob is activated (has the `ion-activated` class). Only one set has this part at a time when `dualKnobs` is `true`.
+ * @part focused - Added to the knob-handle, knob, and pin that currently has focus. Only one set has this part at a time when `dualKnobs` is `true`.
+ * @part hover - Added to the knob-handle, knob, and pin when the knob has hover. Only one set has this part at a time when `dualKnobs` is `true`.
+ * @part pressed - Added to the knob-handle, knob, and pin that is currently being pressed to drag. Only one set has this part at a time when `dualKnobs` is `true`.
  */
 export class Range {
     constructor() {
@@ -34,6 +51,7 @@ export class Range {
         this.inheritedAttributes = {};
         this.contentEl = null;
         this.initialContentScrollY = true;
+        this.focusFromPointer = false;
         this.ratioA = 0;
         this.ratioB = 0;
         /**
@@ -143,6 +161,31 @@ export class Range {
                 this.gesture.enable(!this.disabled);
             }
         };
+        /**
+         * Observes the knob handles for the ion-activated class and syncs
+         * activatedKnob so the activated part is correctly set on the handle,
+         * knob, and pin.
+         */
+        this.setupActivatedObserver = () => {
+            const knobHandleA = this.el.shadowRoot.querySelector('.range-knob-handle-a');
+            const knobHandleB = this.el.shadowRoot.querySelector('.range-knob-handle-b');
+            const syncActivated = () => {
+                this.activatedKnob = (knobHandleA === null || knobHandleA === void 0 ? void 0 : knobHandleA.classList.contains('ion-activated'))
+                    ? 'A'
+                    : (knobHandleB === null || knobHandleB === void 0 ? void 0 : knobHandleB.classList.contains('ion-activated'))
+                        ? 'B'
+                        : undefined;
+            };
+            if (Build.isBrowser && typeof MutationObserver !== 'undefined') {
+                this.activatedObserver = new MutationObserver(syncActivated);
+                this.activatedObserver.observe(this.el.shadowRoot, {
+                    attributes: true,
+                    attributeFilter: ['class'],
+                    subtree: true,
+                });
+            }
+            syncActivated();
+        };
         this.handleKeyboard = (knob, isIncrease) => {
             const { ensureValueInBounds } = this;
             let step = this.step;
@@ -165,6 +208,7 @@ export class Range {
         this.onBlur = () => {
             if (this.hasFocus) {
                 this.hasFocus = false;
+                this.focusedKnob = undefined;
                 this.ionBlur.emit();
             }
         };
@@ -175,21 +219,20 @@ export class Range {
             }
         };
         this.onKnobFocus = (knob) => {
+            // Clicking focuses the range which is needed for the keyboard,
+            // but we only want to add the ion-focused class when focused via Tab.
+            if (!this.focusFromPointer) {
+                this.focusedKnob = knob;
+            }
+            else {
+                this.focusFromPointer = false;
+                this.focusedKnob = undefined;
+            }
+            // If the knob was not already focused, emit the focus event
             if (!this.hasFocus) {
                 this.hasFocus = true;
                 this.ionFocus.emit();
             }
-            // Manually manage ion-focused class for dual knobs
-            if (this.dualKnobs && this.el.shadowRoot) {
-                const knobA = this.el.shadowRoot.querySelector('.range-knob-a');
-                const knobB = this.el.shadowRoot.querySelector('.range-knob-b');
-                // Remove ion-focused from both knobs first
-                knobA === null || knobA === void 0 ? void 0 : knobA.classList.remove('ion-focused');
-                knobB === null || knobB === void 0 ? void 0 : knobB.classList.remove('ion-focused');
-                // Add ion-focused only to the focused knob
-                const focusedKnobEl = knob === 'A' ? knobA : knobB;
-                focusedKnobEl === null || focusedKnobEl === void 0 ? void 0 : focusedKnobEl.classList.add('ion-focused');
-            }
         };
         this.onKnobBlur = () => {
             // Check if focus is moving to another knob within the same range
@@ -201,18 +244,18 @@ export class Range {
                 if (!isStillFocusedOnKnob) {
                     if (this.hasFocus) {
                         this.hasFocus = false;
+                        this.focusedKnob = undefined;
                         this.ionBlur.emit();
                     }
-                    // Remove ion-focused from both knobs when focus leaves the range
-                    if (this.dualKnobs && this.el.shadowRoot) {
-                        const knobA = this.el.shadowRoot.querySelector('.range-knob-a');
-                        const knobB = this.el.shadowRoot.querySelector('.range-knob-b');
-                        knobA === null || knobA === void 0 ? void 0 : knobA.classList.remove('ion-focused');
-                        knobB === null || knobB === void 0 ? void 0 : knobB.classList.remove('ion-focused');
-                    }
                 }
             }, 0);
         };
+        this.onKnobMouseEnter = (knob) => {
+            this.hoveredKnob = knob;
+        };
+        this.onKnobMouseLeave = () => {
+            this.hoveredKnob = undefined;
+        };
     }
     debounceChanged() {
         const { ionInput, debounce, originalIonInput } = this;
@@ -289,6 +332,7 @@ export class Range {
         this.originalIonInput = this.ionInput;
         this.setupGesture();
         this.updateRatio();
+        this.setupActivatedObserver();
         this.didLoad = true;
     }
     connectedCallback() {
@@ -314,6 +358,10 @@ export class Range {
             this.gesture.destroy();
             this.gesture = undefined;
         }
+        if (this.activatedObserver) {
+            this.activatedObserver.disconnect();
+            this.activatedObserver = undefined;
+        }
     }
     getValue() {
         var _a;
@@ -466,7 +514,6 @@ export class Range {
             ratio = 1 - ratio;
         }
         this.pressedKnob = !this.dualKnobs || Math.abs(this.ratioA - ratio) < Math.abs(this.ratioB - ratio) ? 'A' : 'B';
-        this.setFocus(this.pressedKnob);
     }
     get valA() {
         return ratioToValue(this.ratioA, this.min, this.max, this.step);
@@ -493,9 +540,23 @@ export class Range {
     updateRatio() {
         const value = this.getValue();
         const { min, max } = this;
+        /**
+         * For dual knobs, value gives lower/upper but not which is A vs B.
+         * Assign (lowerRatio, upperRatio) to (ratioA, ratioB) in the way that
+         * minimizes change from the current ratios so the knobs don't swap.
+         */
         if (this.dualKnobs) {
-            this.ratioA = valueToRatio(value.lower, min, max);
-            this.ratioB = valueToRatio(value.upper, min, max);
+            const lowerRatio = valueToRatio(value.lower, min, max);
+            const upperRatio = valueToRatio(value.upper, min, max);
+            if (Math.abs(this.ratioA - lowerRatio) + Math.abs(this.ratioB - upperRatio) <=
+                Math.abs(this.ratioA - upperRatio) + Math.abs(this.ratioB - lowerRatio)) {
+                this.ratioA = lowerRatio;
+                this.ratioB = upperRatio;
+            }
+            else {
+                this.ratioA = upperRatio;
+                this.ratioB = lowerRatio;
+            }
         }
         else {
             this.ratioA = valueToRatio(value, min, max);
@@ -512,14 +573,6 @@ export class Range {
             };
         this.noUpdate = false;
     }
-    setFocus(knob) {
-        if (this.el.shadowRoot) {
-            const knobEl = this.el.shadowRoot.querySelector(knob === 'A' ? '.range-knob-a' : '.range-knob-b');
-            if (knobEl) {
-                knobEl.focus();
-            }
-        }
-    }
     /**
      * Returns true if content was passed to the "start" slot
      */
@@ -537,7 +590,7 @@ export class Range {
     }
     renderRangeSlider() {
         var _a;
-        const { min, max, step, handleKeyboard, pressedKnob, disabled, pin, ratioLower, ratioUpper, pinFormatter, inheritedAttributes, } = this;
+        const { min, max, step, handleKeyboard, activatedKnob, focusedKnob, hoveredKnob, pressedKnob, disabled, pin, ratioLower, ratioUpper, pinFormatter, inheritedAttributes, } = this;
         let barStart = `${ratioLower * 100}%`;
         let barEnd = `${100 - ratioUpper * 100}%`;
         const rtl = isRTL(this.el);
@@ -597,7 +650,9 @@ export class Range {
                 ticks.push(tick);
             }
         }
-        return (h("div", { class: "range-slider", ref: (rangeEl) => (this.rangeSlider = rangeEl),
+        return (h("div", { class: "range-slider", ref: (rangeEl) => (this.rangeSlider = rangeEl), onPointerDown: () => {
+                this.focusFromPointer = true;
+            },
             /**
              * Since the gesture has a threshold, the value
              * won't change until the user has dragged past
@@ -610,6 +665,7 @@ export class Range {
              * we need to listen for the "pointerUp" event.
              */
             onPointerUp: (ev) => {
+                this.focusFromPointer = false;
                 /**
                  * If the user drags the knob on the web
                  * version (does not occur on mobile),
@@ -635,6 +691,11 @@ export class Range {
                 'has-ticks': ticks.length > 0,
             }, role: "presentation", style: barStyle, part: "bar-active" })), renderKnob(rtl, {
             knob: 'A',
+            position: getKnobPosition('A', this.ratioA, this.ratioB, this.dualKnobs),
+            dualKnobs: this.dualKnobs,
+            activated: activatedKnob === 'A',
+            focused: focusedKnob === 'A',
+            hovered: hoveredKnob === 'A',
             pressed: pressedKnob === 'A',
             value: this.valA,
             ratio: this.ratioA,
@@ -647,9 +708,16 @@ export class Range {
             inheritedAttributes,
             onKnobFocus: this.onKnobFocus,
             onKnobBlur: this.onKnobBlur,
+            onKnobMouseEnter: this.onKnobMouseEnter,
+            onKnobMouseLeave: this.onKnobMouseLeave,
         }), this.dualKnobs &&
             renderKnob(rtl, {
                 knob: 'B',
+                position: getKnobPosition('B', this.ratioA, this.ratioB, this.dualKnobs),
+                dualKnobs: this.dualKnobs,
+                activated: activatedKnob === 'B',
+                focused: focusedKnob === 'B',
+                hovered: hoveredKnob === 'B',
                 pressed: pressedKnob === 'B',
                 value: this.valB,
                 ratio: this.ratioB,
@@ -662,6 +730,8 @@ export class Range {
                 inheritedAttributes,
                 onKnobFocus: this.onKnobFocus,
                 onKnobBlur: this.onKnobBlur,
+                onKnobMouseEnter: this.onKnobMouseEnter,
+                onKnobMouseLeave: this.onKnobMouseLeave,
             })));
     }
     render() {
@@ -680,6 +750,12 @@ export class Range {
         const hasEndContent = (hasLabel && labelPlacement === 'end') || this.hasEndSlotContent;
         const needsEndAdjustment = inItem && !hasEndContent;
         const mode = getIonMode(this);
+        /**
+         * Determine the name and position of the pressed knob to apply
+         * Host classes for styling.
+         */
+        const pressedKnobName = dualKnobs ? pressedKnob === null || pressedKnob === void 0 ? void 0 : pressedKnob.toLowerCase() : undefined;
+        const pressedKnobPosition = dualKnobs && pressedKnob ? getKnobPosition(pressedKnob, this.ratioA, this.ratioB, dualKnobs) : undefined;
         /**
          * Determine if any knob is at the min or max value to
          * apply Host classes for styling.
@@ -687,21 +763,24 @@ export class Range {
         const valueAtMin = dualKnobs ? this.valA === min || this.valB === min : this.valA === min;
         const valueAtMax = dualKnobs ? this.valA === max || this.valB === max : this.valA === max;
         renderHiddenInput(true, el, this.name, JSON.stringify(this.getValue()), disabled);
-        return (h(Host, { key: 'ed646a42d51b8fe22012198c354cbcf5a389c108', onFocusin: this.onFocus, onFocusout: this.onBlur, id: rangeId, class: createColorClasses(this.color, {
+        return (h(Host, { key: '3d87901f6acf5848e1891e387f9042e2a1e3f91e', onFocusin: this.onFocus, onFocusout: this.onBlur, id: rangeId, class: createColorClasses(this.color, {
                 [mode]: true,
                 'in-item': inItem,
                 'range-disabled': disabled,
+                'range-dual-knobs': dualKnobs,
                 'range-pressed': pressedKnob !== undefined,
+                [`range-pressed-${pressedKnobName}`]: pressedKnob !== undefined && pressedKnobName !== undefined,
+                [`range-pressed-${pressedKnobPosition}`]: pressedKnob !== undefined && pressedKnobPosition !== undefined,
                 'range-has-pin': pin,
                 [`range-label-placement-${labelPlacement}`]: true,
                 'range-item-start-adjustment': needsStartAdjustment,
                 'range-item-end-adjustment': needsEndAdjustment,
                 'range-value-min': valueAtMin,
                 'range-value-max': valueAtMax,
-            }) }, h("label", { key: '3083e4f2a624e3b268396acb4415f7c6ac44d851', class: "range-wrapper", id: "range-label" }, h("div", { key: '47b92f94d2a0381dd7c5cd3dda54ed2942096715', class: {
+            }) }, h("label", { key: '33a3fa985121811828dcfa4244edd73c28d18182', class: "range-wrapper", id: "range-label" }, h("div", { key: '36cd13d03e67fee8c92ade30ac1d3c6ae7a32126', class: {
                 'label-text-wrapper': true,
                 'label-text-wrapper-hidden': !hasLabel,
-            }, part: "label" }, label !== undefined ? h("div", { class: "label-text" }, label) : h("slot", { name: "label" })), h("div", { key: '5341da8d19eb29091df680978a0e20cc8f2eec65', class: "native-wrapper" }, h("slot", { key: '09f1437078032676695442d8c827a16faa7dffe2', name: "start" }), this.renderRangeSlider(), h("slot", { key: '02b7781970ea4d44f10b5f4627a2ca36eca45f85', name: "end" })))));
+            }, part: "label" }, label !== undefined ? h("div", { class: "label-text" }, label) : h("slot", { name: "label" })), h("div", { key: '1650c180246f80340f0313b16dbdd8eae7451fb5', class: "native-wrapper" }, h("slot", { key: 'ca73ff66e30a49056d76cbd3007ece207ca5261d', name: "start" }), this.renderRangeSlider(), h("slot", { key: '59a90b1f4fd4a6879c90bb46d20f8df53d8456f6', name: "end" })))));
     }
     static get is() { return "ion-range"; }
     static get encapsulation() { return "shadow"; }
@@ -729,7 +808,8 @@ export class Range {
                         "Color": {
                             "location": "import",
                             "path": "../../interface",
-                            "id": "src/interface.d.ts::Color"
+                            "id": "src/interface.d.ts::Color",
+                            "referenceLocation": "Color"
                         }
                     }
                 },
@@ -892,7 +972,8 @@ export class Range {
                         "PinFormatter": {
                             "location": "import",
                             "path": "./range-interface",
-                            "id": "src/components/range/range-interface.ts::PinFormatter"
+                            "id": "src/components/range/range-interface.ts::PinFormatter",
+                            "referenceLocation": "PinFormatter"
                         }
                     }
                 },
@@ -1015,7 +1096,8 @@ export class Range {
                         "RangeValue": {
                             "location": "import",
                             "path": "./range-interface",
-                            "id": "src/components/range/range-interface.ts::RangeValue"
+                            "id": "src/components/range/range-interface.ts::RangeValue",
+                            "referenceLocation": "RangeValue"
                         }
                     }
                 },
@@ -1057,6 +1139,9 @@ export class Range {
         return {
             "ratioA": {},
             "ratioB": {},
+            "activatedKnob": {},
+            "focusedKnob": {},
+            "hoveredKnob": {},
             "pressedKnob": {}
         };
     }
@@ -1078,7 +1163,8 @@ export class Range {
                         "RangeChangeEventDetail": {
                             "location": "import",
                             "path": "./range-interface",
-                            "id": "src/components/range/range-interface.ts::RangeChangeEventDetail"
+                            "id": "src/components/range/range-interface.ts::RangeChangeEventDetail",
+                            "referenceLocation": "RangeChangeEventDetail"
                         }
                     }
                 }
@@ -1099,7 +1185,8 @@ export class Range {
                         "RangeChangeEventDetail": {
                             "location": "import",
                             "path": "./range-interface",
-                            "id": "src/components/range/range-interface.ts::RangeChangeEventDetail"
+                            "id": "src/components/range/range-interface.ts::RangeChangeEventDetail",
+                            "referenceLocation": "RangeChangeEventDetail"
                         }
                     }
                 }
@@ -1150,7 +1237,8 @@ export class Range {
                         "RangeKnobMoveStartEventDetail": {
                             "location": "import",
                             "path": "./range-interface",
-                            "id": "src/components/range/range-interface.ts::RangeKnobMoveStartEventDetail"
+                            "id": "src/components/range/range-interface.ts::RangeKnobMoveStartEventDetail",
+                            "referenceLocation": "RangeKnobMoveStartEventDetail"
                         }
                     }
                 }
@@ -1171,7 +1259,8 @@ export class Range {
                         "RangeKnobMoveEndEventDetail": {
                             "location": "import",
                             "path": "./range-interface",
-                            "id": "src/components/range/range-interface.ts::RangeKnobMoveEndEventDetail"
+                            "id": "src/components/range/range-interface.ts::RangeKnobMoveEndEventDetail",
+                            "referenceLocation": "RangeKnobMoveEndEventDetail"
                         }
                     }
                 }
@@ -1203,7 +1292,7 @@ export class Range {
             }];
     }
 }
-const renderKnob = (rtl, { knob, value, ratio, min, max, disabled, pressed, pin, handleKeyboard, pinFormatter, inheritedAttributes, onKnobFocus, onKnobBlur, }) => {
+const renderKnob = (rtl, { knob, position, dualKnobs, value, ratio, min, max, disabled, activated, focused, hovered, pressed, pin, handleKeyboard, pinFormatter, inheritedAttributes, onKnobFocus, onKnobBlur, onKnobMouseEnter, onKnobMouseLeave, }) => {
     const start = rtl ? 'right' : 'left';
     const knobStyle = () => {
         const style = {};
@@ -1224,16 +1313,66 @@ const renderKnob = (rtl, { knob, value, ratio, min, max, disabled, pressed, pin,
                 ev.preventDefault();
                 ev.stopPropagation();
             }
-        }, onFocus: () => onKnobFocus(knob), onBlur: onKnobBlur, class: {
+        }, onFocus: () => onKnobFocus(knob), onBlur: onKnobBlur, onMouseEnter: () => onKnobMouseEnter(knob), onMouseLeave: onKnobMouseLeave, class: {
             'range-knob-handle': true,
-            'range-knob-a': knob === 'A',
-            'range-knob-b': knob === 'B',
+            'range-knob-handle-a': knob === 'A',
+            'range-knob-handle-b': knob === 'B',
             'range-knob-pressed': pressed,
             'range-knob-min': value === min,
             'range-knob-max': value === max,
             'ion-activatable': true,
             'ion-focusable': true,
-        }, style: knobStyle(), role: "slider", tabindex: disabled ? -1 : 0, "aria-label": ariaLabel !== undefined ? ariaLabel : null, "aria-labelledby": ariaLabel === undefined ? 'range-label' : null, "aria-valuemin": min, "aria-valuemax": max, "aria-disabled": disabled ? 'true' : null, "aria-valuenow": value }, pin && (h("div", { class: "range-pin", role: "presentation", part: "pin" }, pinFormatter(value))), h("div", { class: "range-knob", role: "presentation", part: "knob" })));
+            'ion-focused': focused,
+        }, part: [
+            'knob-handle',
+            dualKnobs && knob === 'A' && 'knob-handle-a',
+            dualKnobs && knob === 'B' && 'knob-handle-b',
+            dualKnobs && position === 'lower' && 'knob-handle-lower',
+            dualKnobs && position === 'upper' && 'knob-handle-upper',
+            pressed && 'pressed',
+            focused && 'focused',
+            hovered && 'hover',
+            activated && 'activated',
+        ]
+            .filter(Boolean)
+            .join(' '), style: knobStyle(), role: "slider", tabindex: disabled ? -1 : 0, "aria-label": ariaLabel !== undefined ? ariaLabel : null, "aria-labelledby": ariaLabel === undefined ? 'range-label' : null, "aria-valuemin": min, "aria-valuemax": max, "aria-disabled": disabled ? 'true' : null, "aria-valuenow": value }, pin && (h("div", { class: "range-pin", role: "presentation", part: [
+            'pin',
+            dualKnobs && knob === 'A' && 'pin-a',
+            dualKnobs && knob === 'B' && 'pin-b',
+            dualKnobs && position === 'lower' && 'pin-lower',
+            dualKnobs && position === 'upper' && 'pin-upper',
+            pressed && 'pressed',
+            focused && 'focused',
+            hovered && 'hover',
+            activated && 'activated',
+        ]
+            .filter(Boolean)
+            .join(' ') }, pinFormatter(value))), h("div", { class: "range-knob", role: "presentation", part: [
+            'knob',
+            dualKnobs && knob === 'A' && 'knob-a',
+            dualKnobs && knob === 'B' && 'knob-b',
+            dualKnobs && position === 'lower' && 'knob-lower',
+            dualKnobs && position === 'upper' && 'knob-upper',
+            pressed && 'pressed',
+            focused && 'focused',
+            hovered && 'hover',
+            activated && 'activated',
+        ]
+            .filter(Boolean)
+            .join(' ') })));
+};
+/**
+ * Returns whether the given knob is at the lower or upper position based
+ * on current ratios for the given knob.
+ */
+const getKnobPosition = (knob, ratioA, ratioB, dualKnobs) => {
+    if (dualKnobs) {
+        if (knob === 'A') {
+            return ratioA <= ratioB ? 'lower' : 'upper';
+        }
+        return ratioB <= ratioA ? 'lower' : 'upper';
+    }
+    return 'lower';
 };
 const ratioToValue = (ratio, min, max, step) => {
     let value = (max - min) * ratio;

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

@@ -68,8 +68,8 @@ export class Refresher {
          * than `1`. The default value is `1` which is equal to the speed of the cursor.
          * If a negative value is passed in, the factor will be `1` instead.
          *
-         * For example: If the value passed is `1.2` and the content is dragged by
-         * `10` pixels, instead of `10` pixels the content will be pulled by `12` pixels
+         * For example, If the value passed is `1.2` and the content is dragged by
+         * `10` pixels, instead of `10` pixels, the content will be pulled by `12` pixels
          * (an increase of 20 percent). If the value passed is `0.8`, the dragged amount
          * will be `8` pixels, less than the amount the cursor has moved.
          *
@@ -119,6 +119,9 @@ export class Refresher {
         this.animations = [];
         this.progress = 0;
         this.state = 1 /* RefresherState.Inactive */;
+        this.ionPullEnd.emit({
+            reason: state === 32 /* RefresherState.Completing */ ? 'complete' : 'cancel',
+        });
     }
     async setupiOSNativeRefresher(pullingSpinner, refreshingSpinner) {
         this.elementToTransform = this.scrollEl;
@@ -151,6 +154,7 @@ export class Refresher {
                     if (!this.didStart) {
                         this.didStart = true;
                         this.ionStart.emit();
+                        this.ionPullStart.emit();
                     }
                     // emit "pulling" on every move
                     if (this.pointerDown) {
@@ -226,6 +230,7 @@ export class Refresher {
                 this.lastVelocityY = ev.velocityY;
             },
             onEnd: () => {
+                const hadStarted = this.didStart;
                 this.pointerDown = false;
                 this.didStart = false;
                 if (this.needsCompletion) {
@@ -235,6 +240,13 @@ export class Refresher {
                 else if (this.didRefresh) {
                     readTask(() => translateElement(this.elementToTransform, `${this.el.clientHeight}px`));
                 }
+                else if (hadStarted) {
+                    /**
+                     * User started pulling but released before reaching the refresh threshold.
+                     * Emit ionPullEnd to complete the event pair.
+                     */
+                    this.ionPullEnd.emit({ reason: 'cancel' });
+                }
             },
         });
         this.disabledChanged();
@@ -281,6 +293,7 @@ export class Refresher {
                     ev.data.animation = animation;
                     animation.progressStart(false, 0);
                     this.ionStart.emit();
+                    this.ionPullStart.emit();
                     this.animations.push(animation);
                     return;
                 }
@@ -303,6 +316,7 @@ export class Refresher {
                         this.animations = [];
                         this.gesture.enable(true);
                         this.state = 1 /* RefresherState.Inactive */;
+                        this.ionPullEnd.emit({ reason: 'cancel' });
                     });
                     return;
                 }
@@ -547,6 +561,7 @@ export class Refresher {
         if (!this.didStart) {
             this.didStart = true;
             this.ionStart.emit();
+            this.ionPullStart.emit();
         }
         // emit "pulling" on every move
         this.ionPull.emit();
@@ -590,6 +605,15 @@ export class Refresher {
              * available right away.
              */
             this.restoreOverflowStyle();
+            /**
+             * If ionPullStart was emitted, we need to emit ionPullEnd
+             * even though the gesture was aborted before reaching the
+             * pulling threshold.
+             */
+            if (this.didStart) {
+                this.didStart = false;
+                this.ionPullEnd.emit({ reason: 'cancel' });
+            }
         }
     }
     beginRefresh() {
@@ -636,6 +660,9 @@ export class Refresher {
             if (this.contentFullscreen && this.backgroundContentEl) {
                 (_a = this.backgroundContentEl) === null || _a === void 0 ? void 0 : _a.style.removeProperty('--offset-top');
             }
+            this.ionPullEnd.emit({
+                reason: state === 32 /* RefresherState.Completing */ ? 'complete' : 'cancel',
+            });
         }, 600);
         // reset the styles on the scroll element
         // set that the refresh is actively cancelling/completing
@@ -689,7 +716,7 @@ export class Refresher {
     }
     render() {
         const mode = getIonMode(this);
-        return (h(Host, { key: '2d1bd880877b698604542ab2d602d38b9504d975', slot: "fixed", class: {
+        return (h(Host, { key: 'bed0c2f44c32ecac24b7d8326ac7c7ef1d12c44f', slot: "fixed", class: {
                 [mode]: true,
                 // Used internally for styling
                 [`refresher-${mode}`]: true,
@@ -809,7 +836,7 @@ export class Refresher {
                 "optional": false,
                 "docs": {
                     "tags": [],
-                    "text": "How much to multiply the pull speed by. To slow the pull animation down,\npass a number less than `1`. To speed up the pull, pass a number greater\nthan `1`. The default value is `1` which is equal to the speed of the cursor.\nIf a negative value is passed in, the factor will be `1` instead.\n\nFor example: If the value passed is `1.2` and the content is dragged by\n`10` pixels, instead of `10` pixels the content will be pulled by `12` pixels\n(an increase of 20 percent). If the value passed is `0.8`, the dragged amount\nwill be `8` pixels, less than the amount the cursor has moved.\n\nDoes not apply when the refresher content uses a spinner,\nenabling the native refresher."
+                    "text": "How much to multiply the pull speed by. To slow the pull animation down,\npass a number less than `1`. To speed up the pull, pass a number greater\nthan `1`. The default value is `1` which is equal to the speed of the cursor.\nIf a negative value is passed in, the factor will be `1` instead.\n\nFor example, If the value passed is `1.2` and the content is dragged by\n`10` pixels, instead of `10` pixels, the content will be pulled by `12` pixels\n(an increase of 20 percent). If the value passed is `0.8`, the dragged amount\nwill be `8` pixels, less than the amount the cursor has moved.\n\nDoes not apply when the refresher content uses a spinner,\nenabling the native refresher."
                 },
                 "getter": false,
                 "setter": false,
@@ -863,7 +890,8 @@ export class Refresher {
                         "RefresherEventDetail": {
                             "location": "import",
                             "path": "./refresher-interface",
-                            "id": "src/components/refresher/refresher-interface.ts::RefresherEventDetail"
+                            "id": "src/components/refresher/refresher-interface.ts::RefresherEventDetail",
+                            "referenceLocation": "RefresherEventDetail"
                         }
                     }
                 }
@@ -888,6 +916,24 @@ export class Refresher {
                 "bubbles": true,
                 "cancelable": true,
                 "composed": true,
+                "docs": {
+                    "tags": [{
+                            "name": "deprecated",
+                            "text": "Use `ionPullStart` instead."
+                        }],
+                    "text": "Emitted when the user begins to start pulling down.\nTODO(FW-7044): Remove this in a major release"
+                },
+                "complexType": {
+                    "original": "void",
+                    "resolved": "void",
+                    "references": {}
+                }
+            }, {
+                "method": "ionPullStart",
+                "name": "ionPullStart",
+                "bubbles": true,
+                "cancelable": true,
+                "composed": true,
                 "docs": {
                     "tags": [],
                     "text": "Emitted when the user begins to start pulling down."
@@ -897,6 +943,28 @@ export class Refresher {
                     "resolved": "void",
                     "references": {}
                 }
+            }, {
+                "method": "ionPullEnd",
+                "name": "ionPullEnd",
+                "bubbles": true,
+                "cancelable": true,
+                "composed": true,
+                "docs": {
+                    "tags": [],
+                    "text": "Emitted when the refresher has returned to the inactive state\nafter a pull gesture. This fires whether the refresh completed\nsuccessfully or was canceled."
+                },
+                "complexType": {
+                    "original": "RefresherPullEndEventDetail",
+                    "resolved": "RefresherPullEndEventDetail",
+                    "references": {
+                        "RefresherPullEndEventDetail": {
+                            "location": "import",
+                            "path": "./refresher-interface",
+                            "id": "src/components/refresher/refresher-interface.ts::RefresherPullEndEventDetail",
+                            "referenceLocation": "RefresherPullEndEventDetail"
+                        }
+                    }
+                }
             }];
     }
     static get methods() {