@ionic/core 9.0.0 → 9.0.1-nightly.20260820

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

@@ -8,133 +8,356 @@ import { isRTL } from "../../utils/rtl/index";
 import { createColorClasses } from "../../utils/theme";
 import { getIonMode } from "../../global/ionic-global";
 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;
-    /**
-     * Emitted when the input group has focus.
-     */
-    ionFocus;
+    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) => {
+            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.
+         */
+        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) => {
+            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.
+         */
+        this.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();
+        };
+    }
     /**
      * Sets focus to an input box.
      * @param index - The index of the input box to focus (0-based).
@@ -308,63 +531,6 @@ 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.
      */
@@ -430,243 +596,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.