@giro-ds/react 8.0.0 → 9.1.0

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import * as React$1 from 'react';
-import React__default, { ReactNode, ReactElement, ComponentPropsWithoutRef, CSSProperties } 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 { RowData, ColumnDef } from '@tanstack/react-table';
@@ -18,6 +18,7 @@ type Side = 'top' | 'right' | 'bottom' | 'left';
 type Align = 'start' | 'center' | 'end';
 /** Posição horizontal de um elemento secundário: 'right' (direita), 'left' (esquerda) ou 'both' (ambos os lados) */
 type Position = 'right' | 'left' | 'both';
+type Scale = 1 | 1.5 | 2;
 /** Localidade do componente: 'pt-br' (Português do Brasil) ou 'en-us' (Inglês dos EUA) */
 type Locale = 'pt-br' | 'en-us';
 /** Props base compartilhadas por todos os componentes do design system */
@@ -78,7 +79,7 @@ interface BadgeProps extends BaseProps {
     badgeValue?: number | string | null;
     /** Label acessível para leitores de tela */
     'aria-label'?: string;
-    /** Prop que sinaliza se o Badge será usado no Filter ou não, pois no Filter ele tem uma cor diferente */
+    /** Quando `true`, aplica a variante de cor do Filter (fundo azul em vez do padrão vermelho) */
     filterVariant?: boolean;
     /** Classe CSS opcional */
     className?: string;
@@ -114,6 +115,8 @@ type ButtonOwnPropsBase = {
     type?: 'button' | 'submit' | 'reset';
     /** Tamanho do botão */
     size?: Size;
+    /** Escala visual aplicada ao botão */
+    scale?: Scale;
     /** Define se o botão ocupa 100% da largura do container */
     fullWidth?: boolean;
     /** Label acessível para leitores de tela */
@@ -231,10 +234,12 @@ interface CalendarBaseProps extends Omit<BaseProps, 'disabled'> {
     autoFocus?: boolean;
     /** Substitui os `classNames` padrão do react-day-picker. */
     classNames?: Partial<Record<string, string>>;
+    /** Escala visual aplicada ao componente */
+    scale?: Scale;
 }
 type CalendarProps = CalendarBaseProps;
 
-declare const Calendar: ({ selected, currentDate, defaultMonth, startMonth, endMonth, onDaySelect, onDateChange, onClear: _onClear, minDate, maxDate, disabled, format: _format, locale, autoFocus, className, id, "aria-label": ariaLabel, ...rest }: CalendarProps) => react_jsx_runtime.JSX.Element;
+declare const Calendar: ({ selected, currentDate, defaultMonth, startMonth, endMonth, onDaySelect, onDateChange, onClear: _onClear, minDate, maxDate, disabled, format: _format, locale, autoFocus, className, scale, id, "aria-label": ariaLabel, ...rest }: CalendarProps) => react_jsx_runtime.JSX.Element;
 
 /**
  * Props do componente Callout
@@ -322,6 +327,8 @@ interface CheckboxProps extends BaseProps {
     indeterminate?: boolean;
     /** Classe CSS opcional */
     className?: string;
+    /** Escala visual aplicada ao componente */
+    scale?: Scale;
 }
 
 declare const Checkbox: React$1.FC<CheckboxProps>;
@@ -361,6 +368,8 @@ interface ChipsProps extends BaseProps, Omit<React$1.HTMLAttributes<HTMLDivEleme
     style?: React$1.CSSProperties;
     /** Classe CSS opcional */
     className?: string;
+    /** Escala visual aplicada ao componente */
+    scale?: Scale;
 }
 
 declare const MemoizedChips: React__default.NamedExoticComponent<ChipsProps>;
@@ -436,6 +445,10 @@ interface DatePickerProps extends BaseProps {
     'data-testid'?: string;
     /** Classe CSS opcional */
     className?: string;
+    /** Escala visual aplicada ao componente */
+    datePickerScale?: Scale;
+    /** Escala visual aplicada ao calendário */
+    calendarScale?: Scale;
 }
 
 declare const _default$2: React__default.NamedExoticComponent<DatePickerProps>;
