@giro-ds/react 6.0.1 → 7.0.0

package/dist/index.d.ts

@@ -2,18 +2,30 @@ import * as React$1 from 'react';
 import React__default, { ReactNode, ReactElement, 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';
 import { Toast as Toast$1 } from 'radix-ui';
 
+/** Tamanho do componente: 'sm' (pequeno) ou 'lg' (grande) */
 type Size = 'sm' | 'lg';
+/** Variante visual do componente: 'filled' (preenchido), 'outlined' (contorno) ou 'text' (apenas texto) */
 type Variant = 'filled' | 'outlined' | 'text';
+/** Variante de cor do texto: 'neutral' (neutro), 'brand' (marca), 'color' (colorido), 'success' (sucesso) ou 'alert' (alerta) */
 type TextVariant = 'neutral' | 'brand' | 'color' | 'success' | 'alert';
+/** Lado de posicionamento: 'top' (topo), 'right' (direita), 'bottom' (base) ou 'left' (esquerda) */
 type Side = 'top' | 'right' | 'bottom' | 'left';
+/** Alinhamento do componente: 'start' (início), 'center' (centro) ou 'end' (fim) */
 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';
+/** 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 */
 interface BaseProps {
+    /** Identificador único do elemento HTML */
     id?: string;
+    /** Classes CSS adicionais a serem aplicadas ao componente */
     className?: string;
+    /** Quando `true`, desabilita interações com o componente */
     disabled?: boolean;
 }
 
@@ -28,7 +40,7 @@ interface BaseProps {
  * <Avatar src="https://example.com/avatar.jpg" icon={<UserIcon />} size="sm" />
  * ```
  */
-interface AvatarProps extends BaseProps {
+interface AvatarProps extends Omit<BaseProps, 'disabled'> {
     /** Ícone ou conteúdo a ser exibido no fallback quando não há imagem ou ela falha ao carregar */
     icon?: React$1.ReactNode;
     /** Tamanho do avatar: 'sm' (32px) ou 'lg' (44px). @default 'lg' */
@@ -37,44 +49,38 @@ interface AvatarProps extends BaseProps {
     src?: string;
     /** Texto alternativo da imagem do avatar, usado como as iniciais do nome */
     initialLetters?: string;
+    /** Classe CSS opcional */
+    className?: string;
 }
 
 declare const Avatar: React__default.FC<AvatarProps>;
 
-/** Tipos de badge suportados */
-type BadgeType = 'notification' | 'status';
-/** Valores possíveis para exibição no badge */
-type BadgeValue = number | string | null;
 /**
  * Props do componente Badge
  * @example
  * ```tsx
- * <Badge type="notification" badgeValue={5}>
+ * // Modo overlay: badge flutua sobre o children
+ * <Badge badgeValue={5}>
  *   <IconButton icon={<BellIcon />} />
  * </Badge>
  * ```
  * @example
  * ```tsx
- * <Badge
- *   type="status"
- *   badgeValue="novo"
- *   aria-label="Novo item disponível"
- * >
- *   <Avatar icon={<UserIcon />} />
- * </Badge>
+ * // Modo inline: badge standalone ao lado de outros elementos
+ * <Badge badgeValue="+3" aria-label="3 novos itens" />
  * ```
  */
 interface BadgeProps extends BaseProps {
-    /** Tipo de badge (notificação ou status) */
-    type: BadgeType;
-    /** Conteúdo a ser envolvido pelo badge */
+    /** Conteúdo a ser envolvido pelo badge. Quando presente, o badge é posicionado sobre o children (modo overlay). */
     children?: ReactNode;
-    /** Valor a ser exibido no badge (número, texto ou null) */
-    badgeValue?: BadgeValue;
-    /** Valor máximo a ser exibido (ex: 99+ quando badgeValue > maxValue) */
-    maxValue?: number;
+    /** Valor exibido no badge — aceita número ou string formatada (ex: "+3") */
+    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 */
+    filterVariant?: boolean;
+    /** Classe CSS opcional */
+    className?: string;
 }
 
 declare const Badge: React__default.FC<BadgeProps>;
@@ -119,6 +125,10 @@ type ButtonOwnPropsBase = {
     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>;
 } & BaseProps;
@@ -210,7 +220,7 @@ interface CalendarBaseProps extends Omit<BaseProps, 'disabled'> {
      */
     format?: DateFormat;
     /**
-     * Locale da interface — aceita os códigos internos do design system.
+     * Idioma da interface — aceita os códigos internos do design system.
      * @default 'pt-br'
      */
     locale?: Locale;
@@ -223,14 +233,14 @@ interface CalendarBaseProps extends Omit<BaseProps, 'disabled'> {
 }
 type CalendarProps = CalendarBaseProps;
 
-declare const Calendar: ({ selected, currentDate, defaultMonth, startMonth, endMonth, onDaySelect, onDateChange, onClear: _onClear, minDate, maxDate, disabled, format: _format, locale, autoFocus, id, "aria-label": ariaLabel, }: 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, id, "aria-label": ariaLabel, ...rest }: CalendarProps) => react_jsx_runtime.JSX.Element;
 
 /**
  * Props do componente Callout
  * @example
  * ```tsx
  * <Callout
- *   type="success"
+ *   variant="success"
  *   title="Sucesso!"
  *   text="Operação realizada com sucesso"
  *   icon={<CheckIcon />}
@@ -239,21 +249,39 @@ declare const Calendar: ({ selected, currentDate, defaultMonth, startMonth, endM
  * @example
  * ```tsx
  * <Callout
- *   type="alert"
+ *   variant="alert"
  *   title="Atenção"
  *   text="Verifique os campos obrigatórios"
+ *   dismiss
+ *   onDismiss={() => setVisible(false)}
  * />
  * ```
  */
-interface CalloutProps extends BaseProps {
-    /** Tipo visual do callout */
-    type?: TextVariant;
-    /** Título principal do callout (texto em destaque) */
-    title?: string | null;
-    /** Texto descritivo do callout */
-    text?: string;
+interface CalloutProps extends Omit<BaseProps, 'disabled'>, Omit<React$1.HTMLAttributes<HTMLDivElement>, 'title'> {
+    /** Variante semântica do callout */
+    variant?: Exclude<TextVariant, 'color'>;
+    /** Título principal do callout */
+    title?: React$1.ReactNode;
+    /** Conteúdo descritivo do callout */
+    text: React$1.ReactNode;
     /** Ícone a ser exibido no callout */
     icon?: React$1.ReactNode;
+    /** Callback chamado ao clicar no botão de fechar. */
+    onDismiss?: () => void;
+    /** Exibe o botão de fechar. Requer onDismiss. */
+    dismiss?: boolean;
+    /**
+     * Nome do token de cor de fundo (sem `--`). Sobrescreve a cor da variante.
+     * @example backgroundColor="color-brand-secondary-medium"
+     */
+    backgroundColor?: string;
+    /**
+     * Nome do token de cor do texto e ícone (sem `--`). Sobrescreve a cor padrão.
+     * @example textColor="color-neutral-low-default"
+     */
+    textColor?: string;
+    /** Classe CSS opcional */
+    className?: string;
     /** Props adicionais para o elemento div */
     [key: string]: any;
 }
@@ -291,6 +319,8 @@ interface CheckboxProps extends BaseProps {
     checked?: boolean;
     /** Estado indeterminado (usado em selecionar todos com seleção parcial) */
     indeterminate?: boolean;
+    /** Classe CSS opcional */
+    className?: string;
 }
 
 declare const Checkbox: React$1.FC<CheckboxProps>;
@@ -328,6 +358,8 @@ interface ChipsProps extends BaseProps, Omit<React$1.HTMLAttributes<HTMLDivEleme
     rightIcon?: React$1.ReactNode;
     /** Estilos inline adicionais */
     style?: React$1.CSSProperties;
+    /** Classe CSS opcional */
+    className?: string;
 }
 
 declare const MemoizedChips: React__default.NamedExoticComponent<ChipsProps>;
@@ -345,9 +377,11 @@ declare const MemoizedChips: React__default.NamedExoticComponent<ChipsProps>;
 interface ContainerProps {
     /** Conteúdo a ser renderizado dentro do container */
     children: React__default.ReactNode;
+    /** Classe CSS customizada aplicada ao elemento raiz do container */
+    className?: string;
 }
 
-declare function Container({ children }: ContainerProps): react_jsx_runtime.JSX.Element;
+declare function Container({ children, className }: ContainerProps): react_jsx_runtime.JSX.Element;
 
 /**
  * Props do componente DatePicker
@@ -373,7 +407,7 @@ declare function Container({ children }: ContainerProps): react_jsx_runtime.JSX.
  * ```
  */
 interface DatePickerProps extends BaseProps {
-    /** Locale para formatação da data */
+    /** Idioma para formatação da data */
     locale?: Locale;
     /** Posição do calendário em relação ao campo */
     calendarSide?: Side;
@@ -399,6 +433,8 @@ interface DatePickerProps extends BaseProps {
     maxDate?: Date;
     /** ID para testes automatizados */
     'data-testid'?: string;
+    /** Classe CSS opcional */
+    className?: string;
 }
 
 declare const _default$2: React__default.NamedExoticComponent<DatePickerProps>;
@@ -414,10 +450,11 @@ declare const _default$2: React__default.NamedExoticComponent<DatePickerProps>;
  * />
  */
 interface DialogProps extends BaseProps, React.HTMLAttributes<HTMLDivElement> {
+    /** Controla a visibilidade do Dialog */
     show?: boolean;
-    /** Título exibido no cabeçalho do diálogo */
+    /** Título exibido no cabeçalho do Dialog */
     title?: string;
-    /** Texto ou conteúdo do corpo do diálogo */
+    /** Texto ou conteúdo do corpo do Dialog */
     bodyContent?: ReactNode;
     /** Texto do botão de ação primária */
     textPrimaryAction?: string;
@@ -427,6 +464,8 @@ interface DialogProps extends BaseProps, React.HTMLAttributes<HTMLDivElement> {
     onPrimaryAction?: () => void;
     /** Função chamada ao executar a ação secundária */
     onSecondaryAction?: () => void;
+    /** Classe CSS opcional */
+    className?: string;
 }
 
 declare const Dialog: React$1.FC<DialogProps>;
@@ -481,11 +520,13 @@ interface DrawerProps extends BaseProps {
     closeOnOverlayClick?: boolean;
     /** Define se o drawer fecha ao pressionar ESC */
     closeOnEscape?: boolean;
+    /** Classe CSS opcional */
+    className?: string;
 }
 
 declare const Drawer: React__default.FC<DrawerProps>;
 
-interface FilterItem$1 {
+interface FilterItem$2 {
     id?: string;
     text: string;
     subText?: string;
@@ -519,7 +560,7 @@ type FilterType = 'text' | 'checkbox' | 'icon' | 'calendar';
  */
 interface FilterProps extends BaseProps {
     /** Array de itens para filtros do tipo dropdown */
-    items?: FilterItem$1[];
+    items?: FilterItem$2[];
     /** Tipo do filtro (dropdown ou calendário) */
     type?: FilterType;
     /** IDs dos itens selecionados */
@@ -554,8 +595,10 @@ interface FilterProps extends BaseProps {
     minDate?: Date;
     /** Data máxima selecionável (para tipo calendar) */
     maxDate?: Date;
-    /** Locale do calendário */
+    /** Idioma do calendário */
     locale?: Locale;
+    /** Classe CSS opcional */
+    className?: string;
 }
 
 declare const Filter: React__default.FC<FilterProps>;
@@ -609,6 +652,8 @@ interface ListItemProps extends BaseProps {
     showSubText?: boolean;
     /** Estado de hover */
     hovered?: boolean;
+    /** Classe CSS opcional */
+    className?: string;
 }
 
 declare const ListItem: React__default.FC<ListItemProps>;
@@ -688,6 +733,8 @@ 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;
 }
 
 declare const Menu: React__default.FC<MenuProps>;
@@ -735,6 +782,8 @@ interface ModalProps extends BaseProps {
     customWidth?: string;
     /** Define se o modal ocupa toda a tela. Tem prioridade sobre customWidth */
     fullscreen?: boolean;
+    /** Classe CSS opcional */
+    className?: string;
 }
 
 declare const Modal: React$1.FC<ModalProps>;
@@ -764,6 +813,8 @@ interface PopoverProps {
     onCloseAutoFocus?: (event: Event) => void;
     /** Quando `true`, exibe uma seta apontando para o trigger */
     showArrow?: boolean;
+    /** Classe CSS opcional */
+    className?: string;
 }
 
 declare const Popover: React$1.FC<PopoverProps>;
@@ -813,12 +864,14 @@ interface QuantityProps extends BaseProps {
     minValue?: number;
     /** Valor máximo permitido */
     maxValue?: number;
-    /** Aria label for the decrement button. Default: 'Decrease quantity' */
+    /** Aria label para o botão de decremento. Padrão: 'Diminuir quantidade' */
     decrementAriaLabel?: string;
-    /** Aria label for the increment button. Default: 'Increase quantity' */
+    /** Aria label para o botão de incremento. Padrão: 'Aumentar quantidade' */
     incrementAriaLabel?: string;
-    /** Aria label for the quantity input. Default: 'Quantity' */
+    /** Aria label para a entrada de quantidade. Padrão: 'Quantidade' */
     inputAriaLabel?: string;
+    /** Classe CSS opcional */
+    className?: string;
 }
 
 declare const memorizedQuantity: React__default.NamedExoticComponent<QuantityProps>;
@@ -835,6 +888,8 @@ interface RadioProps {
     label: string;
     /** Estado desabilitado do item */
     disabled?: boolean;
+    /** Classe CSS opcional */
+    className?: string;
 }
 /**
  * Props do componente RadioGroup
@@ -920,6 +975,8 @@ interface SearchProps extends BaseProps, NativeInputProps {
     onMouseDown?: (e: React$1.MouseEvent<HTMLDivElement>) => void;
     /** ID para testes automatizados */
     'data-testid'?: string;
+    /** Classe CSS opcional */
+    className?: string;
 }
 
 declare const Search: React__default.ForwardRefExoticComponent<SearchProps & React__default.RefAttributes<HTMLInputElement>>;
@@ -1021,6 +1078,8 @@ interface SelectProps extends BaseProps {
     onApiSearch?: (term: string) => void;
     /** Estado de busca em andamento */
     isSearching?: boolean;
+    /** Classe CSS opcional */
+    className?: string;
 }
 
 declare const Select: React__default.FC<SelectProps>;
@@ -1096,7 +1155,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;
 
-interface BaseFilterItem {
+interface BaseFilterItem$1 {
     id?: string;
     buttonText: string | React__default.ReactNode;
     icon?: React__default.ReactElement;
@@ -1106,15 +1165,15 @@ interface BaseFilterItem {
     onToggle?: (isOpen: boolean) => void;
     tooltip?: string;
 }
-interface CheckboxFilterItem extends BaseFilterItem {
+interface CheckboxFilterItem$1 extends BaseFilterItem$1 {
     type: 'checkbox' | 'text' | 'icon';
-    items: FilterItem$1[];
+    items: FilterItem$2[];
     selectedIds?: string[];
     onSelectionChange?: (selectedIds: string[]) => void;
     placeholder?: string;
     enableSearch?: boolean;
 }
-interface CalendarFilterItem extends BaseFilterItem {
+interface CalendarFilterItem$1 extends BaseFilterItem$1 {
     type: 'calendar';
     selectedDate?: Date | null;
     onDateSelect?: (date: Date) => void;
@@ -1124,7 +1183,7 @@ interface CalendarFilterItem extends BaseFilterItem {
     locale?: string;
     placeholder?: string;
 }
-type FilterItem = CheckboxFilterItem | CalendarFilterItem;
+type FilterItem$1 = CheckboxFilterItem$1 | CalendarFilterItem$1;
 interface TableHeaderProps extends React__default.HTMLAttributes<HTMLDivElement> {
     searchValue?: string;
     onSearchChange?: (value: string) => void;
@@ -1132,7 +1191,7 @@ interface TableHeaderProps extends React__default.HTMLAttributes<HTMLDivElement>
     showSearch?: boolean;
     showFilters?: boolean;
     filters?: React__default.ReactNode;
-    filterItems?: FilterItem[];
+    filterItems?: FilterItem$1[];
     className?: string;
     onSearch?: (value: string) => void;
     showClearSearch?: boolean;
@@ -1151,6 +1210,188 @@ interface TablePaginationProps extends React__default.HTMLAttributes<HTMLDivElem
 }
 declare const TablePagination: React__default.FC<TablePaginationProps>;
 
+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 */
+        maxHeight?: number | string;
+    }
+}
+/**
+ * Props base compartilhadas por todos os tipos de filtro da tabela.
+ */
+interface BaseFilterItem {
+    /** Identificador único do filtro */
+    id?: string;
+    /** Texto ou nó exibido no botão que abre o filtro */
+    buttonText: string | ReactNode;
+    /** Ícone exibido no botão do filtro */
+    icon?: ReactElement;
+    /** Lado em que o dropdown do filtro será exibido */
+    side?: Side;
+    /** Alinhamento do dropdown do filtro */
+    align?: Exclude<Align, 'center'>;
+    /** Desabilita o botão do filtro */
+    disabled?: boolean;
+    /** Callback chamado quando o estado de abertura do filtro muda */
+    onToggle?: (isOpen: boolean) => void;
+}
+/**
+ * Props de filtro do tipo checkbox, texto ou ícone.
+ * Renderiza uma lista de opções selecionáveis.
+ */
+interface CheckboxFilterItem extends BaseFilterItem {
+    /** Tipo do filtro */
+    type: 'checkbox' | 'text' | 'icon';
+    /** Lista de itens disponíveis para seleção */
+    items: FilterItem$2[];
+    /** IDs dos itens atualmente selecionados */
+    selectedIds?: string[];
+    /** Callback chamado quando a seleção muda */
+    onSelectionChange?: (selectedIds: string[]) => void;
+    /** Placeholder do campo de busca interno do filtro */
+    placeholder?: string;
+    /** Habilita campo de busca dentro do dropdown */
+    enableSearch?: boolean;
+}
+/**
+ * Props de filtro do tipo calendário.
+ * Renderiza um seletor de data.
+ */
+interface CalendarFilterItem extends BaseFilterItem {
+    /** Tipo do filtro */
+    type: 'calendar';
+    /** Data atualmente selecionada */
+    selectedDate?: Date | null;
+    /** Callback chamado quando uma data é selecionada */
+    onDateSelect?: (date: Date) => void;
+    /** Callback chamado ao limpar a data selecionada */
+    onClear?: () => void;
+    /** Data mínima permitida para seleção */
+    minDate?: Date;
+    /** Data máxima permitida para seleção */
+    maxDate?: Date;
+    /** Locale utilizado para formatar datas no calendário */
+    locale?: Locale;
+    /** Placeholder exibido quando nenhuma data está selecionada */
+    placeholder?: string;
+}
+/**
+ * Union type representando um item de filtro da tabela.
+ * Pode ser do tipo checkbox/texto/ícone ou calendário.
+ */
+type FilterItem = CheckboxFilterItem | CalendarFilterItem;
+/**
+ * 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[];
+}
+/**
+ * Props do rodapé do TableV2, com controles de paginação.
+ */
+interface TableV2FooterProps {
+    /** Total de itens (para calcular número de páginas) */
+    totalItems: number;
+    /** Itens por página inicial (padrão: 10) */
+    defaultPageSize?: number;
+    /** Opções do seletor de itens por página */
+    pageSizeOptions?: number[];
+    /** Callback chamado quando a página muda */
+    onPageChange?: (page: number) => void;
+    /** Callback chamado quando o tamanho da página muda */
+    onPageSizeChange?: (pageSize: number) => void;
+}
+/**
+ * Props para personalização do estado vazio da tabela.
+ */
+interface EmptyStateProps {
+    /** Ícone exibido no estado vazio */
+    emptyIcon?: ReactNode;
+    /** Título exibido no estado vazio */
+    emptyTitle?: ReactNode;
+    /** Texto descritivo exibido no estado vazio */
+    emptyText?: ReactNode;
+}
+/**
+ * Definição de uma ação em massa disponível na barra de seleção.
+ */
+interface BulkAction {
+    /** Label do botão de ação */
+    label: ReactNode;
+    /** Callback ao clicar no botão */
+    onClick: () => void;
+    /** Desabilita o botão */
+    disabled?: boolean;
+    /** Variante visual do botão (padrão: 'outlined') */
+    variant?: 'filled' | 'outlined' | 'text';
+}
+/**
+ * Props da barra de ações em massa do TableV2.
+ * Exibida quando há linhas selecionadas.
+ */
+interface TableV2BulkActionsProps<T = Record<string, unknown>> {
+    /** Função que retorna o label da barra de ações em massa.
+     * Recebe a contagem de itens selecionados e os itens originais.
+     * Se não fornecido, exibe "{count} itens selecionados". */
+    label?: (count: number, selectedRows: T[]) => ReactNode;
+    /** Lista de ações disponíveis quando há itens selecionados */
+    actions: BulkAction[];
+    /** Callback chamado ao clicar no botão de limpar seleção (X) */
+    onClear?: () => void;
+}
+/**
+ * Props do componente TableV2.
+ * @example
+ * ```tsx
+ * <TableV2
+ *   columns={columns}
+ *   data={data}
+ *   enableSorting
+ *   enableRowSelection
+ *   loading={isLoading}
+ * />
+ * ```
+ */
+interface TableV2Props<T = Record<string, unknown>> extends EmptyStateProps {
+    /** Definições das colunas da tabela */
+    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;
+    /** 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 */
+    header?: TableV2HeaderProps;
+    /** Footer com paginação */
+    footer?: TableV2FooterProps;
+    /** Classe CSS personalizada para o componente */
+    className?: string;
+    /** Estado de carregamento — exibe skeleton animado no lugar da tabela */
+    loading?: boolean;
+    /** Eventos e classe aplicados por linha */
+    onRow?: (row: T, index: number) => {
+        onClick?: () => void;
+        onDoubleClick?: () => void;
+        className?: string;
+    };
+}
+
+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;
+
 /**
  * Props do componente TextArea
  * @example
@@ -1203,7 +1444,10 @@ interface TextAreaProps extends Omit<React__default.TextareaHTMLAttributes<HTMLT
     resize?: 'none' | 'vertical' | 'both';
     /** Exibe contador de caracteres (requer maxLength) */
     showCharCount?: boolean;
+    /** Altura do textarea em pixels */
     height?: number;
+    /** Classe CSS opcional */
+    className?: string;
 }
 
 declare const _default$1: React__default.NamedExoticComponent<TextAreaProps & React__default.RefAttributes<HTMLTextAreaElement>>;
@@ -1267,6 +1511,8 @@ 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;
 }
 
 declare const _default: React__default.NamedExoticComponent<TextFieldProps & React__default.RefAttributes<HTMLInputElement>>;
@@ -1324,6 +1570,8 @@ interface ToastProps extends BaseProps, Omit<React$1.ComponentPropsWithoutRef<ty
      * @default 'Info'
      */
     iconType?: 'Info' | 'Success' | 'Alert';
+    /** Classe CSS opcional */
+    className?: string;
 }
 
 /**
@@ -1451,9 +1699,13 @@ declare const useToast: () => {
 };
 
 interface TooltipProps extends BaseProps {
+    /** Conteúdo textual exibido dentro do tooltip */
     text: React__default.ReactNode;
+    /** Lado em que o tooltip aparece em relação ao elemento filho. @default 'top' */
     side?: Side;
+    /** Alinhamento do tooltip em relação ao elemento filho. @default 'center' */
     align?: Align;
+    /** Deslocamento em pixels no eixo lateral (side) entre o tooltip e o elemento filho */
     sideOffset?: number;
     /** Deslocamento em pixels no eixo de alinhamento */
     alignOffset?: number;
@@ -1461,6 +1713,8 @@ interface TooltipProps extends BaseProps {
     maxWidth?: number;
     /** Elemento que dispara o tooltip ao hover */
     children: React__default.ReactNode;
+    /** Classe CSS opcional */
+    className?: string;
 }
 
 declare const Tooltip: React__default.FC<TooltipProps>;
@@ -1495,6 +1749,8 @@ interface SwitchProps extends BaseProps {
     value?: string;
     /** Estado atual (modo controlado) */
     checked?: boolean;
+    /** Classe CSS opcional */
+    className?: string;
 }
 
 declare const Switch: React$1.FC<SwitchProps>;
@@ -1652,5 +1908,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, _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, FilterProps, ListItemProps, MenuProps, ModalProps, PopoverProps, QuantityProps, RadioGroupProps, RadioProps, SearchProps, SelectProps, SwitchProps, TableHeaderProps, TablePaginationProps, TableProps, 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, 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 };