@ionic/core 8.8.20-dev.11787158518.168a2fea → 8.8.20-dev.11789504012.1a675914

package/dist/collection/components/input-otp/input-otp.js

@@ -1,140 +1,384 @@
 /*!
  * (C) Ionic http://ionicframework.com - MIT License
  */
-import { Fragment, Host, h } from "@stencil/core";
+import { Fragment, Host, h, } from "@stencil/core";
+import { reportValidityToElementInternals } from "../../utils/forms/index";
 import { inheritAriaAttributes } from "../../utils/helpers";
 import { printIonWarning } from "../../utils/logging/index";
 import { isRTL } from "../../utils/rtl/index";
 import { createColorClasses } from "../../utils/theme";
 import { getIonMode } from "../../global/ionic-global";
+/**
+ * @virtualProp {"ios" | "md"} mode - The mode determines the platform behaviors of the component.
+ * @virtualProp {"ios" | "md" | "ionic"} theme - The theme determines the visual appearance of the component.
+ *
+ * @part group - The container element that wraps all input boxes.
+ * @part container - The wrapper element for each individual input box.
+ * @part native - The native input element.
+ * @part separator - The separator element displayed between input boxes.
+ * @part description - The container element for the description text.
+ */
 export class InputOTP {
-    inheritedAttributes = {};
-    inputRefs = [];
-    inputId = `ion-input-otp-${inputIds++}`;
-    parsedSeparators = [];
-    /**
-     * Stores the initial value of the input when it receives focus.
-     * Used to determine if the value changed during the focus session
-     * to avoid emitting unnecessary change events on blur.
-     */
-    focusedValue;
-    /**
-     * Tracks whether the user is navigating through input boxes using keyboard navigation
-     * (arrow keys, tab) versus mouse clicks. This is used to determine the appropriate
-     * focus behavior when an input box is focused.
-     */
-    isKeyboardNavigation = false;
-    el;
-    inputValues = [];
-    hasFocus = false;
-    previousInputValues = [];
-    /**
-     * Indicates whether and how the text value should be automatically capitalized as it is entered/edited by the user.
-     * Available options: `"off"`, `"none"`, `"on"`, `"sentences"`, `"words"`, `"characters"`.
-     */
-    autocapitalize = 'off';
-    /**
-     * The color to use from your application's color palette.
-     * Default options are: `"primary"`, `"secondary"`, `"tertiary"`, `"success"`, `"warning"`, `"danger"`, `"light"`, `"medium"`, and `"dark"`.
-     * For more information on colors, see [theming](/docs/theming/basics).
-     */
-    color;
-    /**
-     * If `true`, the user cannot interact with the input.
-     */
-    disabled = false;
-    /**
-     * The fill for the input boxes. If `"solid"` the input boxes will have a background. If
-     * `"outline"` the input boxes will be transparent with a border.
-     */
-    fill = 'outline';
-    /**
-     * A hint to the browser for which keyboard to display.
-     * Possible values: `"none"`, `"text"`, `"tel"`, `"url"`,
-     * `"email"`, `"numeric"`, `"decimal"`, and `"search"`.
-     *
-     * For numbers (type="number"): "numeric"
-     * For text (type="text"): "text"
-     */
-    inputmode;
-    /**
-     * The number of input boxes to display.
-     */
-    length = 4;
-    /**
-     * A regex pattern string for allowed characters. Defaults based on type.
-     *
-     * For numbers (`type="number"`): `"[\p{N}]"`
-     * For text (`type="text"`): `"[\p{L}\p{N}]"`
-     */
-    pattern;
-    /**
-     * If `true`, the user cannot modify the value.
-     */
-    readonly = false;
-    /**
-     * Where separators should be shown between input boxes.
-     * Can be a comma-separated string or an array of numbers.
-     *
-     * For example:
-     * `"3"` will show a separator after the 3rd input box.
-     * `[1,4]` will show a separator after the 1st and 4th input boxes.
-     * `"all"` will show a separator between every input box.
-     */
-    separators;
-    /**
-     * The shape of the input boxes.
-     * If "round" they will have an increased border radius.
-     * If "rectangular" they will have no border radius.
-     * If "soft" they will have a soft border radius.
-     */
-    shape = 'round';
-    /**
-     * The size of the input boxes.
-     */
-    size = 'medium';
-    /**
-     * The type of input allowed in the input boxes.
-     */
-    type = 'number';
-    /**
-     * The value of the input group.
-     */
-    value = '';
-    /**
-     * The `ionInput` event is fired each time the user modifies the input's value.
-     * Unlike the `ionChange` event, the `ionInput` event is fired for each alteration
-     * to the input's value. This typically happens for each keystroke as the user types.
-     *
-     * For elements that accept text input (`type=text`, `type=tel`, etc.), the interface
-     * is [`InputEvent`](https://developer.mozilla.org/en-US/docs/Web/API/InputEvent); for others,
-     * the interface is [`Event`](https://developer.mozilla.org/en-US/docs/Web/API/Event). If
-     * the input is cleared on edit, the type is `null`.
-     */
-    ionInput;
-    /**
-     * The `ionChange` event is fired when the user modifies the input's value.
-     * Unlike the `ionInput` event, the `ionChange` event is only fired when changes
-     * are committed, not as the user types.
-     *
-     * The `ionChange` event fires when the `<ion-input-otp>` component loses
-     * focus after its value has changed.
-     *
-     * This event will not emit when programmatically setting the `value` property.
-     */
-    ionChange;
-    /**
-     * Emitted when all input boxes have been filled with valid values.
-     */
-    ionComplete;
-    /**
-     * Emitted when the input group loses focus.
-     */
-    ionBlur;
+    constructor() {
+        this.inheritedAttributes = {};
+        this.inputRefs = [];
+        this.inputId = `ion-input-otp-${inputIds++}`;
+        this.parsedSeparators = [];
+        /**
+         * Tracks whether the user is navigating through input boxes using keyboard navigation
+         * (arrow keys, tab) versus mouse clicks. This is used to determine the appropriate
+         * focus behavior when an input box is focused.
+         */
+        this.isKeyboardNavigation = false;
+        this.inputValues = [];
+        this.hasFocus = false;
+        this.previousInputValues = [];
+        /**
+         * Indicates whether and how the text value should be automatically capitalized as it is entered/edited by the user.
+         * Available options: `"off"`, `"none"`, `"on"`, `"sentences"`, `"words"`, `"characters"`.
+         */
+        this.autocapitalize = 'off';
+        /**
+         * If `true`, the user cannot interact with the input.
+         */
+        this.disabled = false;
+        /**
+         * The fill for the input boxes. If `"solid"` the input boxes will have a background. If
+         * `"outline"` the input boxes will be transparent with a border.
+         */
+        this.fill = 'outline';
+        /**
+         * The number of input boxes to display.
+         */
+        this.length = 4;
+        /**
+         * If `true`, the user cannot modify the value.
+         */
+        this.readonly = false;
+        /**
+         * The shape of the input boxes.
+         * If "round" they will have an increased border radius.
+         * If "rectangular" they will have no border radius.
+         * If "soft" they will have a soft border radius.
+         */
+        this.shape = 'round';
+        /**
+         * The size of the input boxes.
+         */
+        this.size = 'medium';
+        /**
+         * The type of input allowed in the input boxes.
+         */
+        this.type = 'number';
+        /**
+         * The value of the input group.
+         */
+        this.value = '';
+        /**
+         * Handles the focus behavior for the input OTP component.
+         *
+         * Focus behavior:
+         * 1. Keyboard navigation: Allow normal focus movement
+         * 2. Mouse click:
+         *    - If clicked box has value: Focus that box
+         *    - If clicked box is empty: Focus first empty box
+         *
+         * Emits the `ionFocus` event when the input group gains focus.
+         */
+        this.onFocus = (index) => (event) => {
+            var _a;
+            const { inputRefs } = this;
+            // Only emit ionFocus and set the focusedValue when the
+            // component first gains focus
+            if (!this.hasFocus) {
+                this.ionFocus.emit(event);
+                this.focusedValue = this.value;
+            }
+            this.hasFocus = true;
+            let finalIndex = index;
+            if (!this.isKeyboardNavigation) {
+                // If the clicked box has a value, focus it
+                // Otherwise focus the first empty box
+                const targetIndex = this.inputValues[index] ? index : this.getFirstEmptyIndex();
+                finalIndex = targetIndex === -1 ? this.length - 1 : targetIndex;
+                // Focus the target box
+                (_a = this.inputRefs[finalIndex]) === null || _a === void 0 ? void 0 : _a.focus();
+            }
+            // Update tabIndexes to match the focused box
+            inputRefs.forEach((input, i) => {
+                input.tabIndex = i === finalIndex ? 0 : -1;
+            });
+            // Reset the keyboard navigation flag
+            this.isKeyboardNavigation = false;
+        };
+        /**
+         * Handles the blur behavior for the input OTP component.
+         * Emits the `ionBlur` event when the input group loses focus.
+         */
+        this.onBlur = (event) => {
+            const { inputRefs } = this;
+            const relatedTarget = event.relatedTarget;
+            // Do not emit blur if we're moving to another input box in the same component
+            const isInternalFocus = relatedTarget != null && inputRefs.includes(relatedTarget);
+            if (!isInternalFocus) {
+                this.hasFocus = false;
+                // Reset tabIndexes when focus leaves the component
+                this.updateTabIndexes();
+                // Always emit ionBlur when focus leaves the component
+                this.ionBlur.emit(event);
+                // Only emit ionChange if the value has actually changed
+                if (this.focusedValue !== this.value) {
+                    this.emitIonChange(event);
+                }
+            }
+        };
+        /**
+         * Handles keyboard navigation for the OTP component.
+         *
+         * Navigation:
+         * - Backspace: Clears current input and moves to previous box if empty
+         * - Arrow Left/Right: Moves focus between input boxes
+         * - Tab: Allows normal tab navigation between components
+         */
+        this.onKeyDown = (index) => (event) => {
+            const { disabled, length, readonly } = this;
+            const rtl = isRTL(this.el);
+            const input = event.target;
+            if (disabled) {
+                return;
+            }
+            if (readonly) {
+                if (event.key === 'Backspace' || event.key === 'Delete') {
+                    event.preventDefault();
+                    return;
+                }
+            }
+            // Meta shortcuts are used to copy, paste, and select text
+            // We don't want to handle these keys here
+            const metaShortcuts = ['a', 'c', 'v', 'x', 'r', 'z', 'y'];
+            const isTextSelection = input.selectionStart !== input.selectionEnd;
+            // Return if the key is a meta shortcut or the input value
+            // text is selected and let the onPaste / onInput handler manage it
+            if (isTextSelection || ((event.metaKey || event.ctrlKey) && metaShortcuts.includes(event.key.toLowerCase()))) {
+                return;
+            }
+            if (event.key === 'Backspace') {
+                if (this.inputValues[index]) {
+                    // Shift all values to the right of the current index left by one
+                    for (let i = index; i < length - 1; i++) {
+                        this.inputValues[i] = this.inputValues[i + 1];
+                    }
+                    // Clear the last box
+                    this.inputValues[length - 1] = '';
+                    // Update all inputRefs to match inputValues
+                    for (let i = 0; i < length; i++) {
+                        this.inputRefs[i].value = this.inputValues[i] || '';
+                    }
+                    this.updateValue(event);
+                    event.preventDefault();
+                }
+                else if (!this.inputValues[index] && index > 0) {
+                    // If current input is empty, move to previous input
+                    this.focusPrevious(index);
+                }
+            }
+            else if (event.key === 'ArrowLeft' || event.key === 'ArrowRight') {
+                this.isKeyboardNavigation = true;
+                event.preventDefault();
+                const isLeft = event.key === 'ArrowLeft';
+                const shouldMoveNext = (isLeft && rtl) || (!isLeft && !rtl);
+                // Only allow moving to the next input if the current has a value
+                if (shouldMoveNext) {
+                    if (this.inputValues[index] && index < length - 1) {
+                        this.focusNext(index);
+                    }
+                }
+                else {
+                    this.focusPrevious(index);
+                }
+            }
+            else if (event.key === 'Tab') {
+                this.isKeyboardNavigation = true;
+                // Let all tab events proceed normally
+                return;
+            }
+        };
+        /**
+         * Processes all input scenarios for each input box.
+         *
+         * This function manages:
+         * 1. Autofill handling
+         * 2. Input validation
+         * 3. Full selection replacement or typing in an empty box
+         * 4. Inserting in the middle with available space (shifting)
+         * 5. Single character replacement
+         */
+        this.onInput = (index) => (event) => {
+            var _a, _b;
+            const { disabled, length, readonly, validKeyPattern } = this;
+            const input = event.target;
+            const value = input.value;
+            const previousValue = this.previousInputValues[index] || '';
+            if (disabled || readonly) {
+                return;
+            }
+            // 1. Autofill handling
+            // If the length of the value increases by more than 1 from the previous
+            // value, treat this as autofill. This is to prevent the case where the
+            // user is typing a single character into an input box containing a value
+            // as that will trigger this function with a value length of 2 characters.
+            const isAutofill = value.length - previousValue.length > 1;
+            if (isAutofill) {
+                // Distribute valid characters across input boxes
+                const validChars = value
+                    .split('')
+                    .filter((char) => validKeyPattern.test(char))
+                    .slice(0, length);
+                // If there are no valid characters coming from the
+                // autofill, all input refs have to be cleared after the
+                // browser has finished the autofill behavior
+                if (validChars.length === 0) {
+                    requestAnimationFrame(() => {
+                        this.inputRefs.forEach((input) => {
+                            input.value = '';
+                        });
+                    });
+                }
+                for (let i = 0; i < length; i++) {
+                    this.inputValues[i] = validChars[i] || '';
+                    this.inputRefs[i].value = validChars[i] || '';
+                }
+                this.updateValue(event);
+                // Focus the first empty input box or the last input box if all boxes
+                // are filled after a small delay to ensure the input boxes have been
+                // updated before moving the focus
+                setTimeout(() => {
+                    var _a;
+                    const nextIndex = validChars.length < length ? validChars.length : length - 1;
+                    (_a = this.inputRefs[nextIndex]) === null || _a === void 0 ? void 0 : _a.focus();
+                }, 20);
+                this.previousInputValues = [...this.inputValues];
+                return;
+            }
+            // 2. Input validation
+            // If the character entered is invalid (does not match the pattern),
+            // restore the previous value and exit
+            if (value.length > 0 && !validKeyPattern.test(value[value.length - 1])) {
+                input.value = this.inputValues[index] || '';
+                this.previousInputValues = [...this.inputValues];
+                return;
+            }
+            // 3. Full selection replacement or typing in an empty box
+            // If the user selects all text in the input box and types, or if the
+            // input box is empty, replace only this input box. If the box is empty,
+            // move to the next box, otherwise stay focused on this box.
+            const isAllSelected = input.selectionStart === 0 && input.selectionEnd === value.length;
+            const isEmpty = !this.inputValues[index];
+            if (isAllSelected || isEmpty) {
+                this.inputValues[index] = value;
+                input.value = value;
+                this.updateValue(event);
+                this.focusNext(index);
+                this.previousInputValues = [...this.inputValues];
+                return;
+            }
+            // 4. Inserting in the middle with available space (shifting)
+            // If typing in a filled input box and there are empty boxes at the end,
+            // shift all values starting at the current box to the right, and insert
+            // the new character at the current box.
+            const hasAvailableBoxAtEnd = this.inputValues[this.inputValues.length - 1] === '';
+            if (this.inputValues[index] && hasAvailableBoxAtEnd && value.length === 2) {
+                // Get the inserted character (from event or by diffing value/previousValue)
+                let newChar = event.data;
+                if (!newChar) {
+                    newChar = value.split('').find((c, i) => c !== previousValue[i]) || value[value.length - 1];
+                }
+                // Validate the new character before shifting
+                if (!validKeyPattern.test(newChar)) {
+                    input.value = this.inputValues[index] || '';
+                    this.previousInputValues = [...this.inputValues];
+                    return;
+                }
+                // Shift values right from the end to the insertion point
+                for (let i = this.inputValues.length - 1; i > index; i--) {
+                    this.inputValues[i] = this.inputValues[i - 1];
+                    this.inputRefs[i].value = this.inputValues[i] || '';
+                }
+                this.inputValues[index] = newChar;
+                this.inputRefs[index].value = newChar;
+                this.updateValue(event);
+                this.previousInputValues = [...this.inputValues];
+                return;
+            }
+            // 5. Single character replacement
+            // Handles replacing a single character in a box containing a value based
+            // on the cursor position. We need the cursor position to determine which
+            // character was the last character typed. For example, if the user types "2"
+            // in an input box with the cursor at the beginning of the value of "6",
+            // the value will be "26", but we want to grab the "2" as the last character
+            // typed.
+            const cursorPos = (_a = input.selectionStart) !== null && _a !== void 0 ? _a : value.length;
+            const newCharIndex = cursorPos - 1;
+            const newChar = (_b = value[newCharIndex]) !== null && _b !== void 0 ? _b : value[0];
+            // Check if the new character is valid before updating the value
+            if (!validKeyPattern.test(newChar)) {
+                input.value = this.inputValues[index] || '';
+                this.previousInputValues = [...this.inputValues];
+                return;
+            }
+            this.inputValues[index] = newChar;
+            input.value = newChar;
+            this.updateValue(event);
+            this.previousInputValues = [...this.inputValues];
+        };
+        /**
+         * Handles pasting text into the input OTP component.
+         * This function prevents the default paste behavior and
+         * validates the pasted text against the allowed pattern.
+         * It then updates the value of the input group and focuses
+         * the next empty input after pasting.
+         */
+        this.onPaste = (event) => {
+            var _a, _b;
+            const { disabled, inputRefs, length, readonly, validKeyPattern } = this;
+            event.preventDefault();
+            if (disabled || readonly) {
+                return;
+            }
+            const pastedText = (_a = event.clipboardData) === null || _a === void 0 ? void 0 : _a.getData('text');
+            // If there is no pasted text, still emit the input change event
+            // because this is how the native input element behaves
+            // but return early because there is nothing to paste.
+            if (!pastedText) {
+                this.emitIonInput(event);
+                return;
+            }
+            const validChars = pastedText
+                .split('')
+                .filter((char) => validKeyPattern.test(char))
+                .slice(0, length);
+            // Always paste starting at the first box
+            validChars.forEach((char, index) => {
+                if (index < length) {
+                    this.inputRefs[index].value = char;
+                    this.inputValues[index] = char;
+                }
+            });
+            // Update the value so that all input boxes are updated
+            this.value = validChars.join('');
+            this.updateValue(event);
+            // Focus the next empty input after pasting
+            // If all boxes are filled, focus the last input
+            const nextEmptyIndex = validChars.length < length ? validChars.length : length - 1;
+            (_b = inputRefs[nextEmptyIndex]) === null || _b === void 0 ? void 0 : _b.focus();
+        };
+    }
     /**
-     * Emitted when the input group has focus.
+     * Update element internals when disabled prop changes
      */
-    ionFocus;
+    disabledChanged() {
+        this.updateElementInternals();
+    }
     /**
      * Sets focus to an input box.
      * @param index - The index of the input box to focus (0-based).
@@ -142,18 +386,20 @@ export class InputOTP {
      * Otherwise, the first empty input box or the last input if all are filled will be focused.
      */
     async setFocus(index) {
+        var _a, _b;
         if (typeof index === 'number') {
             const validIndex = Math.max(0, Math.min(index, this.length - 1));
-            this.inputRefs[validIndex]?.focus();
+            (_a = this.inputRefs[validIndex]) === null || _a === void 0 ? void 0 : _a.focus();
         }
         else {
             const tabbableIndex = this.getTabbableIndex();
-            this.inputRefs[tabbableIndex]?.focus();
+            (_b = this.inputRefs[tabbableIndex]) === null || _b === void 0 ? void 0 : _b.focus();
         }
     }
     valueChanged() {
         this.initializeValues();
         this.updateTabIndexes();
+        this.updateElementInternals();
     }
     /**
      * Processes the separators prop into an array of numbers.
@@ -210,6 +456,7 @@ export class InputOTP {
     }
     componentDidLoad() {
         this.updateTabIndexes();
+        this.updateElementInternals();
     }
     /**
      * Get the regex pattern for allowed characters.
@@ -286,6 +533,47 @@ export class InputOTP {
             this.ionComplete.emit({ value: newValue });
         }
     }
+    /**
+     * Gets the value of the input group as a string for form submission.
+     * Returns an empty string if the value is null or undefined.
+     */
+    getValue() {
+        return this.value != null ? this.value.toString() : '';
+    }
+    /**
+     * Called when the form state is restored.
+     * Restores the component's value.
+     */
+    formStateRestoreCallback(value) {
+        this.value = value;
+    }
+    /**
+     * Called when the form is reset.
+     * Resets the component's value.
+     */
+    formResetCallback() {
+        this.value = '';
+    }
+    /**
+     * Updates the form value and reports validity state to the browser via
+     * ElementInternals. This should be called when the component loads, when
+     * the disabled prop changes, and when the value changes to ensure the form
+     * value stays in sync and validation state is updated.
+     */
+    updateElementInternals() {
+        var _a;
+        // Disabled form controls should not be included in form data
+        // Pass null to setFormValue when disabled to exclude it from form submission
+        const value = this.disabled ? null : this.getValue();
+        // ElementInternals may not be fully available in test environments
+        // so we need to check if the method exists before calling it
+        if (typeof this.internals.setFormValue === 'function') {
+            this.internals.setFormValue(value);
+        }
+        // Use the first input element for validity reporting since all inputs
+        // share the same validation state
+        reportValidityToElementInternals((_a = this.inputRefs[0]) !== null && _a !== void 0 ? _a : null, this.internals);
+    }
     /**
      * Emits an `ionChange` event.
      * This API should be called for user committed changes.
@@ -308,79 +596,24 @@ export class InputOTP {
         const newValue = value == null ? value : value.toString();
         this.ionInput.emit({ value: newValue, event });
     }
-    /**
-     * Handles the focus behavior for the input OTP component.
-     *
-     * Focus behavior:
-     * 1. Keyboard navigation: Allow normal focus movement
-     * 2. Mouse click:
-     *    - If clicked box has value: Focus that box
-     *    - If clicked box is empty: Focus first empty box
-     *
-     * Emits the `ionFocus` event when the input group gains focus.
-     */
-    onFocus = (index) => (event) => {
-        const { inputRefs } = this;
-        // Only emit ionFocus and set the focusedValue when the
-        // component first gains focus
-        if (!this.hasFocus) {
-            this.ionFocus.emit(event);
-            this.focusedValue = this.value;
-        }
-        this.hasFocus = true;
-        let finalIndex = index;
-        if (!this.isKeyboardNavigation) {
-            // If the clicked box has a value, focus it
-            // Otherwise focus the first empty box
-            const targetIndex = this.inputValues[index] ? index : this.getFirstEmptyIndex();
-            finalIndex = targetIndex === -1 ? this.length - 1 : targetIndex;
-            // Focus the target box
-            this.inputRefs[finalIndex]?.focus();
-        }
-        // Update tabIndexes to match the focused box
-        inputRefs.forEach((input, i) => {
-            input.tabIndex = i === finalIndex ? 0 : -1;
-        });
-        // Reset the keyboard navigation flag
-        this.isKeyboardNavigation = false;
-    };
-    /**
-     * Handles the blur behavior for the input OTP component.
-     * Emits the `ionBlur` event when the input group loses focus.
-     */
-    onBlur = (event) => {
-        const { inputRefs } = this;
-        const relatedTarget = event.relatedTarget;
-        // Do not emit blur if we're moving to another input box in the same component
-        const isInternalFocus = relatedTarget != null && inputRefs.includes(relatedTarget);
-        if (!isInternalFocus) {
-            this.hasFocus = false;
-            // Reset tabIndexes when focus leaves the component
-            this.updateTabIndexes();
-            // Always emit ionBlur when focus leaves the component
-            this.ionBlur.emit(event);
-            // Only emit ionChange if the value has actually changed
-            if (this.focusedValue !== this.value) {
-                this.emitIonChange(event);
-            }
-        }
-    };
     /**
      * Focuses the next input box.
      */
     focusNext(currentIndex) {
+        var _a;
         const { inputRefs, length } = this;
         if (currentIndex < length - 1) {
-            inputRefs[currentIndex + 1]?.focus();
+            (_a = inputRefs[currentIndex + 1]) === null || _a === void 0 ? void 0 : _a.focus();
         }
     }
     /**
      * Focuses the previous input box.
      */
     focusPrevious(currentIndex) {
+        var _a;
         const { inputRefs } = this;
         if (currentIndex > 0) {
-            inputRefs[currentIndex - 1]?.focus();
+            (_a = inputRefs[currentIndex - 1]) === null || _a === void 0 ? void 0 : _a.focus();
         }
     }
     /**
@@ -389,11 +622,12 @@ export class InputOTP {
      * Returns -1 if all inputs are filled.
      */
     getFirstEmptyIndex() {
+        var _a;
         const { inputValues, length } = this;
         // Create an array of the same length as the input OTP
         // and fill it with the input values
         const values = Array.from({ length }, (_, i) => inputValues[i] || '');
-        return values.findIndex((value) => !value || value === '') ?? -1;
+        return (_a = values.findIndex((value) => !value || value === '')) !== null && _a !== void 0 ? _a : -1;
     }
     /**
      * Returns the index of the input that should be tabbed to.
@@ -430,243 +664,6 @@ export class InputOTP {
             input.setAttribute('aria-hidden', isEmpty && !shouldBeTabbable ? 'true' : 'false');
         });
     }
-    /**
-     * Handles keyboard navigation for the OTP component.
-     *
-     * Navigation:
-     * - Backspace: Clears current input and moves to previous box if empty
-     * - Arrow Left/Right: Moves focus between input boxes
-     * - Tab: Allows normal tab navigation between components
-     */
-    onKeyDown = (index) => (event) => {
-        const { disabled, length, readonly } = this;
-        const rtl = isRTL(this.el);
-        const input = event.target;
-        if (disabled) {
-            return;
-        }
-        if (readonly) {
-            if (event.key === 'Backspace' || event.key === 'Delete') {
-                event.preventDefault();
-                return;
-            }
-        }
-        // Meta shortcuts are used to copy, paste, and select text
-        // We don't want to handle these keys here
-        const metaShortcuts = ['a', 'c', 'v', 'x', 'r', 'z', 'y'];
-        const isTextSelection = input.selectionStart !== input.selectionEnd;
-        // Return if the key is a meta shortcut or the input value
-        // text is selected and let the onPaste / onInput handler manage it
-        if (isTextSelection || ((event.metaKey || event.ctrlKey) && metaShortcuts.includes(event.key.toLowerCase()))) {
-            return;
-        }
-        if (event.key === 'Backspace') {
-            if (this.inputValues[index]) {
-                // Shift all values to the right of the current index left by one
-                for (let i = index; i < length - 1; i++) {
-                    this.inputValues[i] = this.inputValues[i + 1];
-                }
-                // Clear the last box
-                this.inputValues[length - 1] = '';
-                // Update all inputRefs to match inputValues
-                for (let i = 0; i < length; i++) {
-                    this.inputRefs[i].value = this.inputValues[i] || '';
-                }
-                this.updateValue(event);
-                event.preventDefault();
-            }
-            else if (!this.inputValues[index] && index > 0) {
-                // If current input is empty, move to previous input
-                this.focusPrevious(index);
-            }
-        }
-        else if (event.key === 'ArrowLeft' || event.key === 'ArrowRight') {
-            this.isKeyboardNavigation = true;
-            event.preventDefault();
-            const isLeft = event.key === 'ArrowLeft';
-            const shouldMoveNext = (isLeft && rtl) || (!isLeft && !rtl);
-            // Only allow moving to the next input if the current has a value
-            if (shouldMoveNext) {
-                if (this.inputValues[index] && index < length - 1) {
-                    this.focusNext(index);
-                }
-            }
-            else {
-                this.focusPrevious(index);
-            }
-        }
-        else if (event.key === 'Tab') {
-            this.isKeyboardNavigation = true;
-            // Let all tab events proceed normally
-            return;
-        }
-    };
-    /**
-     * Processes all input scenarios for each input box.
-     *
-     * This function manages:
-     * 1. Autofill handling
-     * 2. Input validation
-     * 3. Full selection replacement or typing in an empty box
-     * 4. Inserting in the middle with available space (shifting)
-     * 5. Single character replacement
-     */
-    onInput = (index) => (event) => {
-        const { disabled, length, readonly, validKeyPattern } = this;
-        const input = event.target;
-        const value = input.value;
-        const previousValue = this.previousInputValues[index] || '';
-        if (disabled || readonly) {
-            return;
-        }
-        // 1. Autofill handling
-        // If the length of the value increases by more than 1 from the previous
-        // value, treat this as autofill. This is to prevent the case where the
-        // user is typing a single character into an input box containing a value
-        // as that will trigger this function with a value length of 2 characters.
-        const isAutofill = value.length - previousValue.length > 1;
-        if (isAutofill) {
-            // Distribute valid characters across input boxes
-            const validChars = value
-                .split('')
-                .filter((char) => validKeyPattern.test(char))
-                .slice(0, length);
-            // If there are no valid characters coming from the
-            // autofill, all input refs have to be cleared after the
-            // browser has finished the autofill behavior
-            if (validChars.length === 0) {
-                requestAnimationFrame(() => {
-                    this.inputRefs.forEach((input) => {
-                        input.value = '';
-                    });
-                });
-            }
-            for (let i = 0; i < length; i++) {
-                this.inputValues[i] = validChars[i] || '';
-                this.inputRefs[i].value = validChars[i] || '';
-            }
-            this.updateValue(event);
-            // Focus the first empty input box or the last input box if all boxes
-            // are filled after a small delay to ensure the input boxes have been
-            // updated before moving the focus
-            setTimeout(() => {
-                const nextIndex = validChars.length < length ? validChars.length : length - 1;
-                this.inputRefs[nextIndex]?.focus();
-            }, 20);
-            this.previousInputValues = [...this.inputValues];
-            return;
-        }
-        // 2. Input validation
-        // If the character entered is invalid (does not match the pattern),
-        // restore the previous value and exit
-        if (value.length > 0 && !validKeyPattern.test(value[value.length - 1])) {
-            input.value = this.inputValues[index] || '';
-            this.previousInputValues = [...this.inputValues];
-            return;
-        }
-        // 3. Full selection replacement or typing in an empty box
-        // If the user selects all text in the input box and types, or if the
-        // input box is empty, replace only this input box. If the box is empty,
-        // move to the next box, otherwise stay focused on this box.
-        const isAllSelected = input.selectionStart === 0 && input.selectionEnd === value.length;
-        const isEmpty = !this.inputValues[index];
-        if (isAllSelected || isEmpty) {
-            this.inputValues[index] = value;
-            input.value = value;
-            this.updateValue(event);
-            this.focusNext(index);
-            this.previousInputValues = [...this.inputValues];
-            return;
-        }
-        // 4. Inserting in the middle with available space (shifting)
-        // If typing in a filled input box and there are empty boxes at the end,
-        // shift all values starting at the current box to the right, and insert
-        // the new character at the current box.
-        const hasAvailableBoxAtEnd = this.inputValues[this.inputValues.length - 1] === '';
-        if (this.inputValues[index] && hasAvailableBoxAtEnd && value.length === 2) {
-            // Get the inserted character (from event or by diffing value/previousValue)
-            let newChar = event.data;
-            if (!newChar) {
-                newChar = value.split('').find((c, i) => c !== previousValue[i]) || value[value.length - 1];
-            }
-            // Validate the new character before shifting
-            if (!validKeyPattern.test(newChar)) {
-                input.value = this.inputValues[index] || '';
-                this.previousInputValues = [...this.inputValues];
-                return;
-            }
-            // Shift values right from the end to the insertion point
-            for (let i = this.inputValues.length - 1; i > index; i--) {
-                this.inputValues[i] = this.inputValues[i - 1];
-                this.inputRefs[i].value = this.inputValues[i] || '';
-            }
-            this.inputValues[index] = newChar;
-            this.inputRefs[index].value = newChar;
-            this.updateValue(event);
-            this.previousInputValues = [...this.inputValues];
-            return;
-        }
-        // 5. Single character replacement
-        // Handles replacing a single character in a box containing a value based
-        // on the cursor position. We need the cursor position to determine which
-        // character was the last character typed. For example, if the user types "2"
-        // in an input box with the cursor at the beginning of the value of "6",
-        // the value will be "26", but we want to grab the "2" as the last character
-        // typed.
-        const cursorPos = input.selectionStart ?? value.length;
-        const newCharIndex = cursorPos - 1;
-        const newChar = value[newCharIndex] ?? value[0];
-        // Check if the new character is valid before updating the value
-        if (!validKeyPattern.test(newChar)) {
-            input.value = this.inputValues[index] || '';
-            this.previousInputValues = [...this.inputValues];
-            return;
-        }
-        this.inputValues[index] = newChar;
-        input.value = newChar;
-        this.updateValue(event);
-        this.previousInputValues = [...this.inputValues];
-    };
-    /**
-     * Handles pasting text into the input OTP component.
-     * This function prevents the default paste behavior and
-     * validates the pasted text against the allowed pattern.
-     * It then updates the value of the input group and focuses
-     * the next empty input after pasting.
-     */
-    onPaste = (event) => {
-        const { disabled, inputRefs, length, readonly, validKeyPattern } = this;
-        event.preventDefault();
-        if (disabled || readonly) {
-            return;
-        }
-        const pastedText = event.clipboardData?.getData('text');
-        // If there is no pasted text, still emit the input change event
-        // because this is how the native input element behaves
-        // but return early because there is nothing to paste.
-        if (!pastedText) {
-            this.emitIonInput(event);
-            return;
-        }
-        const validChars = pastedText
-            .split('')
-            .filter((char) => validKeyPattern.test(char))
-            .slice(0, length);
-        // Always paste starting at the first box
-        validChars.forEach((char, index) => {
-            if (index < length) {
-                this.inputRefs[index].value = char;
-                this.inputValues[index] = char;
-            }
-        });
-        // Update the value so that all input boxes are updated
-        this.value = validChars.join('');
-        this.updateValue(event);
-        // Focus the next empty input after pasting
-        // If all boxes are filled, focus the last input
-        const nextEmptyIndex = validChars.length < length ? validChars.length : length - 1;
-        inputRefs[nextEmptyIndex]?.focus();
-    };
     /**
      * Determines if a separator should be shown for a given index by
      * checking if the index is included in the parsed separators array.
@@ -676,13 +673,14 @@ export class InputOTP {
         return this.parsedSeparators.includes(index + 1) && index < length - 1;
     }
     render() {
+        var _a, _b;
         const { autocapitalize, color, disabled, el, fill, hasFocus, inheritedAttributes, inputId, inputRefs, inputValues, length, readonly, shape, size, } = this;
         const mode = getIonMode(this);
         const inputmode = this.getInputmode();
         const tabbableIndex = this.getTabbableIndex();
         const pattern = this.getPattern();
-        const hasDescription = el.querySelector('.input-otp-description')?.textContent?.trim() !== '';
-        return (h(Host, { key: 'bd37661e13cde21feff30c663e6813ce3fff0d9a', class: createColorClasses(color, {
+        const hasDescription = ((_b = (_a = el.querySelector('.input-otp-description')) === null || _a === void 0 ? void 0 : _a.textContent) === null || _b === void 0 ? void 0 : _b.trim()) !== '';
+        return (h(Host, { key: '67df3d392e0336b65363fff7cb0d093b7c535b3f', class: createColorClasses(color, {
                 [mode]: true,
                 'has-focus': hasFocus,
                 [`input-otp-size-${size}`]: true,
@@ -690,23 +688,26 @@ export class InputOTP {
                 [`input-otp-fill-${fill}`]: true,
                 'input-otp-disabled': disabled,
                 'input-otp-readonly': readonly,
-            }) }, h("div", { key: '5e206f870024f1ecfebda999ff31e6e815774deb', role: "group", "aria-label": "One-time password input", class: "input-otp-group", ...inheritedAttributes }, Array.from({ length }).map((_, index) => (h(Fragment, null, h("div", { class: "native-wrapper" }, h("input", { class: "native-input", id: `${inputId}-${index}`, "aria-label": `Input ${index + 1} of ${length}`, type: "text", autoCapitalize: autocapitalize, inputmode: inputmode, pattern: pattern, disabled: disabled, readOnly: readonly, tabIndex: index === tabbableIndex ? 0 : -1, value: inputValues[index] || '', autocomplete: "one-time-code", ref: (el) => (inputRefs[index] = el), onInput: this.onInput(index), onBlur: this.onBlur, onFocus: this.onFocus(index), onKeyDown: this.onKeyDown(index), onPaste: this.onPaste })), this.showSeparator(index) && h("div", { class: "input-otp-separator" }))))), h("div", { key: 'c268f838ddab2c8d6a612a11c7d38e6ca076436d', class: {
+            }) }, h("div", Object.assign({ key: 'b68d6bfae96d7f381ce66819d9cff0aa2b1d8a44', role: "group", "aria-label": "One-time password input", class: "input-otp-group", part: "group" }, inheritedAttributes), Array.from({ length }).map((_, index) => (h(Fragment, null, h("div", { class: "native-wrapper", part: "container" }, h("input", { class: "native-input", part: "native", id: `${inputId}-${index}`, "aria-label": `Input ${index + 1} of ${length}`, type: "text", autoCapitalize: autocapitalize, inputmode: inputmode, pattern: pattern, disabled: disabled, readOnly: readonly, tabIndex: index === tabbableIndex ? 0 : -1, value: inputValues[index] || '', autocomplete: "one-time-code", ref: (el) => (inputRefs[index] = el), onInput: this.onInput(index), onBlur: this.onBlur, onFocus: this.onFocus(index), onKeyDown: this.onKeyDown(index), onPaste: this.onPaste })), this.showSeparator(index) && h("div", { class: "input-otp-separator", part: "separator" }))))), h("div", { key: '346450b2da262c6543e5dc2c0bbac27c541f4e18', class: {
                 'input-otp-description': true,
                 'input-otp-description-hidden': !hasDescription,
-            } }, h("slot", { key: 'c0736359b26f609b795e399fc1ad9b540632af18' }))));
+            }, part: "description" }, h("slot", { key: '31ad8b75d9b2808b49f488e7ff2f235099e31b30' }))));
     }
     static get is() { return "ion-input-otp"; }
-    static get encapsulation() { return "scoped"; }
+    static get encapsulation() { return "shadow"; }
+    static get formAssociated() { return true; }
     static get originalStyleUrls() {
         return {
             "ios": ["input-otp.ios.scss"],
-            "md": ["input-otp.md.scss"]
+            "md": ["input-otp.md.scss"],
+            "ionic": ["input-otp.ionic.scss"]
         };
     }
     static get styleUrls() {
         return {
             "ios": ["input-otp.ios.css"],
-            "md": ["input-otp.md.css"]
+            "md": ["input-otp.md.css"],
+            "ionic": ["input-otp.ionic.css"]
         };
     }
     static get properties() {
@@ -1123,6 +1124,9 @@ export class InputOTP {
     static get elementRef() { return "el"; }
     static get watchers() {
         return [{
+                "propName": "disabled",
+                "methodName": "disabledChanged"
+            }, {
                 "propName": "value",
                 "methodName": "valueChanged"
             }, {
@@ -1133,5 +1137,6 @@ export class InputOTP {
                 "methodName": "processSeparators"
             }];
     }
+    static get attachInternalsMemberName() { return "internals"; }
 }
 let inputIds = 0;