@giro-ds/react 12.1.1 → 12.2.0

package/dist/index.d.ts

@@ -1109,6 +1109,8 @@ interface VirtualKeyboardProps extends Omit<BaseProps, 'disabled'> {
     onChange?: (value: string) => void;
     /** Callback executado quando uma tecla é pressionada: (key) => void */
     onKeyPress?: (key: string) => void;
+    /** Callback executado quando a tecla Enter é pressionada */
+    onEnterPress?: () => void;
     /**
      * Callback executado sempre que o `type` do teclado muda.
      * Útil para que o consumidor saiba o tipo atual e possa reagir à mudança
@@ -1137,6 +1139,13 @@ interface VirtualKeyboardProps extends Omit<BaseProps, 'disabled'> {
      * @default true
      */
     showTypeSwitchKey?: boolean;
+    /**
+     * Quando `true`, exibe o numpad numérico no formato de 4 colunas (estilo iOS nativo),
+     * com as teclas `-`, `↵` `_`, `⌫` e `→|` (enter/submit).
+     * Só tem efeito quando `type="numeric"` e `variant="native"`.
+     * @default false
+     */
+    numpadWithEnter?: boolean;
     /** Texto de ajuda do TextField exibido no modo `fixed` */
     helperText?: string;
     /** Sinaliza erro no TextField exibido no modo `fixed` */

package/dist/index.esm.js

@@ -3,7 +3,7 @@ import clsx from 'clsx';
 import { Avatar as Avatar$1, Tooltip as Tooltip$1, Checkbox as Checkbox$1, Popover as Popover$1, Label, AlertDialog, DropdownMenu, Dialog as Dialog$1, RadioGroup, Select as Select$1, Toggle as Toggle$1, ToggleGroup as ToggleGroup$1, Toast as Toast$1, Switch as Switch$1, unstable_OneTimePasswordField } from 'radix-ui';
 import * as React from 'react';
 import React__default, { useId, useMemo, createContext, useState, useContext, useRef, useCallback, useEffect, useLayoutEffect, createElement, forwardRef, memo, useReducer } from 'react';
-import { SpinnerIos16Regular, ChevronUp16Regular, ChevronLeft16Regular, ChevronRight16Regular, ChevronDown16Regular, Dismiss24Regular, Emoji20Regular, ChevronDown20Regular, KeyboardShiftUppercase20Regular, KeyboardShift20Filled, KeyboardShift20Regular, Backspace20Regular, Info12Regular, Dismiss16Regular, Calendar16Regular, DocumentAdd24Regular, Warning24Regular, Document24Regular, FilterRegular, Search16Regular, ChevronDownRegular, ChevronRight16Filled, Subtract16Regular, Add16Regular, SearchInfo20Regular, ArrowSortUp16Regular, ArrowSortDown16Regular, ArrowSort16Regular, Info20Filled, CheckmarkCircle20Filled, Warning20Filled, Dismiss16Filled } from '@fluentui/react-icons';
+import { SpinnerIos16Regular, ChevronUp16Regular, ChevronLeft16Regular, ChevronRight16Regular, ChevronDown16Regular, Dismiss24Regular, ArrowImport20Regular, Emoji20Regular, ChevronDown20Regular, KeyboardShiftUppercase20Regular, KeyboardShift20Filled, KeyboardShift20Regular, Backspace20Regular, Info12Regular, Dismiss16Regular, Calendar16Regular, DocumentAdd24Regular, Warning24Regular, Document24Regular, FilterRegular, Search16Regular, ChevronDownRegular, ChevronRight16Filled, Subtract16Regular, Add16Regular, SearchInfo20Regular, ArrowSortUp16Regular, ArrowSortDown16Regular, ArrowSort16Regular, Info20Filled, CheckmarkCircle20Filled, Warning20Filled, Dismiss16Filled } from '@fluentui/react-icons';
 import { DayPicker } from 'react-day-picker';
 import { format, addDays, addMonths, addWeeks, addYears, differenceInCalendarDays, differenceInCalendarMonths, eachMonthOfInterval, eachYearOfInterval, endOfISOWeek, endOfMonth, endOfWeek, endOfYear, getISOWeek, getMonth, getYear, getWeek, isAfter, isBefore, isDate, isSameDay, isSameMonth, isSameYear, max, min, setMonth, setYear, startOfDay, startOfISOWeek, startOfMonth, startOfWeek, startOfYear } from 'date-fns';
 import { createPortal } from 'react-dom';
@@ -2909,6 +2909,7 @@ const ICON_KEY_MAP = {
     capslock: KeyboardShiftUppercase20Regular,
     downkeyboard: ChevronDown20Regular,
     emoji: Emoji20Regular,
+    enterNumpad: ArrowImport20Regular,
 };
 const SHARED_DISPLAY = {
     '{capslock}': iconSlot('capslock'),
@@ -2934,9 +2935,11 @@ const LAYOUT_DISPLAY = {
 const EMOTICON_KEY = '{emoticon}';
 const DOWN_KEYBOARD_KEY = '{downkeyboard}';
 const ENTER_KEY = '{enter}';
-const removeKeyFromLayout = (layout, key) => Object.fromEntries(Object.entries(layout).map(([layoutName, rows]) => [
+const removeKeyFromLayout = (layout, key, skipLayouts = []) => Object.fromEntries(Object.entries(layout).map(([layoutName, rows]) => [
     layoutName,
-    rows.map((row) => row.split(key).join(' ').replace(/\s+/g, ' ').trim()),
+    skipLayouts.includes(layoutName)
+        ? rows
+        : rows.map((row) => row.split(key).join(' ').replace(/\s+/g, ' ').trim()),
 ]));
 const replaceKeyWithBlank = (layout, key) => Object.fromEntries(Object.entries(layout).map(([layoutName, rows]) => [
     layoutName,
@@ -2949,7 +2952,8 @@ const QWERTY_LOWERCASE = [
     '{shift} z x c v b n m {bksp}',
     '{numbers} {alt} {space} . {enter}',
 ];
-const NUMPAD = ['1 2 3', '4 5 6', '7 8 9', '{bksp} 0 {abc}'];
+const NUMPAD = ['1 2 3', '4 5 6', '7 8 9', '{abc} 0 {bksp}'];
+const NUMPAD_WITH_ENTER = ['1 2 3 -', '4 5 6 _', '7 8 9 {bksp}', '{abc} 0 . {enter}'];
 const SHARED_LAYOUTS = {
     shift: [
         '1 2 3 4 5 6 7 8 9 0',
@@ -2999,11 +3003,17 @@ const NATIVE_LAYOUTS = {
 const NATIVE_LAYOUT_KEYS = new Set([
     'default', 'numeric',
 ]);
-const getNativeLayout = (type, Emoji = true, showDownKeyboardButton = true, isFixed = false, showEnterKey = true, showTypeSwitchKey = true) => {
+const getNativeLayout = (type, Emoji = true, showDownKeyboardButton = true, isFixed = false, showEnterKey = true, showTypeSwitchKey = true, numpadWithEnter = false) => {
     const layout = NATIVE_LAYOUTS[type] ?? NATIVE_LAYOUTS.default ?? null;
     if (!layout)
         return null;
-    let computedLayout = layout;
+    let computedLayout = numpadWithEnter
+        ? {
+            ...layout,
+            ...(type === 'numeric' ? { default: NUMPAD_WITH_ENTER } : {}),
+            numbers: NUMPAD_WITH_ENTER,
+        }
+        : layout;
     if (!Emoji) {
         computedLayout = removeKeyFromLayout(computedLayout, EMOTICON_KEY);
     }
@@ -3011,7 +3021,9 @@ const getNativeLayout = (type, Emoji = true, showDownKeyboardButton = true, isFi
         computedLayout = removeKeyFromLayout(computedLayout, DOWN_KEYBOARD_KEY);
     }
     if (!showEnterKey) {
-        computedLayout = removeKeyFromLayout(computedLayout, ENTER_KEY);
+        // Numpad layouts always preserve {enter}; only remove from QWERTY layouts
+        const numpadLayouts = type === 'numeric' ? ['default', 'numbers'] : ['numbers'];
+        computedLayout = removeKeyFromLayout(computedLayout, ENTER_KEY, numpadLayouts);
     }
     if (!showTypeSwitchKey) {
         computedLayout = removeKeyFromLayout(computedLayout, '{numbers}');
@@ -3082,13 +3094,16 @@ const ACCENT_OPTIONS = {
  * <VirtualKeyboard targetRef={inputRef} value={value} onChange={setValue} />
  * ```
  */
-const VirtualKeyboard = ({ variant = 'native', type = 'default', value = '', onChange, onKeyPress, onTypeChange, maxLength, Emoji = false, className, id, placeholder = 'Digite aqui...', helperText, error, errorMessage, targetRef, textFieldScale = 1, showEnterKey = true, showTypeSwitchKey = true, }) => {
+const VirtualKeyboard = ({ variant = 'native', type = 'default', value, onChange, onKeyPress, onEnterPress, onTypeChange, maxLength, Emoji = false, className, id, placeholder = 'Digite aqui...', helperText, error, errorMessage, targetRef, textFieldScale = 1, showEnterKey = true, showTypeSwitchKey = true, numpadWithEnter = false, }) => {
+    const [internalValue, setInternalValue] = useState(value ?? '');
     const [layoutName, setLayoutName] = useState('default');
     const [capsLockOn, setCapsLockOn] = useState(false);
     const [accentMenu, setAccentMenu] = useState(null);
     const [accentMenuOffsetX, setAccentMenuOffsetX] = useState(0);
-    const [activeLayout, setActiveLayout] = useState(getNativeLayout(type, Emoji, variant === 'native', variant === 'fixed', showEnterKey, showTypeSwitchKey));
+    const [activeLayout, setActiveLayout] = useState(getNativeLayout(type, Emoji, variant === 'native', variant === 'fixed', showEnterKey, showTypeSwitchKey, numpadWithEnter));
     const visualType = NATIVE_LAYOUT_KEYS.has(type) ? type : 'default';
+    const effectiveValue = onChange !== undefined ? (value ?? '') : internalValue;
+    const isNumpadLayout = (type === 'numeric' && layoutName === 'default') || layoutName === 'numbers';
     const [isOpen, setIsOpen] = useState(variant !== 'native');
     const hideTimeoutRef = useRef(null);
     const scrollTimeoutRef = useRef(null);
@@ -3101,15 +3116,15 @@ const VirtualKeyboard = ({ variant = 'native', type = 'default', value = '', onC
     const keyboardInstanceRef = useRef(null);
     const accentMenuRef = useRef(null);
     const accentButtonRef = useRef(null);
-    const valueRef = useRef(value);
+    const valueRef = useRef(value ?? '');
     const [iconSlots, setIconSlots] = useState([]);
     const [keyPreview, setKeyPreview] = useState(null);
     const [keyPreviewOffsetX, setKeyPreviewOffsetX] = useState(0);
     const keyPreviewRef = useRef(null);
     const [containerWidth, setContainerWidth] = useState(Infinity);
     useEffect(() => {
-        valueRef.current = value;
-    }, [value]);
+        valueRef.current = effectiveValue;
+    }, [effectiveValue]);
     const clearLongPressTimeout = useCallback(() => {
         if (longPressTimeoutRef.current !== null) {
             clearTimeout(longPressTimeoutRef.current);
@@ -3124,8 +3139,8 @@ const VirtualKeyboard = ({ variant = 'native', type = 'default', value = '', onC
         keyboardInstanceRef.current?.setInput(nextValue);
     }, []);
     useEffect(() => {
-        syncKeyboardInput(value);
-    }, [value, syncKeyboardInput]);
+        syncKeyboardInput(effectiveValue);
+    }, [effectiveValue, syncKeyboardInput]);
     useEffect(() => {
         onTypeChange?.(type);
     }, [type, onTypeChange]);
@@ -3203,8 +3218,8 @@ const VirtualKeyboard = ({ variant = 'native', type = 'default', value = '', onC
     useEffect(() => {
         setLayoutName('default');
         setCapsLockOn(false);
-        setActiveLayout(getNativeLayout(type, Emoji, variant === 'native', variant === 'fixed', showEnterKey, showTypeSwitchKey));
-    }, [type, Emoji, variant, showEnterKey, showTypeSwitchKey]);
+        setActiveLayout(getNativeLayout(type, Emoji, variant === 'native', variant === 'fixed', showEnterKey, showTypeSwitchKey, numpadWithEnter));
+    }, [type, Emoji, variant, showEnterKey, showTypeSwitchKey, numpadWithEnter]);
     useEffect(() => {
         if (!Emoji && layoutName === 'emoticon') {
             setLayoutName(type === 'numeric' ? 'abc' : 'default');
@@ -3284,7 +3299,10 @@ const VirtualKeyboard = ({ variant = 'native', type = 'default', value = '', onC
             if (newSlots.length === 0)
                 return;
             newSlots.forEach((s) => s.setAttribute('data-icon-root', 'true'));
-            setIconSlots((prev) => [...prev, ...newSlots]);
+            setIconSlots((prev) => [
+                ...prev.filter((slot) => container.contains(slot)),
+                ...newSlots,
+            ]);
         };
         registerNewSlots();
         const observer = new MutationObserver(() => {
@@ -3295,7 +3313,7 @@ const VirtualKeyboard = ({ variant = 'native', type = 'default', value = '', onC
         return () => {
             observer.disconnect();
         };
-    }, []);
+    }, [variant]);
     useEffect(() => {
         closeAccentMenu();
         setAccentMenuOffsetX(0);
@@ -3377,6 +3395,8 @@ const VirtualKeyboard = ({ variant = 'native', type = 'default', value = '', onC
             const currentValue = valueRef.current;
             if (maxLength === undefined || currentValue.length < maxLength) {
                 const nextValue = `${currentValue}${heldKey}`;
+                if (onChange === undefined)
+                    setInternalValue(nextValue);
                 onChange?.(nextValue);
                 onKeyPress?.(heldKey);
                 syncKeyboardInput(nextValue);
@@ -3410,6 +3430,8 @@ const VirtualKeyboard = ({ variant = 'native', type = 'default', value = '', onC
             return;
         }
         const nextValue = `${currentValue}${accentedChar}`;
+        if (onChange === undefined)
+            setInternalValue(nextValue);
         onChange?.(nextValue);
         onKeyPress?.(accentedChar);
         closeAccentMenu();
@@ -3500,12 +3522,16 @@ const VirtualKeyboard = ({ variant = 'native', type = 'default', value = '', onC
         if (isHeldAccentKey) {
             return;
         }
+        if (button === '{enter}') {
+            onEnterPress?.();
+        }
         onKeyPress?.(button);
     }, [
         type,
         layoutName,
         capsLockOn,
         onKeyPress,
+        onEnterPress,
         onTypeChange,
         Emoji,
         variant,
@@ -3532,8 +3558,10 @@ const VirtualKeyboard = ({ variant = 'native', type = 'default', value = '', onC
         }
         if (maxLength !== undefined && input.length > maxLength)
             return;
+        if (onChange === undefined)
+            setInternalValue(input);
         onChange?.(input);
-    }, [maxLength, onChange, syncKeyboardInput]);
+    }, [maxLength, onChange, setInternalValue, syncKeyboardInput]);
     const portalSizes = useMemo(() => {
         if (containerWidth <= 360)
             return { preview: 42, option: 44, fontSize: 'var(--font-size-16)' };
@@ -3549,15 +3577,16 @@ const VirtualKeyboard = ({ variant = 'native', type = 'default', value = '', onC
         const baseDisplay = LAYOUT_DISPLAY[visualType];
         if (!baseDisplay)
             return baseDisplay;
-        if (variant !== 'fixed') {
-            return baseDisplay;
+        const display = { ...baseDisplay };
+        if (numpadWithEnter && isNumpadLayout) {
+            display['{enter}'] = '<span data-icon-key="enterNumpad"></span>';
         }
-        return {
-            ...baseDisplay,
-            '{bksp}': (baseDisplay['{bksp}'] ?? '').replace(/\s*Apagar$/, ''),
-        };
-    }, [visualType, variant]);
-    const keyboardEl = activeLayout ? (jsxs("div", { ref: keyboardWrapperRef, className: clsx(styles$k.keyboardWrapper, ((type === 'numeric' && layoutName === 'default') || layoutName === 'numbers' || type === 'default') && styles$k.keyboardNumpadActive), onPointerDownCapture: handleLongPressStart, onPointerUpCapture: handleLongPressEnd, onPointerLeave: handleLongPressEnd, onPointerCancelCapture: handleLongPressEnd, children: [jsx(Keyboard, { keyboardRef: (instance) => {
+        if (variant === 'fixed') {
+            display['{bksp}'] = (display['{bksp}'] ?? '').replace(/\s*Apagar$/, '');
+        }
+        return display;
+    }, [visualType, variant, numpadWithEnter, isNumpadLayout]);
+    const keyboardEl = activeLayout ? (jsxs("div", { ref: keyboardWrapperRef, className: clsx(styles$k.keyboardWrapper, isNumpadLayout && styles$k.keyboardNumpadActive), onPointerDownCapture: handleLongPressStart, onPointerUpCapture: handleLongPressEnd, onPointerLeave: handleLongPressEnd, onPointerCancelCapture: handleLongPressEnd, children: [jsx(Keyboard, { keyboardRef: (instance) => {
                     keyboardInstanceRef.current = instance;
                     if (instance) {
                         instance.setInput(valueRef.current);
@@ -3595,9 +3624,9 @@ const VirtualKeyboard = ({ variant = 'native', type = 'default', value = '', onC
                                 event.stopPropagation();
                             }, onClick: () => handleAccentSelect(option), children: option }, `${accentMenu.sourceKey}-${option}`))) }, rowIndex))) }), document.body))] })) : null;
     if (variant === 'native' && typeof document !== 'undefined') {
-        return createPortal(jsx("div", { id: id, className: clsx(styles$k.overlay, { [styles$k.overlayOpen]: isOpen }, styles$k[`layout--${visualType}`], className), children: keyboardEl }), document.body);
+        return createPortal(jsx("div", { id: id, className: clsx(styles$k.overlay, { [styles$k.overlayOpen]: isOpen }, styles$k[isNumpadLayout ? 'layout--numeric' : 'layout--default'], className), children: keyboardEl }), document.body);
     }
-    return (jsxs("div", { id: id, className: clsx(styles$k.container, styles$k[`mode--${variant}`], styles$k[`layout--${visualType}`], className), children: [variant === 'fixed' && (jsx("div", { className: styles$k.textFieldContainer, children: jsx(TextField$1, { placeholder: placeholder, value: value, onChange: onChange, helperText: helperText, error: error, errorMessage: errorMessage, readOnly: true, disableAutoComplete: true, maxLength: maxLength, attachedToVirtualKeyboard: true, className: styles$k.textFieldWrapper, scale: textFieldScale }) })), keyboardEl] }));
+    return (jsxs("div", { id: id, className: clsx(styles$k.container, styles$k[`mode--${variant}`], styles$k[isNumpadLayout ? 'layout--numeric' : 'layout--default'], className), children: [variant === 'fixed' && (jsx("div", { className: styles$k.textFieldContainer, children: jsx(TextField$1, { placeholder: placeholder, value: effectiveValue, onChange: onChange, helperText: helperText, error: error, errorMessage: errorMessage, readOnly: true, disableAutoComplete: true, maxLength: maxLength, attachedToVirtualKeyboard: true, className: styles$k.textFieldWrapper, scale: textFieldScale }) })), keyboardEl] }));
 };
 
 var styles$j = {"container":"TextField-module__container___WJHFR","inputWrapper":"TextField-module__inputWrapper___INjfd","inputContainer":"TextField-module__inputContainer___3EsFJ","icon":"TextField-module__icon___p1vwi","clearButton":"TextField-module__clearButton___kgOot","inputWithIcon":"TextField-module__inputWithIcon___shqkL","helperText":"TextField-module__helperText___d5QGC","error":"TextField-module__error___IGQzp","disabled":"TextField-module__disabled___roIKP","attachedToVirtualKeyboard":"TextField-module__attachedToVirtualKeyboard___fuO2O","errorWithMessage":"TextField-module__errorWithMessage___m-5AA","clearButtonIcon":"TextField-module__clearButtonIcon___Z2iyc"};