@@ -523,25 +536,32 @@ interface DrawerProps extends BaseProps {
     closeOnEscape?: boolean;
     /** Classe CSS opcional */
     className?: string;
+    /** Conteúdo fixo exibido abaixo da área rolável, sem acompanhar o scroll */
+    footer?: ReactNode;
 }
 
 declare const Drawer: React__default.FC<DrawerProps>;
 
 interface FilterItem$2 {
-    id?: string;
+    /** Identificador único do item (usado em `selectedIds` e `onApplyFilter`) */
+    id?: BaseProps['id'];
+    /** Texto principal exibido no item */
     text: string;
+    /** Texto secundário exibido abaixo do texto principal */
     subText?: string;
+    /** Ícone exibido à esquerda do texto */
     icon?: ReactNode;
-    disabled?: boolean;
+    /** Desabilita o item, impedindo sua seleção */
+    disabled?: BaseProps['disabled'];
 }
-type FilterType = 'text' | 'checkbox' | 'icon' | 'calendar';
+type FilterType = 'single' | 'multiple' | 'calendar';
 /**
  * Props do componente Filter
  * @example
  * ```tsx
  * <Filter
  *   items={filterItems}
- *   type="checkbox"
+ *   type="multiple"
  *   placeholder="Filtrar por categoria"
  *   onApplyFilter={(ids) => handleFilter(ids)}
  *   buttonText="Filtros"
@@ -599,7 +619,27 @@ interface FilterProps extends BaseProps {
     /** Idioma do calendário */
     locale?: Locale;
     /** Classe CSS opcional */
-    className?: string;
+    className?: BaseProps['className'];
+    /**
+     * Modo de exibição do filtro
+     * - `'simple'`: filtro simples com popover (padrão)
+     * - `'combined'`: filtro combinado com painel lateral onde o conteúdo é composto via children
+     */
+    mode?: 'simple' | 'combined';
+    /** Largura do painel lateral no modo combined (ex: '400px', '50vw'). Quando omitido, usa o tamanho padrão do Drawer */
+    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;
+    /** Conteúdo customizado no cabeçalho do Drawer */
+    drawerHeaderContent?: ReactNode;
+    /** Conteúdo do painel lateral no modo combined */
+    children?: ReactNode;
+    /** Callback ao aplicar no modo combined: () => void */
+    onApply?: () => void;
+    /** Callback ao limpar no modo combined: () => void */
+    onClear?: () => void;
 }
 
 declare const Filter: React__default.FC<FilterProps>;
