voyager-ionic-core 8.5.7 → 8.7.1

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

@@ -34,6 +34,59 @@ export class Range {
         this.inheritedAttributes = {};
         this.contentEl = null;
         this.initialContentScrollY = true;
+        this.ratioA = 0;
+        this.ratioB = 0;
+        /**
+         * The name of the control, which is submitted with the form data.
+         */
+        this.name = this.rangeId;
+        /**
+         * Show two knobs.
+         */
+        this.dualKnobs = false;
+        /**
+         * Minimum integer value of the range.
+         */
+        this.min = 0;
+        /**
+         * Maximum integer value of the range.
+         */
+        this.max = 100;
+        /**
+         * If `true`, a pin with integer value is shown when the knob
+         * is pressed.
+         */
+        this.pin = false;
+        /**
+         * A callback used to format the pin text.
+         * By default the pin text is set to `Math.round(value)`.
+         *
+         * See https://ionicframework.com/docs/troubleshooting/runtime#accessing-this
+         * if you need to access `this` from within the callback.
+         */
+        this.pinFormatter = (value) => Math.round(value);
+        /**
+         * If `true`, the knob snaps to tick marks evenly spaced based
+         * on the step property value.
+         */
+        this.snaps = false;
+        /**
+         * Specifies the value granularity.
+         */
+        this.step = 1;
+        /**
+         * If `true`, tick marks are displayed based on the step value.
+         * Only applies when `snaps` is `true`.
+         */
+        this.ticks = true;
+        /**
+         * If `true`, the user cannot interact with the range.
+         */
+        this.disabled = false;
+        /**
+         * the value of the range.
+         */
+        this.value = 0;
         /**
          * Compares two RangeValue inputs to determine if they are different.
          *
@@ -61,6 +114,14 @@ export class Range {
                 return this.clampBounds(value);
             }
         };
+        /**
+         * Where to place the label relative to the range.
+         * `"start"`: The label will appear to the left of the range in LTR and to the right in RTL.
+         * `"end"`: The label will appear to the right of the range in LTR and to the left in RTL.
+         * `"fixed"`: The label has the same behavior as `"start"` except it also has a fixed width. Long text will be truncated with ellipses ("...").
+         * `"stacked"`: The label will appear above the range regardless of the direction.
+         */
+        this.labelPlacement = 'start';
         this.setupGesture = async () => {
             const rangeSlider = this.rangeSlider;
             if (rangeSlider) {
@@ -113,25 +174,45 @@ export class Range {
                 this.ionFocus.emit();
             }
         };
-        this.ratioA = 0;
-        this.ratioB = 0;
-        this.pressedKnob = undefined;
-        this.color = undefined;
-        this.debounce = undefined;
-        this.name = this.rangeId;
-        this.label = undefined;
-        this.dualKnobs = false;
-        this.min = 0;
-        this.max = 100;
-        this.pin = false;
-        this.pinFormatter = (value) => Math.round(value);
-        this.snaps = false;
-        this.step = 1;
-        this.ticks = true;
-        this.activeBarStart = undefined;
-        this.disabled = false;
-        this.value = 0;
-        this.labelPlacement = 'start';
+        this.onKnobFocus = (knob) => {
+            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
+            // by delaying the reset to allow the new focus to register
+            setTimeout(() => {
+                var _a;
+                const activeElement = (_a = this.el.shadowRoot) === null || _a === void 0 ? void 0 : _a.activeElement;
+                const isStillFocusedOnKnob = activeElement && activeElement.classList.contains('range-knob-handle');
+                if (!isStillFocusedOnKnob) {
+                    if (this.hasFocus) {
+                        this.hasFocus = false;
+                        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);
+        };
     }
     debounceChanged() {
         const { ionInput, debounce, originalIonInput } = this;
@@ -564,6 +645,8 @@ export class Range {
             min,
             max,
             inheritedAttributes,
+            onKnobFocus: this.onKnobFocus,
+            onKnobBlur: this.onKnobBlur,
         }), this.dualKnobs &&
             renderKnob(rtl, {
                 knob: 'B',
@@ -577,6 +660,8 @@ export class Range {
                 min,
                 max,
                 inheritedAttributes,
+                onKnobFocus: this.onKnobFocus,
+                onKnobBlur: this.onKnobBlur,
             })));
     }
     render() {
@@ -596,7 +681,7 @@ export class Range {
         const needsEndAdjustment = inItem && !hasEndContent;
         const mode = getIonMode(this);
         renderHiddenInput(true, el, this.name, JSON.stringify(this.getValue()), disabled);
-        return (h(Host, { key: '3e065039ee048f1f70d97dba5dae98fa1315d867', onFocusin: this.onFocus, onFocusout: this.onBlur, id: rangeId, class: createColorClasses(this.color, {
+        return (h(Host, { key: 'ef7b01f80515bcaeb2983934ad7f10a6bd5d13ec', onFocusin: this.onFocus, onFocusout: this.onBlur, id: rangeId, class: createColorClasses(this.color, {
                 [mode]: true,
                 'in-item': inItem,
                 'range-disabled': disabled,
@@ -605,10 +690,10 @@ export class Range {
                 [`range-label-placement-${labelPlacement}`]: true,
                 'range-item-start-adjustment': needsStartAdjustment,
                 'range-item-end-adjustment': needsEndAdjustment,
-            }) }, h("label", { key: '27ff22842c9ea79a1b9495302b926f70c9080a95', class: "range-wrapper", id: "range-label" }, h("div", { key: 'da1f9784be02dfe87d2fef34931d8b7f2148189e', class: {
+            }) }, h("label", { key: 'fd8aa90a9d52be9da024b907e68858dae424449d', class: "range-wrapper", id: "range-label" }, h("div", { key: '2172b4f329c22017dd23475c80aac25ba6e753eb', 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: '4389bf30b08214f5b5917fc30976b38f7bcdd29b', class: "native-wrapper" }, h("slot", { key: 'ad1b2745f8b061ee189617bb5c567e4f1d02250c', name: "start" }), this.renderRangeSlider(), h("slot", { key: 'c6dec9e843e232af2a5f16a0f8ee56439c545d7a', name: "end" })))));
+            }, part: "label" }, label !== undefined ? h("div", { class: "label-text" }, label) : h("slot", { name: "label" })), h("div", { key: '3c318bf2ea0576646d4c010bf44573fd0f483186', class: "native-wrapper" }, h("slot", { key: '6586fd6fc96271e73f8a86c202d1913ad1a26f96', name: "start" }), this.renderRangeSlider(), h("slot", { key: '74ac0bc2d2cb66ef708bb729f88b6ecbc1b2155d', name: "end" })))));
     }
     static get is() { return "ion-range"; }
     static get encapsulation() { return "shadow"; }
@@ -628,6 +713,7 @@ export class Range {
         return {
             "color": {
                 "type": "string",
+                "attribute": "color",
                 "mutable": false,
                 "complexType": {
                     "original": "Color",
@@ -646,11 +732,13 @@ export class Range {
                     "tags": [],
                     "text": "The color to use from your application's color palette.\nDefault options are: `\"primary\"`, `\"secondary\"`, `\"tertiary\"`, `\"success\"`, `\"warning\"`, `\"danger\"`, `\"light\"`, `\"medium\"`, and `\"dark\"`.\nFor more information on colors, see [theming](/docs/theming/basics)."
                 },
-                "attribute": "color",
+                "getter": false,
+                "setter": false,
                 "reflect": true
             },
             "debounce": {
                 "type": "number",
+                "attribute": "debounce",
                 "mutable": false,
                 "complexType": {
                     "original": "number",
@@ -663,11 +751,13 @@ export class Range {
                     "tags": [],
                     "text": "How long, in milliseconds, to wait to trigger the\n`ionInput` event after each change in the range value."
                 },
-                "attribute": "debounce",
+                "getter": false,
+                "setter": false,
                 "reflect": false
             },
             "name": {
                 "type": "string",
+                "attribute": "name",
                 "mutable": false,
                 "complexType": {
                     "original": "string",
@@ -680,12 +770,14 @@ export class Range {
                     "tags": [],
                     "text": "The name of the control, which is submitted with the form data."
                 },
-                "attribute": "name",
+                "getter": false,
+                "setter": false,
                 "reflect": false,
                 "defaultValue": "this.rangeId"
             },
             "label": {
                 "type": "string",
+                "attribute": "label",
                 "mutable": false,
                 "complexType": {
                     "original": "string",
@@ -698,11 +790,13 @@ export class Range {
                     "tags": [],
                     "text": "The text to display as the control's label. Use this over the `label` slot if\nyou only need plain text. The `label` property will take priority over the\n`label` slot if both are used."
                 },
-                "attribute": "label",
+                "getter": false,
+                "setter": false,
                 "reflect": false
             },
             "dualKnobs": {
                 "type": "boolean",
+                "attribute": "dual-knobs",
                 "mutable": false,
                 "complexType": {
                     "original": "boolean",
@@ -715,12 +809,14 @@ export class Range {
                     "tags": [],
                     "text": "Show two knobs."
                 },
-                "attribute": "dual-knobs",
+                "getter": false,
+                "setter": false,
                 "reflect": false,
                 "defaultValue": "false"
             },
             "min": {
                 "type": "number",
+                "attribute": "min",
                 "mutable": false,
                 "complexType": {
                     "original": "number",
@@ -733,12 +829,14 @@ export class Range {
                     "tags": [],
                     "text": "Minimum integer value of the range."
                 },
-                "attribute": "min",
+                "getter": false,
+                "setter": false,
                 "reflect": false,
                 "defaultValue": "0"
             },
             "max": {
                 "type": "number",
+                "attribute": "max",
                 "mutable": false,
                 "complexType": {
                     "original": "number",
@@ -751,12 +849,14 @@ export class Range {
                     "tags": [],
                     "text": "Maximum integer value of the range."
                 },
-                "attribute": "max",
+                "getter": false,
+                "setter": false,
                 "reflect": false,
                 "defaultValue": "100"
             },
             "pin": {
                 "type": "boolean",
+                "attribute": "pin",
                 "mutable": false,
                 "complexType": {
                     "original": "boolean",
@@ -769,12 +869,14 @@ export class Range {
                     "tags": [],
                     "text": "If `true`, a pin with integer value is shown when the knob\nis pressed."
                 },
-                "attribute": "pin",
+                "getter": false,
+                "setter": false,
                 "reflect": false,
                 "defaultValue": "false"
             },
             "pinFormatter": {
                 "type": "unknown",
+                "attribute": "pin-formatter",
                 "mutable": false,
                 "complexType": {
                     "original": "PinFormatter",
@@ -793,10 +895,13 @@ export class Range {
                     "tags": [],
                     "text": "A callback used to format the pin text.\nBy default the pin text is set to `Math.round(value)`.\n\nSee https://ionicframework.com/docs/troubleshooting/runtime#accessing-this\nif you need to access `this` from within the callback."
                 },
+                "getter": false,
+                "setter": false,
                 "defaultValue": "(value: number): number => Math.round(value)"
             },
             "snaps": {
                 "type": "boolean",
+                "attribute": "snaps",
                 "mutable": false,
                 "complexType": {
                     "original": "boolean",
@@ -809,12 +914,14 @@ export class Range {
                     "tags": [],
                     "text": "If `true`, the knob snaps to tick marks evenly spaced based\non the step property value."
                 },
-                "attribute": "snaps",
+                "getter": false,
+                "setter": false,
                 "reflect": false,
                 "defaultValue": "false"
             },
             "step": {
                 "type": "number",
+                "attribute": "step",
                 "mutable": false,
                 "complexType": {
                     "original": "number",
@@ -827,12 +934,14 @@ export class Range {
                     "tags": [],
                     "text": "Specifies the value granularity."
                 },
-                "attribute": "step",
+                "getter": false,
+                "setter": false,
                 "reflect": false,
                 "defaultValue": "1"
             },
             "ticks": {
                 "type": "boolean",
+                "attribute": "ticks",
                 "mutable": false,
                 "complexType": {
                     "original": "boolean",
@@ -845,12 +954,14 @@ export class Range {
                     "tags": [],
                     "text": "If `true`, tick marks are displayed based on the step value.\nOnly applies when `snaps` is `true`."
                 },
-                "attribute": "ticks",
+                "getter": false,
+                "setter": false,
                 "reflect": false,
                 "defaultValue": "true"
             },
             "activeBarStart": {
                 "type": "number",
+                "attribute": "active-bar-start",
                 "mutable": true,
                 "complexType": {
                     "original": "number",
@@ -863,11 +974,13 @@ export class Range {
                     "tags": [],
                     "text": "The start position of the range active bar. This feature is only available with a single knob (dualKnobs=\"false\").\nValid values are greater than or equal to the min value and less than or equal to the max value."
                 },
-                "attribute": "active-bar-start",
+                "getter": false,
+                "setter": false,
                 "reflect": false
             },
             "disabled": {
                 "type": "boolean",
+                "attribute": "disabled",
                 "mutable": false,
                 "complexType": {
                     "original": "boolean",
@@ -880,12 +993,14 @@ export class Range {
                     "tags": [],
                     "text": "If `true`, the user cannot interact with the range."
                 },
-                "attribute": "disabled",
+                "getter": false,
+                "setter": false,
                 "reflect": false,
                 "defaultValue": "false"
             },
             "value": {
                 "type": "number",
+                "attribute": "value",
                 "mutable": true,
                 "complexType": {
                     "original": "RangeValue",
@@ -904,12 +1019,14 @@ export class Range {
                     "tags": [],
                     "text": "the value of the range."
                 },
-                "attribute": "value",
+                "getter": false,
+                "setter": false,
                 "reflect": false,
                 "defaultValue": "0"
             },
             "labelPlacement": {
                 "type": "string",
+                "attribute": "label-placement",
                 "mutable": false,
                 "complexType": {
                     "original": "'start' | 'end' | 'fixed' | 'stacked'",
@@ -922,7 +1039,8 @@ export class Range {
                     "tags": [],
                     "text": "Where to place the label relative to the range.\n`\"start\"`: The label will appear to the left of the range in LTR and to the right in RTL.\n`\"end\"`: The label will appear to the right of the range in LTR and to the left in RTL.\n`\"fixed\"`: The label has the same behavior as `\"start\"` except it also has a fixed width. Long text will be truncated with ellipses (\"...\").\n`\"stacked\"`: The label will appear above the range regardless of the direction."
                 },
-                "attribute": "label-placement",
+                "getter": false,
+                "setter": false,
                 "reflect": false,
                 "defaultValue": "'start'"
             }
@@ -1078,7 +1196,7 @@ export class Range {
             }];
     }
 }
-const renderKnob = (rtl, { knob, value, ratio, min, max, disabled, pressed, pin, handleKeyboard, pinFormatter, inheritedAttributes }) => {
+const renderKnob = (rtl, { knob, value, ratio, min, max, disabled, pressed, pin, handleKeyboard, pinFormatter, inheritedAttributes, onKnobFocus, onKnobBlur, }) => {
     const start = rtl ? 'right' : 'left';
     const knobStyle = () => {
         const style = {};
@@ -1099,7 +1217,7 @@ const renderKnob = (rtl, { knob, value, ratio, min, max, disabled, pressed, pin,
                 ev.preventDefault();
                 ev.stopPropagation();
             }
-        }, class: {
+        }, onFocus: () => onKnobFocus(knob), onBlur: onKnobBlur, class: {
             'range-knob-handle': true,
             'range-knob-a': knob === 'A',
             'range-knob-b': knob === 'B',

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

@@ -24,12 +24,62 @@ export class Refresher {
         this.lastVelocityY = 0;
         this.animations = [];
         this.nativeRefresher = false;
+        /**
+         * The current state which the refresher is in. The refresher's states include:
+         *
+         * - `inactive` - The refresher is not being pulled down or refreshing and is currently hidden.
+         * - `pulling` - The user is actively pulling down the refresher, but has not reached the point yet that if the user lets go, it'll refresh.
+         * - `cancelling` - The user pulled down the refresher and let go, but did not pull down far enough to kick off the `refreshing` state. After letting go, the refresher is in the `cancelling` state while it is closing, and will go back to the `inactive` state once closed.
+         * - `ready` - The user has pulled down the refresher far enough that if they let go, it'll begin the `refreshing` state.
+         * - `refreshing` - The refresher is actively waiting on the async operation to end. Once the refresh handler calls `complete()` it will begin the `completing` state.
+         * - `completing` - The `refreshing` state has finished and the refresher is in the way of closing itself. Once closed, the refresher will go back to the `inactive` state.
+         */
         this.state = 1 /* RefresherState.Inactive */;
+        /**
+         * The minimum distance the user must pull down until the
+         * refresher will go into the `refreshing` state.
+         * Does not apply when the refresher content uses a spinner,
+         * enabling the native refresher.
+         */
         this.pullMin = 60;
+        /**
+         * The maximum distance of the pull until the refresher
+         * will automatically go into the `refreshing` state.
+         * Defaults to the result of `pullMin + 60`.
+         * Does not apply when  the refresher content uses a spinner,
+         * enabling the native refresher.
+         */
         this.pullMax = this.pullMin + 60;
+        /**
+         * Time it takes to close the refresher.
+         * Does not apply when the refresher content uses a spinner,
+         * enabling the native refresher.
+         */
         this.closeDuration = '280ms';
+        /**
+         * Time it takes the refresher to snap back to the `refreshing` state.
+         * Does not apply when the refresher content uses a spinner,
+         * enabling the native refresher.
+         */
         this.snapbackDuration = '280ms';
+        /**
+         * How much to multiply the pull speed by. To slow the pull animation down,
+         * pass a number less than `1`. To speed up the pull, pass a number greater
+         * 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
+         * (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.
+         *
+         * Does not apply when the refresher content uses a spinner,
+         * enabling the native refresher.
+         */
         this.pullFactor = 1;
+        /**
+         * If `true`, the refresher will be hidden.
+         */
         this.disabled = false;
     }
     disabledChanged() {
@@ -622,7 +672,7 @@ export class Refresher {
     }
     render() {
         const mode = getIonMode(this);
-        return (h(Host, { key: 'c717c16f2ca3e42351848cc8ad37918dec28961d', slot: "fixed", class: {
+        return (h(Host, { key: '8c7a5cc32da02a9cbeaa954258148683f60a6d1b', slot: "fixed", class: {
                 [mode]: true,
                 // Used internally for styling
                 [`refresher-${mode}`]: true,
@@ -652,6 +702,7 @@ export class Refresher {
         return {
             "pullMin": {
                 "type": "number",
+                "attribute": "pull-min",
                 "mutable": false,
                 "complexType": {
                     "original": "number",
@@ -664,12 +715,14 @@ export class Refresher {
                     "tags": [],
                     "text": "The minimum distance the user must pull down until the\nrefresher will go into the `refreshing` state.\nDoes not apply when the refresher content uses a spinner,\nenabling the native refresher."
                 },
-                "attribute": "pull-min",
+                "getter": false,
+                "setter": false,
                 "reflect": false,
                 "defaultValue": "60"
             },
             "pullMax": {
                 "type": "number",
+                "attribute": "pull-max",
                 "mutable": false,
                 "complexType": {
                     "original": "number",
@@ -682,12 +735,14 @@ export class Refresher {
                     "tags": [],
                     "text": "The maximum distance of the pull until the refresher\nwill automatically go into the `refreshing` state.\nDefaults to the result of `pullMin + 60`.\nDoes not apply when  the refresher content uses a spinner,\nenabling the native refresher."
                 },
-                "attribute": "pull-max",
+                "getter": false,
+                "setter": false,
                 "reflect": false,
                 "defaultValue": "this.pullMin + 60"
             },
             "closeDuration": {
                 "type": "string",
+                "attribute": "close-duration",
                 "mutable": false,
                 "complexType": {
                     "original": "string",
@@ -700,12 +755,14 @@ export class Refresher {
                     "tags": [],
                     "text": "Time it takes to close the refresher.\nDoes not apply when the refresher content uses a spinner,\nenabling the native refresher."
                 },
-                "attribute": "close-duration",
+                "getter": false,
+                "setter": false,
                 "reflect": false,
                 "defaultValue": "'280ms'"
             },
             "snapbackDuration": {
                 "type": "string",
+                "attribute": "snapback-duration",
                 "mutable": false,
                 "complexType": {
                     "original": "string",
@@ -718,12 +775,14 @@ export class Refresher {
                     "tags": [],
                     "text": "Time it takes the refresher to snap back to the `refreshing` state.\nDoes not apply when the refresher content uses a spinner,\nenabling the native refresher."
                 },
-                "attribute": "snapback-duration",
+                "getter": false,
+                "setter": false,
                 "reflect": false,
                 "defaultValue": "'280ms'"
             },
             "pullFactor": {
                 "type": "number",
+                "attribute": "pull-factor",
                 "mutable": false,
                 "complexType": {
                     "original": "number",
@@ -736,12 +795,14 @@ export class Refresher {
                     "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."
                 },
-                "attribute": "pull-factor",
+                "getter": false,
+                "setter": false,
                 "reflect": false,
                 "defaultValue": "1"
             },
             "disabled": {
                 "type": "boolean",
+                "attribute": "disabled",
                 "mutable": false,
                 "complexType": {
                     "original": "boolean",
@@ -754,7 +815,8 @@ export class Refresher {
                     "tags": [],
                     "text": "If `true`, the refresher will be hidden."
                 },
-                "attribute": "disabled",
+                "getter": false,
+                "setter": false,
                 "reflect": false,
                 "defaultValue": "false"
             }