@giro-ds/react 9.1.0 → 11.0.0

package/dist/index.d.ts

@@ -30,6 +30,13 @@ interface BaseProps {
     /** Quando `true`, desabilita interações com o componente */
     disabled?: boolean;
 }
+/** Props para componentes que suportam escala visual (1, 1.5 ou 2) */
+interface ScalableProps extends BaseProps {
+    /** Escala visual do componente */
+    scale?: Scale;
+    /** Estilos CSS inline adicionais */
+    style?: React__default.CSSProperties;
+}
 
 /**
  * Props do componente Avatar
@@ -115,8 +122,6 @@ 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 */
@@ -135,7 +140,7 @@ type ButtonOwnPropsBase = {
     className?: string;
     /** Handler de clique; tipado em HTMLElement para ser compatível com todos os modos */
     onClick?: React__default.MouseEventHandler<HTMLElement>;
-} & BaseProps;
+} & ScalableProps;
 /**
  * Props próprias do componente Button.
  * Quando `iconOnly: true`, a prop `icon` é **obrigatória**.
@@ -186,7 +191,7 @@ declare const Button: React__default.ForwardRefExoticComponent<ButtonProps & Rea
 
 /** Formato de exibição da data aceito pelo componente. */
 type DateFormat = 'dd/mm/yyyy' | 'mm/dd/yyyy' | (string & {});