@@ -649,9 +689,9 @@ interface ListItemProps extends BaseProps {
     icon?: React$1.ReactNode;
     /** Valor do input (para variantes checkbox/radio) */
     value?: string;
-    /** Define se deve mostrar o subtexto */
+    /** Controla a visibilidade do subtexto explicitamente, independentemente de `subText` estar preenchido */
     showSubText?: boolean;
-    /** Estado de hover */
+    /** Força o estado visual de hover no item (útil para controle externo de foco/seleção) */
     hovered?: boolean;
     /** Classe CSS opcional */
     className?: string;
@@ -710,7 +750,11 @@ interface MenuProps extends BaseProps {
     items: MenuItemProps[];
     /** Elemento trigger customizado para abrir o menu */
     children?: ReactElement;
-    /** Tipo de visualização do menu */
+    /**
+     * Tipo de visualização dos itens do menu.
+     * - `'text'` (padrão): exibe texto e ícone lado a lado
+     * - `'icon'`: exibe apenas ícones, sem texto
+     */
     type?: 'text' | 'icon';
     /** Callback executado quando um item é selecionado: (item) => void */
     onItemSelect?: (items: MenuItemProps) => void;
@@ -736,6 +780,10 @@ interface MenuProps extends BaseProps {
     onOpenChange?: (open: boolean) => void;
     /** Classe CSS opcional */
     className?: string;
+    /** Escala visual aplicada ao conteúdo do menu */
+    dropdownScale?: Scale;
+    /** Escala visual aplicada ao botão/trigger quando ele aceitar a prop `scale` */
+    buttonScale?: Scale;
 }
 
 declare const Menu: React__default.FC<MenuProps>;
@@ -790,9 +838,13 @@ interface ModalProps extends BaseProps {
 declare const Modal: React$1.FC<ModalProps>;
 
 interface PopoverProps {
-    trigger: React.ReactNode;
-    content: React.ReactNode;
+    /** Elemento que aciona a abertura do popover (geralmente um botão ou ícone) */
+    trigger: React$1.ReactNode;
+    /** Conteúdo exibido dentro do popover ao abrir */
+    content: React$1.ReactNode;
+    /** Alinhamento do popover em relação ao trigger no eixo perpendicular ao `side`. @default 'center' */
     align?: Align;
+    /** Lado em que o popover aparece em relação ao trigger. @default 'bottom' */
     side?: Side;
     /** Distância em pixels entre o conteúdo e o trigger */
     sideOffset?: number;
@@ -801,12 +853,12 @@ interface PopoverProps {
     /** Callback chamado quando o estado de abertura muda */
     onOpenChange?: (open: boolean) => void;
     /**
-    * Quando `true`, o trigger atua como âncora de posicionamento e o popover
-    * é aberto/fechado exclusivamente via `open`/`onOpenChange` (modo DatePicker).
-    * Quando `false` (padrão), o trigger continua abrindo/fechando o popover
-    * normalmente, mas o estado pode ser sincronizado via `open`/`onOpenChange`
-    * (modo Filter).
-    */
+     * Quando `true`, o trigger atua como âncora de posicionamento e o popover
+     * é aberto/fechado exclusivamente via `open`/`onOpenChange` (modo DatePicker).
+     * Quando `false` (padrão), o trigger continua abrindo/fechando o popover
+     * normalmente, mas o estado pode ser sincronizado via `open`/`onOpenChange`
+     * (modo Filter).
+     */
     asAnchor?: boolean;
     /** Callback chamado quando o foco automático é ativado ao abrir o popover */
     onOpenAutoFocus?: (event: Event) => void;
@@ -836,7 +888,7 @@ declare const Popover: React$1.FC<PopoverProps>;
  *   value={1}
  *   decimal={true}
  *   decimalPlaces={2}
- *   step={0.5}
+ *   valueIncrement={0.5}
  *   disabled={false}
  * />
  * ```
@@ -873,6 +925,8 @@ interface QuantityProps extends BaseProps {
     inputAriaLabel?: string;
     /** Classe CSS opcional */
     className?: string;
+    /** Escala visual aplicada ao componente */
+    scale?: Scale;
 }
 
 declare const memorizedQuantity: React__default.NamedExoticComponent<QuantityProps>;
@@ -929,10 +983,79 @@ interface RadioGroupProps extends BaseProps {
     ariaLabel?: string;
     /** Orientação do layout dos radio buttons */
     orientation?: "horizontal" | "vertical";
+    /** Escala visual aplicada ao grupo */
+    scale?: Scale;
 }
 
 declare const Radio: React__default.FC<RadioGroupProps>;
 
+/**
+ * Modo de exibição do VirtualKeyboard.
+ * - `native`: age como teclado nativo — aparecerá ao focar em um campo (implementação futura).
+ * - `fixed`: teclado sempre visível na tela com um TextField próprio acima dele.
+ */
+type VirtualKeyboardVariant = 'native' | 'fixed';
+/** Layouts disponíveis para o VirtualKeyboard */
+type VirtualKeyboardType = 'default' | 'numeric';
+/**
+ * Props do componente VirtualKeyboard
+ * @example
+ * ```tsx
+ * // Modo fixed: teclado sempre visível com TextField próprio
+ * <VirtualKeyboard
+ *   variant="fixed"
+ *   type="default"
+ *   onChange={(value) => setValue(value)}
+ * />
+ * ```
+ * @example
+ * ```tsx
+ * // Modo native: teclado gerenciado externamente (futuramente acionado por foco)
+ * <VirtualKeyboard
+ *   variant="native"
+ *   type="numeric"
+ *   value={pin}
+ *   onChange={setPin}
+ *   maxLength={4}
+ * />
+ * ```
+ */
+interface VirtualKeyboardProps extends Omit<BaseProps, 'disabled'> {
+    /**
+     * Modo de exibição do teclado.
+     * - `native`: comporta-se como teclado nativo (acionamento por foco — futuramente implementado).
+     * - `fixed`: teclado fixo na tela com um TextField próprio acima.
+     * @default 'native'
+     */
+    variant?: VirtualKeyboardVariant;
+    /** Valor controlado do input vinculado ao teclado */
+    value?: string;
+    /** Tipo do teclado (padrão: "default") */
+    type?: VirtualKeyboardType;
+    /** Callback executado quando o valor do input muda: (value) => void */
+    onChange?: (value: string) => void;
+    /** Callback executado quando uma tecla é pressionada: (key) => void */
+    onKeyPress?: (key: string) => 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;
+    /** Texto de ajuda do TextField exibido no modo `fixed` */
+    helperText?: string;
+    /** Sinaliza erro no TextField exibido no modo `fixed` */
+    error?: boolean;
+    /** Mensagem de erro do TextField exibido no modo `fixed` */
+    errorMessage?: string;
+    /**
+     * Ref para o campo de input que aciona o teclado no modo `native`.
+     * O teclado aparece ao focar no elemento referenciado e some ao perder o foco.
+     * Se omitido no modo `native`, o teclado permanece sempre visível.
+     */
+    targetRef?: RefObject<HTMLInputElement | HTMLTextAreaElement | null>;
+}
+
 /**
  * Props do componente Search
  * @example
@@ -974,10 +1097,30 @@ interface SearchProps extends BaseProps, NativeInputProps {
     onClick?: (e: React$1.MouseEvent<HTMLDivElement>) => void;
     /** Callback executado ao pressionar mouse no componente: (e) => void */
     onMouseDown?: (e: React$1.MouseEvent<HTMLDivElement>) => void;
+    /**
+     * Modo de pesquisa:
+     * - `'instant'` (padrão): dispara a busca a cada tecla digitada
+     * - `'on-enter'`: dispara a busca somente ao pressionar Enter
+     */
+    searchMode?: 'instant' | 'on-enter';
+    /**
+     * Callback executado quando a busca é acionada.
+     * - No modo `'instant'`: chamado a cada mudança de valor
+     * - No modo `'on-enter'`: chamado somente ao pressionar Enter
+     */
+    onSearch?: (value: string) => void;
     /** ID para testes automatizados */
     'data-testid'?: string;
     /** Classe CSS opcional */
     className?: string;
+    /** Habilita o teclado virtual */
+    virtualKeyboard?: boolean;
+    /** Variante do teclado virtual (padrão: 'default') */
+    virtualKeyboardType?: VirtualKeyboardType;
+    /** Comprimento máximo permitido pelo teclado virtual */
+    virtualKeyboardMaxLength?: number;
+    /** Escala visual aplicada ao componente */
+    scale?: Scale;
 }
 
 declare const Search: React__default.ForwardRefExoticComponent<SearchProps & React__default.RefAttributes<HTMLInputElement>>;
@@ -1081,6 +1224,8 @@ interface SelectProps extends BaseProps {
     isSearching?: boolean;
     /** Classe CSS opcional */
     className?: string;
+    /** Escala visual aplicada ao componente */
+    scale?: Scale;
 }
 
 declare const Select: React__default.FC<SelectProps>;
@@ -1167,7 +1312,7 @@ interface BaseFilterItem$1 {
     tooltip?: string;
 }
 interface CheckboxFilterItem$1 extends BaseFilterItem$1 {
-    type: 'checkbox' | 'text' | 'icon';
+    type: 'multiple' | 'single';
     items: FilterItem$2[];
     selectedIds?: string[];
     onSelectionChange?: (selectedIds: string[]) => void;
@@ -1239,12 +1384,12 @@ interface BaseFilterItem {
     onToggle?: (isOpen: boolean) => void;
 }
 /**
- * Props de filtro do tipo checkbox, texto ou ícone.
+ * Props de filtro do tipo multiple, single ou ícone.
  * Renderiza uma lista de opções selecionáveis.
  */
 interface CheckboxFilterItem extends BaseFilterItem {
     /** Tipo do filtro */
-    type: 'checkbox' | 'text' | 'icon';
+    type: 'multiple' | 'single';
     /** Lista de itens disponíveis para seleção */
     items: FilterItem$2[];
     /** IDs dos itens atualmente selecionados */
@@ -1278,21 +1423,63 @@ interface CalendarFilterItem extends BaseFilterItem {
     /** Placeholder exibido quando nenhuma data está selecionada */
     placeholder?: string;
 }
+/**
+ * Props de filtro do tipo combined.
+ * Abre um painel lateral (Drawer) com conteúdo composto via children.
+ */
+interface CombinedFilterItem extends BaseFilterItem {
+    /** Tipo do filtro */
+    type: 'combined';
+    /** Título do painel lateral (padrão: 'Filtrar') */
+    title?: string;
+    /** Largura do painel lateral (ex: '400px', '50vw') */
+    drawerWidth?: string;
+    /** Número de filtros ativos exibido como badge no botão */
+    activeCount?: number;
+    /** Conteúdo customizado no cabeçalho do Drawer */
+    drawerHeaderContent?: ReactNode;
+    /** Conteúdo do painel lateral */
+    children?: ReactNode;
+    /** Callback ao clicar em Aplicar */
+    onApply?: () => void;
+    /** Callback ao clicar em Limpar */
+    onClear?: () => void;
+    /** Variante visual do botão (padrão: 'outlined') */
+    variant?: Variant;
+}
 /**
  * Union type representando um item de filtro da tabela.
- * Pode ser do tipo checkbox/texto/ícone ou calendário.
+ * Pode ser do tipo multiple/single, calendário ou combined (Drawer).
  */
-type FilterItem = CheckboxFilterItem | CalendarFilterItem;
+type FilterItem = CheckboxFilterItem | CalendarFilterItem | CombinedFilterItem;
 /**
  * Props do cabeçalho do TableV2, com busca global e filtros.
  */
 interface TableV2HeaderProps {
     /** Placeholder do campo de busca global */
     searchPlaceholder?: string;
-    /** Exibe o campo de busca (padrão: true) */
-    showSearch?: boolean;
     /** Items de filtro (Status, Data de início, etc.) */
     filterItems?: FilterItem[];
+    /** Habilita o teclado virtual */
+    virtualKeyboard?: boolean;
+    /** Tipo do teclado virtual (padrão: 'default') */
+    virtualKeyboardType?: VirtualKeyboardType;
+    /** Comprimento máximo permitido pelo teclado virtual */
+    virtualKeyboardMaxLength?: number;
+    /** Modo de busca: 'instant' chama onSearchChange a cada tecla; 'on-enter' chama apenas ao pressionar Enter (padrão) */
+    searchMode?: 'instant' | 'on-enter';
+    /**
+     * Valor controlado do campo de busca.
+     * Permite que o pai redefina o texto exibido no campo (ex: ao limpar filtros).
+     */
+    searchValue?: string;
+    /**
+     * Callback chamado quando o valor da busca é confirmado.
+     * A presença deste callback é o que exibe o campo de busca —
+     * quando não fornecido, o campo de busca não é renderizado.
+     * A paginação é automaticamente resetada para a página 1 ao buscar.
+     */
+    onSearchChange?: (value: string) => void;
 }
 /**
  * Props do rodapé do TableV2, com controles de paginação.
@@ -1308,6 +1495,14 @@ interface TableV2FooterProps {
     onPageChange?: (page: number) => void;
     /** Callback chamado quando o tamanho da página muda */
     onPageSizeChange?: (pageSize: number) => void;
+    /**
+     * Página atual (1-based) para controle externo da paginação.
+     * Quando fornecido, sincroniza o estado interno com este valor,
+     * permitindo que o pai redefina a página — por exemplo, ao aplicar
+     * um filtro externo que deva redefinir para a página 1.
+     * Funciona tanto no modo client-side quanto no modo `manualPagination`.
+     */
+    currentPage?: number;
 }
 /**
  * Props para personalização do estado vazio da tabela.
@@ -1320,6 +1515,27 @@ interface EmptyStateProps {
     /** Texto descritivo exibido no estado vazio */
     emptyText?: ReactNode;
 }
+/**
+ * Props de configuração de seleção de linhas do TableV2.
+ */
+interface TableV2RowSelectionProps<T = Record<string, unknown>> {
+    /**
+     * Keys das linhas selecionadas (modo controlado).
+     * Quando fornecido, o componente não gerencia o estado de seleção internamente —
+     * o pai é responsável por atualizar este array via `onRowChange`.
+     */
+    selectedRowKeys?: (string | number)[];
+    /**
+     * Desabilita a seleção de uma linha específica.
+     * Pode ser um booleano global ou uma função chamada por linha.
+     */
+    disabled?: boolean | ((row: T, index: number) => boolean);
+    /** Callback chamado quando a seleção de linhas muda.
+     * Recebe os dados das linhas selecionadas e suas keys (índices). */
+    onRowChange?: (selectedRows: T[], selectedKeys: (string | number)[]) => void;
+    /** Desabilita o checkbox "selecionar todos" */
+    disableSelectAll?: boolean;
+}
 /**
  * Definição de uma ação em massa disponível na barra de seleção.
  */
@@ -1355,7 +1571,7 @@ interface TableV2BulkActionsProps<T = Record<string, unknown>> {
  *   columns={columns}
  *   data={data}
  *   enableSorting
- *   enableRowSelection
+ *   rowSelection={{ onRowChange: (rows, keys) => console.log(rows, keys) }}
  *   loading={isLoading}
  * />
  * ```
@@ -1365,14 +1581,21 @@ interface TableV2Props<T = Record<string, unknown>> extends EmptyStateProps {
     columns: ColumnDef<T, any>[];
     /** Dados exibidos na tabela */
     data: T[];
-    /** Habilita filtros individuais por coluna no <th> */
-    enableFilters?: boolean;
-    /** Habilita seleção de linhas via checkbox */
-    enableRowSelection?: boolean;
+    /**
+     * Configuração de seleção de linhas via checkbox.
+     * A presença deste objeto habilita a seleção. Use `disabled` para controlar
+     * linhas específicas e `onRowChange` para reagir às mudanças.
+     * @example
+     * ```tsx
+     * rowSelection={{
+     *   disabled: (row) => row.status !== 'pronto_para_fechar',
+     *   onRowChange: (rows, keys) => handleRowChange(rows, keys),
+     * }}
+     * ```
+     */
+    rowSelection?: TableV2RowSelectionProps<T>;
     /** Habilita ordenação de colunas ao clicar no cabeçalho */
     enableSorting?: boolean;
-    /** Callback chamado quando a seleção de linhas muda */
-    onRowSelectionChange?: (selectedRows: T[]) => void;
     /** Configuração das ações em massa exibidas quando há linhas selecionadas */
     bulkActions?: TableV2BulkActionsProps<T>;
     /** Header acima da tabela com busca + filtros */
@@ -1391,7 +1614,7 @@ interface TableV2Props<T = Record<string, unknown>> extends EmptyStateProps {
     };
 }
 
-declare const TableV2: <T>({ columns, data, enableFilters, enableRowSelection, enableSorting, onRowSelectionChange, 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_jsx_runtime.JSX.Element;
 
 /**
  * Props do componente TextArea
@@ -1449,6 +1672,12 @@ interface TextAreaProps extends Omit<React__default.TextareaHTMLAttributes<HTMLT
     height?: number;
     /** Classe CSS opcional */
     className?: string;
+    /** Habilita o teclado virtual */
+    virtualKeyboard?: boolean;
+    /** Tipo do teclado virtual (padrão: 'default') */
+    virtualKeyboardType?: VirtualKeyboardType;
+    /** Comprimento máximo permitido pelo teclado virtual */
+    virtualKeyboardMaxLength?: number;
 }
 
 declare const _default$1: React__default.NamedExoticComponent<TextAreaProps & React__default.RefAttributes<HTMLTextAreaElement>>;
@@ -1514,6 +1743,16 @@ interface TextFieldProps extends Omit<React__default.InputHTMLAttributes<HTMLInp
     persistIcon?: boolean;
     /** Classe CSS opcional */
     className?: string;
+    /** Habilita o teclado virtual */
+    virtualKeyboard?: boolean;
+    /** Tipo do teclado virtual (padrão: 'default') */
+    virtualKeyboardType?: VirtualKeyboardType;
+    /** Comprimento máximo permitido pelo teclado virtual */
+    virtualKeyboardMaxLength?: number;
+    /** Aplica variação visual para uso acoplado ao VirtualKeyboard no modo fixed */
+    attachedToVirtualKeyboard?: boolean;
+    /** Escala visual aplicada ao componente */
+    scale?: Scale;
 }
 
 declare const _default: React__default.NamedExoticComponent<TextFieldProps & React__default.RefAttributes<HTMLInputElement>>;
@@ -1744,14 +1983,16 @@ interface SwitchProps extends BaseProps {
     defaultChecked?: boolean;
     /** Callback executado quando o estado muda: (checked) => void */
     onCheckedChange?: (checked: boolean) => void;
-    /** Nome do input */
+    /** Nome do input — associa o switch a um campo de formulário (HTML `name`) */
     name?: string;
-    /** Valor do input */
+    /** Valor enviado no formulário quando o switch está ativo (análogo ao `value` do `<input type="checkbox">`) */
     value?: string;
     /** Estado atual (modo controlado) */
     checked?: boolean;
     /** Classe CSS opcional */
     className?: string;
+    /** Escala visual aplicada ao componente */
+    scale?: Scale;
 }
 
 declare const Switch: React$1.FC<SwitchProps>;
@@ -1813,6 +2054,33 @@ interface VerificationCodeProps extends BaseProps {
  */
 declare const VerificationCode: React__default.FC<VerificationCodeProps>;
 
+/**
+ * Componente VirtualKeyboard — teclado virtual on-screen para entradas controladas.
+ *
+ * @description Baseado em `react-simple-keyboard`, oferece apenas layouts nativos (QWERTY e numérico)
+ * seguindo o visual padrão da biblioteca.
+ *
+ * Possui dois modos:
+ * - **`native`** (padrão): age como teclado nativo — aparece ao focar no campo referenciado por `targetRef` e some ao perder o foco.
+ * - **`fixed`**: teclado sempre visível com um TextField próprio acima.
+ *
+ * @example
+ * ```tsx
+ * // Modo fixed
+ * <VirtualKeyboard variant="fixed" type="default" onChange={setValue} />
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Modo native — aparece ao focar no input
+ * const inputRef = useRef<HTMLInputElement>(null);
+ * const [value, setValue] = useState('');
+ * <input ref={inputRef} value={value} readOnly />
+ * <VirtualKeyboard targetRef={inputRef} value={value} onChange={setValue} />
+ * ```
+ */
+declare const VirtualKeyboard: React__default.FC<VirtualKeyboardProps>;
+
 /**
  * Configurações para simulação de API
  */
@@ -1909,5 +2177,5 @@ declare function useInfiniteScroll({ status, page, lastPage, onLoadMore, thresho
 
 declare const normalizeText: (text: React.ReactNode) => string;
 
-export { Avatar, Badge, Button, Calendar, Callout, 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, normalizeText, useApiSimulation, useInfiniteScroll, useToast };
-export type { AvatarProps, BadgeProps, ButtonProps, CalendarProps, CalloutProps, 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 };
+export { Avatar, Badge, Button, Calendar, Callout, 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, 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 };