@giro-ds/react 11.1.0 → 12.0.0

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import * as React$1 from 'react';
 import React__default, { ReactNode, ReactElement, RefObject, ComponentPropsWithoutRef, CSSProperties } from 'react';
-import * as react_jsx_runtime from 'react/jsx-runtime';
-import { Matcher } from 'react-day-picker';
+import { DateRange, Matcher } from 'react-day-picker';
+export { DateRange } from 'react-day-picker';
 import { RowData, ColumnDef } from '@tanstack/react-table';
 export { ColumnDef as TableColumnDefinition, createColumnHelper as createTableColumnHelper } from '@tanstack/react-table';
 import { Toast as Toast$1 } from 'radix-ui';
@@ -56,8 +56,8 @@ interface AvatarProps extends Omit<BaseProps, 'disabled'> {
     size?: Size;
     /** URL da imagem do avatar. Quando fornecido, exibe a imagem; caso contrário, mostra o ícone */
     src?: string;
-    /** Texto alternativo da imagem do avatar, usado como as iniciais do nome */
-    initialLetters?: string;
+    /** Texto alternativo exibido no fallback (ex.: iniciais). Limitado a no máximo 2 caracteres */
+    text?: string;
     /** Classe CSS opcional */
     className?: string;
 }
@@ -94,6 +94,36 @@ interface BadgeProps extends BaseProps {
 
 declare const Badge: React__default.FC<BadgeProps>;
 
+/**
+ * Props base compartilhadas por todas as configurações de tooltip do botão.
+ */
+interface BaseTooltipConfig$3 {
+    /** Lado em que o tooltip será exibido */
+    tooltipSide?: 'top' | 'bottom' | 'left' | 'right';
+    /** Alinhamento do tooltip */
+    tooltipAlign?: 'start' | 'center' | 'end';
+}
+/**
+ * Configuração de tooltip com texto.
+ * Exibe um tooltip ao redor do botão — útil especialmente para botões icon-only.
+ */
+interface WithTooltip$3 extends BaseTooltipConfig$3 {
+    /** Texto do tooltip exibido no hover */
+    tooltipText: string;
+}
+/**
+ * Configuração sem tooltip.
+ */
+interface WithoutTooltip$3 {
+    tooltipText?: never;
+    tooltipSide?: never;
+    tooltipAlign?: never;
+}
+/**
+ * Union type representando a configuração de tooltip do botão.
+ * Pode ter tooltip com texto (e opcionalmente side/align) ou sem tooltip.
+ */
+type ButtonTooltipConfig = WithTooltip$3 | WithoutTooltip$3;
 /**
  * Props base do Button, independentes da variante iconOnly/icon.
  * `target`, `rel`, `type` e `onClick` são declarados aqui para garantir
@@ -128,19 +158,13 @@ type ButtonOwnPropsBase = {
     ariaLabel?: string;
     /** Estado de carregamento (exibe spinner) */
     loading?: boolean;
-    /** Texto do tooltip exibido quando o botão é apenas ícone */
-    tooltipText?: string;
-    /** Lado em que o tooltip será exibido */
-    tooltipSide?: 'top' | 'bottom' | 'left' | 'right';
-    /** Alinhamento do tooltip */
-    tooltipAlign?: 'start' | 'center' | 'end';
     /**
      * Classe CSS adicional para customização. Use com moderação e prefira as variantes e estilos pré-definidos do design system.
      */
     className?: string;
     /** Handler de clique; tipado em HTMLElement para ser compatível com todos os modos */
     onClick?: React__default.MouseEventHandler<HTMLElement>;
-} & ScalableProps;
+} & ScalableProps & ButtonTooltipConfig;
 /**
  * Props próprias do componente Button.
  * Quando `iconOnly: true`, a prop `icon` é **obrigatória**.
@@ -187,13 +211,25 @@ type ButtonAsCustom = ButtonOwnProps & Omit<React__default.HTMLAttributes<HTMLEl
  */
 type ButtonProps = ButtonAsButton | ButtonAsAnchor | ButtonAsCustom;
 
