@giro-ds/react 11.1.0 → 11.2.0

package/dist/index.d.ts

@@ -550,6 +550,41 @@ 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: React__default.ForwardRefExoticComponent<FileUploadProps & React__default.RefAttributes<HTMLInputElement>>;
+
 interface FilterItem$2 {
     /** Identificador único do item (usado em `selectedIds` e `onApplyFilter`) */
     id?: BaseProps['id'];
@@ -831,6 +866,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,6 +1069,14 @@ 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 */
@@ -1045,6 +1090,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` */
@@ -1970,61 +2022,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 +2198,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 };