-interface CalendarBaseProps extends Omit<BaseProps, 'disabled'> {
+interface CalendarBaseProps extends Omit<ScalableProps, 'disabled'> {
     /** Data selecionada atualmente (usada pelo DatePicker). */
     selected?: Date | null;
     /**
@@ -234,12 +239,10 @@ 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, scale, 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, style, scale, id, "aria-label": ariaLabel, ...rest }: CalendarProps) => react_jsx_runtime.JSX.Element;
 
 /**
  * Props do componente Callout
@@ -294,6 +297,27 @@ interface CalloutProps extends Omit<BaseProps, 'disabled'>, Omit<React$1.HTMLAtt
 
 declare const Callout: React__default.FC<CalloutProps>;
 
+/**
+ * Props do componente Card
+ * @example
+ * ```tsx
+ * <Card>
+ *   <h1>Conteúdo da página</h1>
+ *   <p>Texto dentro do card</p>
+ * </Card>
+ * ```
+ */
+interface CardProps {
+    /** Conteúdo a ser renderizado dentro do card */
+    children: React__default.ReactNode;
+    /** Classe CSS customizada aplicada ao elemento raiz do card */
+    className?: string;
+    /** Define se o card é interativo, aplicando estilos de hover e cursor pointer */
+    hoverable?: boolean;
+}
+
+declare function Card({ children, className, hoverable }: CardProps): react_jsx_runtime.JSX.Element;
+
 /**
  * Props do componente Checkbox
  * @example
@@ -314,7 +338,7 @@ declare const Callout: React__default.FC<CalloutProps>;
  * />
  * ```
  */
-interface CheckboxProps extends BaseProps {
+interface CheckboxProps extends ScalableProps {
     /** Label ou conteúdo a ser exibido ao lado do checkbox */
     label?: React__default.ReactNode;
     /** Callback executado quando o estado muda: (checked) => void */
@@ -325,10 +349,6 @@ interface CheckboxProps extends BaseProps {
     checked?: boolean;
     /** Estado indeterminado (usado em selecionar todos com seleção parcial) */
     indeterminate?: boolean;
-    /** Classe CSS opcional */
-    className?: string;
-    /** Escala visual aplicada ao componente */
-    scale?: Scale;
 }
 
 declare const Checkbox: React$1.FC<CheckboxProps>;
@@ -351,7 +371,7 @@ declare const Checkbox: React$1.FC<CheckboxProps>;
  * </Chips>
  * ```
  */
-interface ChipsProps extends BaseProps, Omit<React$1.HTMLAttributes<HTMLDivElement>, 'color'> {
+interface ChipsProps extends ScalableProps, Omit<React$1.HTMLAttributes<HTMLDivElement>, 'color'> {
     /** Variante semântica do chip. Define o preset de cor de fundo. */
     variant?: Exclude<TextVariant, 'color'>;
     /** Token CSS para a cor de fundo. Ex: 'color-brand-secondary-medium'. Sobrescreve o variant. */
@@ -364,12 +384,6 @@ interface ChipsProps extends BaseProps, Omit<React$1.HTMLAttributes<HTMLDivEleme
     leftIcon?: React$1.ReactNode;
     /** Ícone posicionado à direita do texto */
     rightIcon?: React$1.ReactNode;
-    /** Estilos inline adicionais */
-    style?: React$1.CSSProperties;
-    /** Classe CSS opcional */
-    className?: string;
-    /** Escala visual aplicada ao componente */
-    scale?: Scale;
 }
 
 declare const MemoizedChips: React__default.NamedExoticComponent<ChipsProps>;
@@ -416,7 +430,7 @@ declare function Container({ children, className }: ContainerProps): react_jsx_r
  * />
  * ```
  */
-interface DatePickerProps extends BaseProps {
+interface DatePickerProps extends ScalableProps {
     /** Idioma para formatação da data */
     locale?: Locale;
     /** Posição do calendário em relação ao campo */
@@ -443,12 +457,6 @@ interface DatePickerProps extends BaseProps {
     maxDate?: Date;
     /** ID para testes automatizados */
     '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>;
@@ -745,7 +753,7 @@ interface MenuItemProps {
  * />
  * ```
  */
-interface MenuProps extends BaseProps {
+interface MenuProps extends ScalableProps {
     /** Array de itens do menu */
     items: MenuItemProps[];
     /** Elemento trigger customizado para abrir o menu */
@@ -778,12 +786,6 @@ interface MenuProps extends BaseProps {
     onApiSearch?: (searchTerm: string) => void;
     /** Callback executado quando o menu abre/fecha: (open) => void */
     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>;
@@ -893,7 +895,7 @@ declare const Popover: React$1.FC<PopoverProps>;
  * />
  * ```
  */
-interface QuantityProps extends BaseProps {
+interface QuantityProps extends ScalableProps, Omit<React$1.HTMLAttributes<HTMLDivElement>, 'size' | 'onChange'> {
     /** Valor do componente */
     value?: number;
     /** Callback executado quando o valor muda: (value) => void */
@@ -923,10 +925,6 @@ interface QuantityProps extends BaseProps {
     incrementAriaLabel?: string;
     /** Aria label para a entrada de quantidade. Padrão: 'Quantidade' */
     inputAriaLabel?: string;
-    /** Classe CSS opcional */
-    className?: string;
-    /** Escala visual aplicada ao componente */
-    scale?: Scale;
 }
 
 declare const memorizedQuantity: React__default.NamedExoticComponent<QuantityProps>;
@@ -970,7 +968,7 @@ interface RadioProps {
  * />
  * ```
  */
-interface RadioGroupProps extends BaseProps {
+interface RadioGroupProps extends ScalableProps, Omit<React$1.HTMLAttributes<HTMLDivElement>, 'defaultValue' | 'dir'> {
     /** Array de itens de rádio */
     items: RadioProps[];
     /** Callback executado quando o valor muda: (value) => void */
@@ -983,8 +981,6 @@ 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>;
@@ -1078,7 +1074,7 @@ interface VirtualKeyboardProps extends Omit<BaseProps, 'disabled'> {
  * ```
  */
 type NativeInputProps = Omit<ComponentPropsWithoutRef<'input'>, 'value' | 'defaultValue' | 'onChange' | 'onClick' | 'onMouseDown'>;
-interface SearchProps extends BaseProps, NativeInputProps {
+interface SearchProps extends ScalableProps, NativeInputProps {
     /** Placeholder do campo de busca */
     placeholder?: string;
     /** Valor controlado do campo */
@@ -1111,16 +1107,8 @@ interface SearchProps extends BaseProps, NativeInputProps {
     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;
+    /** Tipo do teclado virtual (padrão: undefined = desabilitado) */
+    virtualKeyboard?: VirtualKeyboardType;
 }
 
 declare const Search: React__default.ForwardRefExoticComponent<SearchProps & React__default.RefAttributes<HTMLInputElement>>;
@@ -1128,7 +1116,7 @@ declare const Search: React__default.ForwardRefExoticComponent<SearchProps & Rea
 /**
  * Representa um item do select
  */
-interface SelectItemProps extends BaseProps {
+interface SelectItemProps extends ScalableProps {
     /** Texto principal do item */
     text: ReactNode;
     /** Subtítulo ou descrição do item */
@@ -1171,7 +1159,7 @@ type SelectVariant = 'text' | 'icon' | 'checkbox';
  * />
  * ```
  */
-interface SelectProps extends BaseProps {
+interface SelectProps extends ScalableProps {
     /** Array de itens do select */
     items: SelectItemProps[];
     /** Callback executado quando o valor muda: (value) => void */
@@ -1222,10 +1210,6 @@ interface SelectProps extends BaseProps {
     onApiSearch?: (term: string) => void;
     /** Estado de busca em andamento */
     isSearching?: boolean;
-    /** Classe CSS opcional */
-    className?: string;
-    /** Escala visual aplicada ao componente */
-    scale?: Scale;
 }
 
 declare const Select: React__default.FC<SelectProps>;
@@ -1461,11 +1445,7 @@ interface TableV2HeaderProps {
     /** 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;
+    virtualKeyboard?: VirtualKeyboardType;
     /** Modo de busca: 'instant' chama onSearchChange a cada tecla; 'on-enter' chama apenas ao pressionar Enter (padrão) */
     searchMode?: 'instant' | 'on-enter';
     /**
@@ -1672,12 +1652,8 @@ 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;
+    /** Tipo do teclado virtual (padrão: undefined = desabilitado) */
+    virtualKeyboard?: VirtualKeyboardType;
 }
 
 declare const _default$1: React__default.NamedExoticComponent<TextAreaProps & React__default.RefAttributes<HTMLTextAreaElement>>;
@@ -1710,7 +1686,7 @@ type TextFieldType = 'text' | 'email' | 'password' | 'number' | 'tel' | 'url';
  * />
  * ```
  */
-interface TextFieldProps extends Omit<React__default.InputHTMLAttributes<HTMLInputElement>, 'onChange' | 'value' | 'type'> {
+interface TextFieldProps 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 */
@@ -1726,9 +1702,9 @@ interface TextFieldProps extends Omit<React__default.InputHTMLAttributes<HTMLInp
     /** Texto do tooltip */
     tooltipText?: string;
     /** Lado onde o tooltip aparece */
-    side?: Side;
+    tooltipSide?: Side;
     /** Alinhamento do tooltip */
-    align?: Align;
+    tooltipAlign?: Align;
     /**
      * Mensagem de erro exibida no campo.
      * Usada tanto pela validação interna (required, formato, etc.)
@@ -1741,18 +1717,12 @@ interface TextFieldProps extends Omit<React__default.InputHTMLAttributes<HTMLInp
     icon?: React__default.ReactNode;
     /** Mantém o ícone visível mesmo quando o campo tem valor */
     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 */
+    /** Tipo do teclado virtual (padrão: undefined = desabilitado) */
+    virtualKeyboard?: VirtualKeyboardType;
+    /** Aplica variação visual para uso acoplado ao VirtualKeyboard no modo fixed, essa prop é de uso exclusivo do VirtualKeyboard no modo fixed */
     attachedToVirtualKeyboard?: boolean;
-    /** Escala visual aplicada ao componente */
-    scale?: Scale;
+    /** Desabilita o autocomplete nativo do browser (padrão: false) */
+    disableAutoComplete?: boolean;
 }
 
 declare const _default: React__default.NamedExoticComponent<TextFieldProps & React__default.RefAttributes<HTMLInputElement>>;
@@ -1978,7 +1948,7 @@ declare const Tooltip: React__default.FC<TooltipProps>;
  * />
  * ```
  */
-interface SwitchProps extends BaseProps {
+interface SwitchProps extends ScalableProps {
     /** Estado inicial (modo não controlado) */
     defaultChecked?: boolean;
     /** Callback executado quando o estado muda: (checked) => void */
@@ -1989,10 +1959,6 @@ interface SwitchProps extends BaseProps {
     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>;
@@ -2177,5 +2143,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, 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 };
+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 };