@cloud-ru/ds-fields 2.2.3-preview-9414fc09.0 → 2.2.3-preview-7425cb27.0

package/dist/esm/segments/useSegmentedMask.js

@@ -1,8 +1,23 @@
+import { useEventHandler } from '@cloud-ru/ds-utils';
 import { useCallback, useRef } from 'react';
+const RESET_TYPED_KEYS = new Set([
+    'ArrowLeft',
+    'ArrowRight',
+    'ArrowUp',
+    'ArrowDown',
+    'Backspace',
+    'Delete',
+    'Enter',
+    'Tab',
+    'Escape',
+]);
 /**
  * Сегментный ввод даты/времени (порт `useDateField` из @snack-uikit/fields). Каретка ходит по
  * сегментам (`setSelectionRange` подсвечивает текущий), цифры заполняют сегмент с авто-переходом,
  * стрелки двигают по сегментам, Backspace очищает сегмент до плейсхолдера.
+ *
+ * Навигация идёт через `handleKeyDown`, правка значения — через нативные `beforeinput`/`input`:
+ * `nativeInputRef` нужно передать в `ref` того же input'а.
  */
 export function useSegmentedMask({ inputRef, mask, slots, readonly, disabled, setValue, onMaskedChange, onArrowDown, onArrowUp, onEscape, onEdit, }) {
     const firstSlot = slots[0];
@@ -107,70 +122,64 @@ export function useSegmentedMask({ inputRef, mask, slots, readonly, disabled, se
         }
         selectSlot(nextSlot(slot));
     }, [clearSlot, isValidDate, lastSlot, nextSlot, selectSlot, slots, tryToComplete]);