-declare const Button: React__default.ForwardRefExoticComponent<ButtonProps & React__default.RefAttributes<HTMLButtonElement | HTMLAnchorElement>>;
+declare const Button: {
+    ({ ref, as, children, variant, iconPosition, href, to, external, target, rel, disabled, onClick, size, scale, className, type, id, icon, fullWidth, ariaLabel, iconOnly, loading, tooltipText, tooltipSide, tooltipAlign, ...rest }: ButtonProps & {
+        ref?: React__default.Ref<HTMLButtonElement | HTMLAnchorElement>;
+    }): React__default.JSX.Element;
+    displayName: string;
+};
 
 /** Formato de exibição da data aceito pelo componente. */
 type DateFormat = 'dd/mm/yyyy' | 'mm/dd/yyyy' | (string & {});
 interface CalendarBaseProps extends Omit<ScalableProps, 'disabled'> {
-    /** Data selecionada atualmente (usada pelo DatePicker). */
+    /**
+     * Modo de seleção de datas.
+     * @default 'single'
+     */
+    mode?: 'single' | 'range';
+    /** Data selecionada atualmente (modo `single`). */
     selected?: Date | null;
+    /** Intervalo de datas selecionado (modo `range`). */
+    selectedRange?: DateRange | null;
     /**
      * Mês exibido no calendário. Use junto com `onDateChange` para
      * controlar a navegação externamente.
@@ -208,8 +244,15 @@ interface CalendarBaseProps extends Omit<ScalableProps, 'disabled'> {
     startMonth?: Date;
     /** Último mês navegável. */
     endMonth?: Date;
-    /** Chamado quando o usuário seleciona um dia. */
+    /**
+     * Quantidade de meses exibidos simultaneamente.
+     * @default 1
+     */
+    numberOfMonths?: number;
+    /** Chamado quando o usuário seleciona um dia (modo `single`). */
     onDaySelect?: (date: Date) => void;
+    /** Chamado quando o usuário seleciona um intervalo (modo `range`). */
+    onRangeSelect?: (range: DateRange | undefined) => void;
     /** Chamado quando o usuário navega entre meses. */
     onDateChange?: (date: Date) => void;
     /** Chamado quando o usuário limpa a seleção. */
@@ -242,7 +285,7 @@ interface CalendarBaseProps extends Omit<ScalableProps, 'disabled'> {
 }
 type CalendarProps = CalendarBaseProps;
 
-declare const Calendar: ({ selected, currentDate, defaultMonth, startMonth, endMonth, onDaySelect, onDateChange, onClear: _onClear, minDate, maxDate, disabled, format: _format, locale, autoFocus, className, style, scale, id, "aria-label": ariaLabel, ...rest }: CalendarProps) => react_jsx_runtime.JSX.Element;
+declare const Calendar: ({ mode, selected, selectedRange, currentDate, defaultMonth, startMonth, endMonth, onDaySelect, onRangeSelect, onDateChange, onClear, minDate, maxDate, disabled, format: _format, locale, autoFocus, numberOfMonths, className, style, scale, id, "aria-label": ariaLabel, ...rest }: CalendarProps) => React$1.JSX.Element;
 
 /**
  * Props do componente Callout
@@ -316,7 +359,7 @@ interface CardProps {
     hoverable?: boolean;
 }
 
-declare function Card({ children, className, hoverable }: CardProps): react_jsx_runtime.JSX.Element;
+declare function Card({ children, className, hoverable }: CardProps): React$1.JSX.Element;
 
 /**
  * Props do componente Checkbox
@@ -405,7 +448,7 @@ interface ContainerProps {
     className?: string;
 }
 
-declare function Container({ children, className }: ContainerProps): react_jsx_runtime.JSX.Element;
+declare function Container({ children, className }: ContainerProps): React$1.JSX.Element;
 
 /**
  * Props do componente DatePicker
@@ -550,6 +593,46 @@ interface DrawerProps extends BaseProps {
 
 declare const Drawer: React__default.FC<DrawerProps>;
 
+interface FileUploadProps extends Omit<React__default.InputHTMLAttributes<HTMLInputElement>, 'onChange' | 'value' | 'accept' | 'multiple'> {
+    /** Tipos de arquivo aceitos pelo seletor nativo (ex: "image/*", ".pdf,.docx") */
+    accept?: string;
+    /** Permite selecionar múltiplos arquivos */
+    multiple?: boolean;
+    /** Lista controlada de arquivos */
+    value?: File[];
+    /** Callback disparado quando a lista de arquivos muda */
+    onChange?: (files: File[]) => void;
+    /** Texto auxiliar exibido abaixo da zona de drop */
+    helperText?: string;
+    /** Sinaliza estado de erro */
+    error?: boolean;
+    /** Mensagem de erro exibida no helperText quando em estado de erro.
+     * Erros internos de tipo (accept), tamanho (maxFileSize) e quantidade (maxFilesQuantity)
+     * também preenchem o helperText com mensagens padrão. */
+    errorMessage?: string;
+    /** Mensagem de erro exibida abaixo do icone de erro, caso não tenha a mensagem não ira aparecer nada */
+    descriptionErrorMessage?: string;
+    /** Tamanho máximo em bytes por arquivo */
+    maxFileSize?: number;
+    /** Número máximo de arquivos permitidos (exige multiple=true para mais de 1) */
+    maxFilesQuantity?: number;
+    /** Quando true, o componente está desabilitado */
+    disabled?: boolean;
+    /** Classes CSS adicionais */
+    className?: string;
+    /** Identificador único */
+    id?: string;
+    /** Texto de instrução exibido na zona vazia */
+    description?: string;
+}
+
+declare const FileUpload: {
+    ({ ref, value, onChange, helperText, error, errorMessage, maxFileSize, maxFilesQuantity, disabled, className, id, accept, multiple, description, descriptionErrorMessage, ...rest }: FileUploadProps & {
+        ref?: React__default.Ref<HTMLInputElement>;
+    }): React__default.JSX.Element;
+    displayName: string;
+};
+
 interface FilterItem$2 {
     /** Identificador único do item (usado em `selectedIds` e `onApplyFilter`) */
     id?: BaseProps['id'];
@@ -562,7 +645,7 @@ interface FilterItem$2 {
     /** Desabilita o item, impedindo sua seleção */
     disabled?: BaseProps['disabled'];
 }
-type FilterType = 'single' | 'multiple' | 'calendar';
+type FilterTypes = 'single' | 'multiple' | 'calendar';
 /**
  * Props do componente Filter
  * @example
@@ -591,7 +674,7 @@ interface FilterProps extends BaseProps {
     /** Array de itens para filtros do tipo dropdown */
     items?: FilterItem$2[];
     /** Tipo do filtro (dropdown ou calendário) */
-    type?: FilterType;
+    type?: FilterTypes;
     /** IDs dos itens selecionados */
     selectedIds?: string[];
     /** Callback executado ao aplicar filtro: (selectedIds) => void */
@@ -638,8 +721,8 @@ interface FilterProps extends BaseProps {
     drawerWidth?: string;
     /** Título do painel lateral (padrão: 'Filtrar') */
     title?: string;
-    /** Número de filtros ativos exibido como badge no botão */
-    activeCount?: number;
+    /** Número de filtros aplicados exibido como badge no botão */
+    appliedFilterCount?: number;
     /** Conteúdo customizado no cabeçalho do Drawer */
     drawerHeaderContent?: ReactNode;
     /** Conteúdo do painel lateral no modo combined */
@@ -831,6 +914,8 @@ interface ModalProps extends BaseProps {
     footer?: ReactNode;
     /** Largura customizada do modal (ex: '500px', '80%') */
     customWidth?: string;
+    /** Altura customizada do modal (ex: '500px', '80%') */
+    customHeight?: string;
     /** Define se o modal ocupa toda a tela. Tem prioridade sobre customWidth */
     fullscreen?: boolean;
     /** Classe CSS opcional */
@@ -1032,12 +1117,20 @@ interface VirtualKeyboardProps extends Omit<BaseProps, 'disabled'> {
     onChange?: (value: string) => void;
     /** Callback executado quando uma tecla é pressionada: (key) => void */
     onKeyPress?: (key: string) => void;
+    /**
+     * Callback executado sempre que o `type` do teclado muda.
+     * Útil para que o consumidor saiba o tipo atual e possa reagir à mudança
+     * (ex.: buscar dados diferentes, ajustar layout, etc.).
+     *
+     * Sempre dispara na montagem inicial, servindo como fallback para consulta do tipo atual.
+     */
+    onTypeChange?: (type: VirtualKeyboardType) => void;
     /** Limite máximo de caracteres */
     maxLength?: number;
     /** Controla a exibição do botão {emoticon} nos layouts suportados */
     Emoji?: boolean;
     /** Placeholder do TextField exibido no modo `fixed` */
-    textFieldPlaceholder?: string;
+    placeholder?: string;
     /** Escala do TextField exibido no modo `fixed` */
     textFieldScale?: 1 | 1.5 | 2;
     /**
@@ -1045,6 +1138,13 @@ interface VirtualKeyboardProps extends Omit<BaseProps, 'disabled'> {
      * @default true
      */
     showEnterKey?: boolean;
+    /**
+     * Controla a exibição da tecla de alternância entre os layouts default ("123") e numeric ("ABC").
+     * Quando `false`, a tecla "123" (no layout default) é removida — a tecla espaço cresce para ocupar o espaço —
+     * e a tecla "ABC" (no layout numeric) é substituída por um espaço vazio.
+     * @default true
+     */
+    showTypeSwitchKey?: boolean;
     /** Texto de ajuda do TextField exibido no modo `fixed` */
     helperText?: string;
     /** Sinaliza erro no TextField exibido no modo `fixed` */
@@ -1118,8 +1218,43 @@ interface SearchProps extends ScalableProps, NativeInputProps {
     virtualKeyboard?: VirtualKeyboardType;
 }
 
-declare const Search: React__default.ForwardRefExoticComponent<SearchProps & React__default.RefAttributes<HTMLInputElement>>;
+declare const Search: {
+    ({ ref, placeholder, disabled, value, onChange, onKeyDown, onFocus, onBlur, onClear, onClick, onMouseDown, searchMode, onSearch, id, scale, className, style, virtualKeyboard, "data-testid": testId, ...rest }: SearchProps & {
+        ref?: React__default.Ref<HTMLInputElement>;
+    }): React__default.JSX.Element;
+    displayName: string;
+};
 
+/**
+ * Props base compartilhadas por todas as configurações de tooltip do select.
+ */
+interface BaseTooltipConfig$2 {
+    /** Lado em que o tooltip será exibido */
+    tooltipSide?: 'top' | 'bottom' | 'left' | 'right';
+    /** Alinhamento do tooltip */
+    tooltipAlign?: 'start' | 'center' | 'end';
+}
+/**
+ * Configuração de tooltip com texto.
+ * Exibe um tooltip ao redor da label do select.
+ */
+interface WithTooltip$2 extends BaseTooltipConfig$2 {
+    /** Texto do tooltip exibido no hover */
+    tooltipText: string;
+}
+/**
+ * Configuração sem tooltip.
+ */
+interface WithoutTooltip$2 {
+    tooltipText?: never;
+    tooltipSide?: never;
+    tooltipAlign?: never;
+}
+/**
+ * Union type representando a configuração de tooltip do select.
+ * Pode ter tooltip com texto (e opcionalmente side/align) ou sem tooltip.
+ */
+type SelectTooltipConfig = WithTooltip$2 | WithoutTooltip$2;
 /**
  * Representa um item do select
  */
@@ -1166,7 +1301,7 @@ type SelectVariant = 'text' | 'icon' | 'checkbox';
  * />
  * ```
  */
-interface SelectProps extends ScalableProps {
+interface SelectPropsBase extends ScalableProps {
     /** Array de itens do select */
     items: SelectItemProps[];
     /** Callback executado quando o valor muda: (value) => void */
@@ -1191,20 +1326,14 @@ interface SelectProps extends ScalableProps {
     helperText?: string;
     /** Largura máxima do select */
     maxWidth?: number;
+    /** Indica estado de erro externo */
+    error?: boolean;
     /** Mensagem de erro a ser exibida */
     errorMessage?: string;
     /** Label acessível para leitores de tela */
     'aria-label'?: string;
     /** ID para testes automatizados */
     'data-testid'?: string;
-    /** Habilita tooltip */
-    tooltip?: boolean;
-    /** Texto do tooltip */
-    tooltipText?: string;
-    /** Lado onde o dropdown abre */
-    side?: Side;
-    /** Alinhamento do dropdown */
-    align?: Align;
     /** Habilita scroll infinito */
     enableInfiniteScroll?: boolean;
     /** Callback executado ao chegar ao final do scroll: () => void */
@@ -1218,6 +1347,13 @@ interface SelectProps extends ScalableProps {
     /** Estado de busca em andamento */
     isSearching?: boolean;
 }
+/**
+ * Props completas do Select, incluindo a configuração de tooltip.
+ *
+ * O tooltip é ativado automaticamente quando `tooltipText` é informado,
+ * e as props `tooltipSide` e `tooltipAlign` ficam disponíveis para posicionamento.
+ */
+type SelectProps = SelectPropsBase & SelectTooltipConfig;
 
 declare const Select: React__default.FC<SelectProps>;
 
@@ -1290,7 +1426,7 @@ interface TableProps<T = TableRowData> extends BaseProps {
     };
 }
 
-declare const Table: <T extends TableRowData = TableRowData>({ columns, dataSource, className, loading, rowSelection, locale, onRow, ...rest }: TableProps<T>) => react_jsx_runtime.JSX.Element | null;
+declare const Table: <T extends TableRowData = TableRowData>({ columns, dataSource, className, loading, rowSelection, locale, onRow, ...rest }: TableProps<T>) => React__default.JSX.Element | null;
 
 interface BaseFilterItem$1 {
     id?: string;
@@ -1351,7 +1487,7 @@ declare module '@tanstack/react-table' {
     interface ColumnMeta<TData extends RowData, TValue> {
         /** Alinhamento do conteúdo da célula */
         align?: 'left' | 'center' | 'right';
-        /** Altura máxima do conteúdo da célula (ex: 48, '3rem'). Aplica overflow: hidden */
+        /** Altura máxima do conteúdo da célula (padrão: 64px). Aplica overflow: hidden */
         maxHeight?: number | string;
     }
 }
@@ -1601,32 +1737,42 @@ interface TableV2Props<T = Record<string, unknown>> extends EmptyStateProps {
     };
 }
 
-declare const TableV2: <T>({ columns, data, rowSelection: rowSelectionConfig, enableSorting, bulkActions, header, footer, loading, emptyIcon, emptyTitle, emptyText, onRow, className, }: TableV2Props<T>) => react_jsx_runtime.JSX.Element;
+declare const TableV2: <T>({ columns, data, rowSelection: rowSelectionConfig, enableSorting, bulkActions, header, footer, loading, emptyIcon, emptyTitle, emptyText, onRow, className, }: TableV2Props<T>) => React$1.JSX.Element;
 
 /**
- * Props do componente TextArea
- * @example
- * ```tsx
- * <TextArea
- *   label="Descrição"
- *   value={description}
- *   onChange={setDescription}
- *   placeholder="Digite uma descrição"
- * />
- * ```
- * @example
- * ```tsx
- * <TextArea
- *   label="Comentário"
- *   required
- *   maxLength={500}
- *   showCharCount
- *   helperText="Máximo de 500 caracteres"
- *   errorMessage={error}
- * />
- * ```
+ * Props base compartilhadas por todas as configurações de tooltip do TextArea.
+ */
+interface BaseTooltipConfig$1 {
+    /** Lado em que o tooltip será exibido */
+    tooltipSide?: Side;
+    /** Alinhamento do tooltip */
+    tooltipAlign?: Align;
+}
+/**
+ * Configuração de tooltip com texto.
+ * Exibe um tooltip ao redor da label do TextArea.
+ */
+interface WithTooltip$1 extends BaseTooltipConfig$1 {
+    /** Texto do tooltip exibido no hover */
+    tooltipText: string;
+}
+/**
+ * Configuração sem tooltip.
  */
-interface TextAreaProps extends Omit<React__default.TextareaHTMLAttributes<HTMLTextAreaElement>, 'onChange' | 'value'> {
+interface WithoutTooltip$1 {
+    tooltipText?: never;
+    tooltipSide?: never;
+    tooltipAlign?: never;
+}
+/**
+ * Union type representando a configuração de tooltip do TextArea.
+ * Pode ter tooltip com texto (e opcionalmente side/align) ou sem tooltip.
+ */
+type TextAreaTooltipConfig = WithTooltip$1 | WithoutTooltip$1;
+/**
+ * Props base do componente TextArea.
+ */
+interface TextAreaPropsBase extends Omit<React__default.TextareaHTMLAttributes<HTMLTextAreaElement>, 'onChange' | 'value'> {
     /** Valor controlado do campo */
     value?: string;
     /** Callback executado quando o valor muda: (value) => void */
@@ -1635,14 +1781,6 @@ interface TextAreaProps extends Omit<React__default.TextareaHTMLAttributes<HTMLT
     label?: string;
     /** Texto de ajuda exibido abaixo do campo */
     helperText?: string;
-    /** Habilita tooltip */
-    tooltip?: boolean;
-    /** Texto do tooltip */
-    tooltipText?: string;
-    /** Lado onde o tooltip aparece */
-    side?: Side;
-    /** Alinhamento do tooltip */
-    align?: Align;
     /**
      * Mensagem de erro exibida no campo.
      * Usada tanto pela validação interna (required, etc.)
@@ -1654,7 +1792,7 @@ interface TextAreaProps extends Omit<React__default.TextareaHTMLAttributes<HTMLT
     /** Controla o redimensionamento do textarea */
     resize?: 'none' | 'vertical' | 'both';
     /** Exibe contador de caracteres (requer maxLength) */
-    showCharCount?: boolean;
+    charCount?: boolean;
     /** Altura do textarea em pixels */
     height?: number;
     /** Classe CSS opcional */
@@ -1662,13 +1800,55 @@ interface TextAreaProps extends Omit<React__default.TextareaHTMLAttributes<HTMLT
     /** Tipo do teclado virtual (padrão: undefined = desabilitado) */
     virtualKeyboard?: VirtualKeyboardType;
 }
+/**
+ * Props completas do TextArea, incluindo a configuração de tooltip.
+ *
+ * O tooltip é ativado automaticamente quando `tooltipText` é informado,
+ * e as props `tooltipSide` e `tooltipAlign` ficam disponíveis para posicionamento.
+ */
+type TextAreaProps = TextAreaPropsBase & TextAreaTooltipConfig;
 
-declare const _default$1: React__default.NamedExoticComponent<TextAreaProps & React__default.RefAttributes<HTMLTextAreaElement>>;
+declare const _default$1: React__default.MemoExoticComponent<{
+    ({ ref, className, value, label, placeholder, onChange, disabled, maxLength, required, helperText, tooltipText, tooltipSide, tooltipAlign, errorMessage, error, id, onBlur, onFocus, name, resize, charCount, height, virtualKeyboard, ...rest }: TextAreaProps & {
+        ref?: React__default.Ref<HTMLTextAreaElement>;
+    }): React__default.JSX.Element;
+    displayName: string;
+}>;
 
 /** Tipos de input suportados pelo TextField */
 type TextFieldType = 'text' | 'email' | 'password' | 'number' | 'tel' | 'url';
 /**
- * Props do componente TextField
+ * Props base compartilhadas por todas as configurações de tooltip do TextField.
+ */
+interface BaseTooltipConfig {
+    /** Lado em que o tooltip será exibido */
+    tooltipSide?: Side;
+    /** Alinhamento do tooltip */
+    tooltipAlign?: Align;
+}
+/**
+ * Configuração de tooltip com texto.
+ * Exibe um tooltip ao redor da label do TextField.
+ */
+interface WithTooltip extends BaseTooltipConfig {
+    /** Texto do tooltip exibido no hover */
+    tooltipText: string;
+}
+/**
+ * Configuração sem tooltip.
+ */
+interface WithoutTooltip {
+    tooltipText?: never;
+    tooltipSide?: never;
+    tooltipAlign?: never;
+}
+/**
+ * Union type representando a configuração de tooltip do TextField.
+ * Pode ter tooltip com texto (e opcionalmente side/align) ou sem tooltip.
+ */
+type TextFieldTooltipConfig = WithTooltip | WithoutTooltip;
+/**
+ * Props base do componente TextField
  * @example
  * ```tsx
  * <TextField
@@ -1687,13 +1867,12 @@ type TextFieldType = 'text' | 'email' | 'password' | 'number' | 'tel' | 'url';
  *   required
  *   helperText="Mínimo 8 caracteres"
  *   errorMessage={error}
- *   tooltip={true}
  *   tooltipText="Deve conter letras e números"
  *   icon={<LockIcon />}
  * />
  * ```
  */
-interface TextFieldProps extends ScalableProps, Omit<React__default.InputHTMLAttributes<HTMLInputElement>, 'onChange' | 'value' | 'type'> {
+interface TextFieldPropsBase extends ScalableProps, Omit<React__default.InputHTMLAttributes<HTMLInputElement>, 'onChange' | 'value' | 'type'> {
     /** Valor controlado do campo */
     value?: string | number;
     /** Callback executado quando o valor muda: (value) => void */
@@ -1704,14 +1883,6 @@ interface TextFieldProps extends ScalableProps, Omit<React__default.InputHTMLAtt
     type?: TextFieldType;
     /** Texto de ajuda exibido abaixo do campo */
     helperText?: string;
-    /** Habilita tooltip */
-    tooltip?: boolean;
-    /** Texto do tooltip */
-    tooltipText?: string;
-    /** Lado onde o tooltip aparece */
-    tooltipSide?: Side;
-    /** Alinhamento do tooltip */
-    tooltipAlign?: Align;
     /**
      * Mensagem de erro exibida no campo.
      * Usada tanto pela validação interna (required, formato, etc.)
@@ -1731,8 +1902,20 @@ interface TextFieldProps extends ScalableProps, Omit<React__default.InputHTMLAtt
     /** Desabilita o autocomplete nativo do browser (padrão: false) */
     disableAutoComplete?: boolean;
 }
+/**
+ * Props completas do TextField, incluindo a configuração de tooltip.
+ *
+ * O tooltip é ativado automaticamente quando `tooltipText` é informado,
+ * e as props `tooltipSide` e `tooltipAlign` ficam disponíveis para posicionamento.
+ */
+type TextFieldProps = TextFieldPropsBase & TextFieldTooltipConfig;
 
-declare const _default: React__default.NamedExoticComponent<TextFieldProps & React__default.RefAttributes<HTMLInputElement>>;
+declare const _default: React__default.MemoExoticComponent<{
+    ({ ref, className, style, value, label, placeholder, type, onChange, disabled, maxLength, required, helperText, tooltipText, tooltipSide, tooltipAlign, errorMessage, error, id, icon, scale, onBlur, onFocus, name, persistIcon, virtualKeyboard, attachedToVirtualKeyboard, disableAutoComplete, ...rest }: TextFieldProps & {
+        ref?: React__default.Ref<HTMLInputElement>;
+    }): React__default.JSX.Element;
+    displayName: string;
+}>;
 
 /**
  * Props do componente individual de notificação `Toast`.
@@ -1970,61 +2153,57 @@ interface SwitchProps extends ScalableProps {
 
 declare const Switch: React$1.FC<SwitchProps>;
 
-/** Tipos de entrada suportados pelo VerificationCode */
-type InputType = 'numeric' | 'alpha' | 'alphanumeric';
+/** Tipos de validação suportados pelo VerificationCode */
+type OTPValidationType = 'numeric' | 'alphanumeric' | 'alpha';
 /**
  * Props do componente VerificationCode
  * @example
  * ```tsx
  * <VerificationCode
  *   length={6}
- *   inputType="numeric"
- *   onComplete={(code) => handleVerification(code)}
+ *   validationType="numeric"
+ *   onValueChange={(v) => console.log(v)}
  * />
  * ```
  * @example
  * ```tsx
  * <VerificationCode
  *   length={4}
- *   inputType="alphanumeric"
- *   onComplete={handleCode}
+ *   name="otp"
+ *   autoSubmit
+ *   onAutoSubmit={(v) => handleVerify(v)}
  *   hasError={!!error}
  *   errorMessage="Código inválido"
- *   disabled={isVerifying}
  * />
  * ```
  */
 interface VerificationCodeProps extends BaseProps {
-    /** Número de dígitos do código (padrão: 6) */
+    /** Número de campos/dígitos (padrão: 6) */
     length?: number;
-    /** Tipo de entrada permitida (padrão: "numeric") */
-    inputType?: InputType;
-    /** Callback executado quando todos os campos são preenchidos: (value) => void */
-    onComplete?: (value: string) => void;
+    /** Tipo de validação aceita pelo campo (padrão: 'numeric') */
+    validationType?: OTPValidationType;
+    /** Valor controlado do campo */
+    value?: string;
+    /** Valor inicial não controlado */
+    defaultValue?: string;
+    /** Callback chamado quando o valor muda */
+    onValueChange?: (value: string) => void;
+    /** Submete o formulário associado automaticamente ao completar */
+    autoSubmit?: boolean;
+    /** Callback chamado ao completar (quando autoSubmit está ativo) */
+    onAutoSubmit?: (value: string) => void;
+    /** Nome do campo para envio em formulários */
+    name?: string;
+    /** ID do formulário associado */
+    form?: string;
     /** Define se o campo está em estado de erro */
     hasError?: boolean;
     /** Mensagem de erro exibida abaixo do componente */
     errorMessage?: string;
-    /** Props adicionais passadas para os inputs */
-    [key: string]: any;
+    /** Define o campo como somente leitura */
+    readOnly?: boolean;
 }
 
-/**
- * Componente VerificationCode para entrada de códigos de verificação
- *
- * @description Permite entrada de códigos com múltiplos dígitos,
- * suportando diferentes tipos de caracteres e navegação por teclado.
- *
- * @example
- * ```tsx
- * <VerificationCode
- *   length={6}
- *   inputType="numeric"
- *   onComplete={(code) => console.log('Código:', code)}
- *   hasError={false}
- * />
- * ```
- */
 declare const VerificationCode: React__default.FC<VerificationCodeProps>;
 
 /**
@@ -2150,5 +2329,5 @@ declare function useInfiniteScroll({ status, page, lastPage, onLoadMore, thresho
 
 declare const normalizeText: (text: React.ReactNode) => string;
 
-export { Avatar, Badge, Button, Calendar, Callout, Card, Checkbox, MemoizedChips as Chips, Container, _default$2 as DatePicker, Dialog, Drawer, Filter, ListItem, Menu, Modal, Popover, memorizedQuantity as Quantity, Radio, Search, Select, Switch, Table, TableHeader, TablePagination, TableV2, _default$1 as TextArea, _default as TextField, Toast, ToastContainer, ToastProvider, Tooltip, VerificationCode, VirtualKeyboard, normalizeText, useApiSimulation, useInfiniteScroll, useToast };
-export type { AvatarProps, BadgeProps, ButtonProps, CalendarProps, CalloutProps, CardProps, CheckboxProps, ChipsProps, ContainerProps, DatePickerProps, DialogProps, DrawerProps, FilterItem$1 as FilterItem, FilterProps, ListItemProps, MenuProps, ModalProps, PopoverProps, QuantityProps, RadioGroupProps, RadioProps, SearchProps, SelectProps, SwitchProps, TableHeaderProps, TablePaginationProps, TableProps, TableV2FooterProps, TableV2HeaderProps, TableV2Props, TextAreaProps, TextFieldProps, ToastProps, TooltipProps, VerificationCodeProps, VirtualKeyboardProps, VirtualKeyboardVariant };
+export { Avatar, Badge, Button, Calendar, Callout, Card, Checkbox, MemoizedChips as Chips, Container, _default$2 as DatePicker, Dialog, Drawer, FileUpload, Filter, ListItem, Menu, Modal, Popover, memorizedQuantity as Quantity, Radio, Search, Select, Switch, Table, TableHeader, TablePagination, TableV2, _default$1 as TextArea, _default as TextField, Toast, ToastContainer, ToastProvider, Tooltip, VerificationCode, VirtualKeyboard, normalizeText, useApiSimulation, useInfiniteScroll, useToast };
+export type { AvatarProps, BadgeProps, ButtonProps, CalendarProps, CalloutProps, CardProps, CheckboxProps, ChipsProps, ContainerProps, DatePickerProps, DialogProps, DrawerProps, FileUploadProps, FilterItem$1 as FilterItem, FilterProps, ListItemProps, MenuProps, ModalProps, PopoverProps, QuantityProps, RadioGroupProps, RadioProps, SearchProps, SelectProps, SwitchProps, TableHeaderProps, TablePaginationProps, TableProps, TableV2FooterProps, TableV2HeaderProps, TableV2Props, TextAreaProps, TextFieldProps, ToastProps, TooltipProps, VerificationCodeProps, VirtualKeyboardProps, VirtualKeyboardVariant };