+    // Цифры, набранные в текущий сегмент. Храним отдельно от текста: по `01` в поле нельзя понять,
+    // набрали `1` или `0` + `1`, а от этого зависит, ждать ли вторую цифру.
+    const typedRef = useRef(null);
+    const resetTyped = useCallback(() => {
+        typedRef.current = null;
+    }, []);
     const typeDigit = useCallback((slot, key) => {
-        const text = getSlotText(slot);
-        const numberValue = Number(text) || 0;
-        const digit = Number(key);
-        const slotValue = parseInt(numberValue.toString() + key, 10) || 0;
-        const valueLength = slotValue.toString().length;
         const maxLength = slot.max.toString().length;
-        const isTheLastInput = /^0+$/.test(text) && maxLength === 2 && digit === 0;
-        if (valueLength < maxLength) {
-            if (slotValue || slotValue >= slot.min) {
-                updateSlot(slot, slotValue);
-                if (isTheLastInput)
-                    checkInputAndGoNext(slot);
-            }
-            if (slotValue * 10 > slot.max) {
-                checkInputAndGoNext(slot);
-            }
-        }
-        else if (valueLength > maxLength) {
-            if (digit * 10 > slot.max) {
-                updateSlot(slot, key);
-                checkInputAndGoNext(slot);
-            }
-            else if (digit || digit >= slot.min) {
-                updateSlot(slot, key);
-            }
-        }
-        else if (slotValue <= slot.max) {
-            updateSlot(slot, slotValue);
-            checkInputAndGoNext(slot);
+        const prev = typedRef.current?.key === slot.key ? typedRef.current.digits : '';
+        const appended = prev + key;
+        // Цифра выводит сегмент за max — сегмент начинается с неё заново (как React Aria и MUI X): `13` в месяце → `03`.
+        const overflow = Number(appended) > slot.max;
+        const digits = overflow ? key : appended;
+        const value = Number(digits);
+        const complete = overflow || digits.length >= maxLength || value * 10 > slot.max;
+        // Значение ниже min (`0` в дне) не показываем, но помним цифру до следующей.
+        const accepted = value >= slot.min;
+        if (accepted)
+            updateSlot(slot, value);
+        if (!complete) {
+            typedRef.current = { key: slot.key, digits };
+            return;
         }
-        else if (digit * 10 > slot.max) {
-            updateSlot(slot, key);
+        typedRef.current = null;
+        if (accepted)
             checkInputAndGoNext(slot);
-        }
-        else if (digit || digit >= slot.min) {
-            updateSlot(slot, key);
-        }
-    }, [checkInputAndGoNext, getSlotText, updateSlot]);
+    }, [checkInputAndGoNext, updateSlot]);
     const handleFocus = useCallback(() => {
         if (readonly || disabled)
             return;
+        resetTyped();
         ensureMask();
         // На фокус всегда выбираем ПЕРВЫЙ сегмент (паритет с легаси). При клике мышью `handleClick`
         // отработает следом и перевыберет сегмент под кареткой; при Tab остаётся первый.
         selectSlot(firstSlot);
-    }, [disabled, ensureMask, firstSlot, readonly, selectSlot]);
+    }, [disabled, ensureMask, firstSlot, readonly, resetTyped, selectSlot]);
     const handleClick = useCallback((event) => {
         if (readonly || disabled)
             return;
+        resetTyped();
         ensureMask();
         selectSlot(slotFromIndex(event.currentTarget.selectionStart));
-    }, [disabled, ensureMask, readonly, selectSlot, slotFromIndex]);
+    }, [disabled, ensureMask, readonly, resetTyped, selectSlot, slotFromIndex]);
     const handleBlur = useCallback(() => {
+        resetTyped();
         const input = inputRef.current;
         if (input && input.value === mask) {
             input.value = '';
             setValue('');
         }
-    }, [inputRef, mask, setValue]);
+    }, [inputRef, mask, resetTyped, setValue]);
     const handleKeyDown = useCallback((event) => {
         const input = inputRef.current;
         if (!input || readonly || disabled)
             return;
+        // Навигация и правка начинают набор сегмента заново. Цифры, `Unidentified` (Android) и модификаторы — нет.
+        if (RESET_TYPED_KEYS.has(event.key))
+            resetTyped();
         // Tab уводит фокус из поля — не перехватываем.
         if (event.key === 'Tab')
             return;
@@ -185,7 +194,13 @@ export function useSegmentedMask({ inputRef, mask, slots, readonly, disabled, se
             onArrowUp?.();
             return;
         }
+        // Сочетания (копирование, вставка, выделение) отдаём браузеру: правку поля перехватит beforeinput.
+        if (event.ctrlKey || event.metaKey || event.altKey)
+            return;
         onEdit?.();
+        // Цифры и `Unidentified` (экранные клавиатуры Android, IME) вводятся через beforeinput.
+        if (/^\d$/.test(event.key) || event.key === 'Unidentified')
+            return;
         if (event.key === 'Escape') {
             event.preventDefault();
             onEscape?.();
@@ -220,11 +235,6 @@ export function useSegmentedMask({ inputRef, mask, slots, readonly, disabled, se
         if (event.key === 'Enter') {
             tryToComplete();
             emit();
-            return;
-        }
-        if (/^\d$/.test(event.key)) {
-            typeDigit(slot, event.key);
-            emit();
         }
     }, [
         clearSlot,
@@ -240,21 +250,14 @@ export function useSegmentedMask({ inputRef, mask, slots, readonly, disabled, se
         onEscape,
         prevSlot,
         readonly,
+        resetTyped,
         selectSlot,
         slotFromIndex,
         tryToComplete,
-        typeDigit,
     ]);
-    // Вставка (Ctrl+V) полной строки даты/времени: вытаскиваем цифры и заполняем сегменты
-    // слева направо. Нативный onChange у поля игнорируется (движок controlled), поэтому без
-    // этого обработчика вставка не работала бы вовсе.
-    const handlePaste = useCallback((event) => {
-        if (readonly || disabled)
-            return;
-        event.preventDefault();
-        const digits = event.clipboardData.getData('text').replace(/\D/g, '');
-        if (!digits)
-            return;
+    // Раскладывает цифры по сегментам слева направо полными кусками — для вставки и автозаполнения.
+    const fillFromDigits = useCallback((digits) => {
+        resetTyped();
         ensureMask();
         let cursor = 0;
         let lastFilled;
@@ -273,7 +276,103 @@ export function useSegmentedMask({ inputRef, mask, slots, readonly, disabled, se
         else if (lastFilled) {
             selectSlot(nextSlot(lastFilled));
         }
+    }, [ensureMask, lastSlot, nextSlot, resetTyped, selectSlot, slots, tryToComplete, updateSlot]);
+    // Вставка (Ctrl+V) полной строки даты/времени. Нативный onChange у поля игнорируется (движок
+    // controlled), поэтому без этого обработчика вставка не работала бы вовсе.
+    const handlePaste = useCallback((event) => {
+        if (readonly || disabled)
+            return;
+        event.preventDefault();
+        const digits = event.clipboardData.getData('text').replace(/\D/g, '');
+        if (!digits)
+            return;
+        fillFromDigits(digits);
+        emit();
+    }, [disabled, emit, fillFromDigits, readonly]);
+    const applyEdit = useCallback((inputType, text) => {
+        const input = inputRef.current;
+        if (!input)
+            return;
+        onEdit?.();
+        if (inputType.startsWith('delete')) {
+            resetTyped();
+            clearSlot(slotFromIndex(input.selectionStart));
+            emit();
+            return;
+        }
+        const digits = text.replace(/\D/g, '');
+        if (!inputType.startsWith('insert') || !digits)
+            return;
+        // Строка целиком (автозаполнение, `fill`, drop) раскладывается с начала маски, одиночная цифра — в текущий сегмент.
+        if (text.length > 1) {
+            fillFromDigits(digits);
+        }
+        else {
+            typeDigit(slotFromIndex(input.selectionStart), digits);
+        }
+        emit();
+    }, [clearSlot, emit, fillFromDigits, inputRef, onEdit, resetTyped, slotFromIndex, typeDigit]);
+    // Значение и выделение до правки, которую браузер не дал отменить (композиция IME).
+    const pendingEditRef = useRef(null);
+    const handleBeforeInput = useCallback((event) => {
+        const input = inputRef.current;
+        if (!input || readonly || disabled)
+            return;
+        ensureMask();
+        if (!event.cancelable) {
+            pendingEditRef.current = { value: input.value, start: input.selectionStart ?? 0, end: input.selectionEnd ?? 0 };
+            return;
+        }
+        event.preventDefault();
+        applyEdit(event.inputType, event.data ?? event.dataTransfer?.getData('text') ?? '');
+    }, [applyEdit, disabled, ensureMask, inputRef, readonly]);
+    const handleInput = useCallback((event) => {
+        const input = inputRef.current;
+        if (!input || readonly || disabled)
+            return;
+        const pending = pendingEditRef.current;
+        pendingEditRef.current = null;
+        if (pending) {
+            // Браузер уже изменил значение: вырезаем вставленное, возвращаем прежнее и применяем как обычный ввод.
+            const inputType = event instanceof InputEvent ? event.inputType : '';
+            const inserted = input.value.slice(pending.start, input.value.length - (pending.value.length - pending.end));
+            input.value = pending.value;
+            setValue(pending.value);
+            input.setSelectionRange(pending.start, pending.end);
+            // Цифру из композиции IME применит её фиксация (отменяемый insertText), как в React Aria.
+            if (!inputType.includes('Composition'))
+                applyEdit(inputType, inserted);
+            return;
+        }
+        // Значение сменили без beforeinput (автозаполнение браузера).
+        const digits = input.value.replace(/\D/g, '');
+        input.value = mask;
+        setValue(mask);
+        fillFromDigits(digits);
         emit();
-    }, [disabled, emit, ensureMask, lastSlot, nextSlot, readonly, selectSlot, slots, tryToComplete, updateSlot]);
-    return { handleKeyDown, handleClick, handleFocus, handleBlur, handlePaste, selectSlot, firstSlot, lastSlot };
+    }, [applyEdit, disabled, emit, fillFromDigits, inputRef, mask, readonly, setValue]);
+    // React 18 не отдаёт `inputType` в `onBeforeInput`, поэтому слушаем нативные события.
+    const onNativeBeforeInput = useEventHandler(handleBeforeInput);
+    const onNativeInput = useEventHandler(handleInput);
+    const attachedInputRef = useRef(null);
+    const nativeInputRef = useCallback((node) => {
+        /* eslint-disable @cloud-ru/ssr-safe-react/domApi -- callback-ref вызывается только в браузере */
+        attachedInputRef.current?.removeEventListener('beforeinput', onNativeBeforeInput);
+        attachedInputRef.current?.removeEventListener('input', onNativeInput);
+        attachedInputRef.current = node;
+        node?.addEventListener('beforeinput', onNativeBeforeInput);
+        node?.addEventListener('input', onNativeInput);
+        /* eslint-enable @cloud-ru/ssr-safe-react/domApi */
+    }, [onNativeBeforeInput, onNativeInput]);
+    return {
+        handleKeyDown,
+        handleClick,
+        handleFocus,
+        handleBlur,
+        handlePaste,
+        nativeInputRef,
+        selectSlot,
+        firstSlot,
+        lastSlot,
+    };
 }