@giro-ds/react 12.0.0 → 12.1.1

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import * as React$1 from 'react';
-import React__default, { ReactNode, ReactElement, RefObject, ComponentPropsWithoutRef, CSSProperties } from 'react';
+import React__default, { ReactNode, ReactElement, RefObject, ComponentPropsWithoutRef } from 'react';
 import { DateRange, Matcher } from 'react-day-picker';
 export { DateRange } from 'react-day-picker';
 import { RowData, ColumnDef } from '@tanstack/react-table';
@@ -97,7 +97,7 @@ declare const Badge: React__default.FC<BadgeProps>;
 /**
  * Props base compartilhadas por todas as configurações de tooltip do botão.
  */
-interface BaseTooltipConfig$3 {
+interface BaseTooltipConfig$4 {
     /** Lado em que o tooltip será exibido */
     tooltipSide?: 'top' | 'bottom' | 'left' | 'right';
     /** Alinhamento do tooltip */
@@ -107,14 +107,14 @@ interface BaseTooltipConfig$3 {
  * 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 {
+interface WithTooltip$4 extends BaseTooltipConfig$4 {
     /** Texto do tooltip exibido no hover */
     tooltipText: string;
 }
 /**
  * Configuração sem tooltip.
  */
-interface WithoutTooltip$3 {
+interface WithoutTooltip$4 {
     tooltipText?: never;
     tooltipSide?: never;
     tooltipAlign?: never;
@@ -123,7 +123,7 @@ interface WithoutTooltip$3 {
  * 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;
+type ButtonTooltipConfig = WithTooltip$4 | WithoutTooltip$4;
 /**
  * Props base do Button, independentes da variante iconOnly/icon.
  * `target`, `rel`, `type` e `onClick` são declarados aqui para garantir
@@ -211,12 +211,7 @@ type ButtonAsCustom = ButtonOwnProps & Omit<React__default.HTMLAttributes<HTMLEl
  */
 type ButtonProps = ButtonAsButton | ButtonAsAnchor | ButtonAsCustom;
 
-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;
-};
+declare const Button: React__default.ForwardRefExoticComponent<ButtonProps & React__default.RefAttributes<HTMLButtonElement | HTMLAnchorElement>>;
 
 /** Formato de exibição da data aceito pelo componente. */
 type DateFormat = 'dd/mm/yyyy' | 'mm/dd/yyyy' | (string & {});
@@ -626,14 +621,9 @@ interface FileUploadProps extends Omit<React__default.InputHTMLAttributes<HTMLIn
     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;
-};
+declare const FileUpload: React__default.ForwardRefExoticComponent<FileUploadProps & React__default.RefAttributes<HTMLInputElement>>;
 
-interface FilterItem$2 {
+interface FilterItem$1 {
     /** Identificador único do item (usado em `selectedIds` e `onApplyFilter`) */
     id?: BaseProps['id'];
     /** Texto principal exibido no item */
@@ -672,7 +662,7 @@ type FilterTypes = 'single' | 'multiple' | 'calendar';
  */
 interface FilterProps extends BaseProps {
     /** Array de itens para filtros do tipo dropdown */
-    items?: FilterItem$2[];
+    items?: FilterItem$1[];
     /** Tipo do filtro (dropdown ou calendário) */
     type?: FilterTypes;
     /** IDs dos itens selecionados */
@@ -736,7 +726,7 @@ interface FilterProps extends BaseProps {
 declare const Filter: React__default.FC<FilterProps>;
 
 /** Variantes disponíveis para o ListItem */
-type ListItemVariant = 'text' | 'checkbox' | 'radio' | 'icon';
+type ListItemVariant = 'text' | 'checkbox' | 'icon';
 /**
  * Props do componente ListItem
  * @example
@@ -764,11 +754,9 @@ interface ListItemProps extends BaseProps {
     variant?: ListItemVariant;
     /** Texto principal do item */
     text?: string;
-    /** Nome do input (para variantes checkbox/radio) */
-    name?: string;
     /** Texto secundário/descrição do item */
     subText?: string;
-    /** Estado de checked (para variantes checkbox/radio) */
+    /** Estado de checked (para variante checkbox) */
     checked?: boolean;
     /** Estado de selecionado (para variantes text/icon) */
     selected?: boolean;
@@ -778,14 +766,18 @@ interface ListItemProps extends BaseProps {
     onChange?: (checked: boolean) => void;
     /** Ícone do item (para variante icon) */
     icon?: React$1.ReactNode;
-    /** Valor do input (para variantes checkbox/radio) */
-    value?: string;
-    /** Controla a visibilidade do subtexto explicitamente, independentemente de `subText` estar preenchido */
-    showSubText?: boolean;
-    /** Força o estado visual de hover no item (útil para controle externo de foco/seleção) */
-    hovered?: boolean;
-    /** Classe CSS opcional */
-    className?: string;
+    /** Largura do item. Quando não informada, ocupa 100% do container */
+    customWidth?: React$1.CSSProperties['width'];
+    /** Escala visual do componente (1, 1.5 ou 2) */
+    scale?: Scale;
+    /** Itens filhos para criar estrutura de árvore (outros ListItems) */
+    children?: React$1.ReactNode;
+    /** Estado inicial de expansão — modo não controlado (default: false) */
+    defaultExpanded?: boolean;
+    /** Estado de expansão controlado */
+    expanded?: boolean;
+    /** Callback executado quando o estado de expansão muda */
+    onExpandedChange?: (expanded: boolean) => void;
 }
 
 declare const ListItem: React__default.FC<ListItemProps>;
@@ -1218,17 +1210,12 @@ interface SearchProps extends ScalableProps, NativeInputProps {
     virtualKeyboard?: VirtualKeyboardType;
 }
 
-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;
-};
+declare const Search: React__default.ForwardRefExoticComponent<SearchProps & React__default.RefAttributes<HTMLInputElement>>;
 
 /**
  * Props base compartilhadas por todas as configurações de tooltip do select.
  */
-interface BaseTooltipConfig$2 {
+interface BaseTooltipConfig$3 {
     /** Lado em que o tooltip será exibido */
     tooltipSide?: 'top' | 'bottom' | 'left' | 'right';
     /** Alinhamento do tooltip */
@@ -1238,14 +1225,14 @@ interface BaseTooltipConfig$2 {
  * Configuração de tooltip com texto.
  * Exibe um tooltip ao redor da label do select.
  */
-interface WithTooltip$2 extends BaseTooltipConfig$2 {
+interface WithTooltip$3 extends BaseTooltipConfig$3 {
     /** Texto do tooltip exibido no hover */
     tooltipText: string;
 }
 /**
  * Configuração sem tooltip.
  */
-interface WithoutTooltip$2 {
+interface WithoutTooltip$3 {
     tooltipText?: never;
     tooltipSide?: never;
     tooltipAlign?: never;
@@ -1254,7 +1241,7 @@ interface WithoutTooltip$2 {
  * 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;
+type SelectTooltipConfig = WithTooltip$3 | WithoutTooltip$3;
 /**
  * Representa um item do select
  */
@@ -1357,132 +1344,6 @@ type SelectProps = SelectPropsBase & SelectTooltipConfig;
 
 declare const Select: React__default.FC<SelectProps>;
 
-/**
- * Tipo base para dados da tabela. Use `<Table<SeuTipo>>` para type-safety completo.
- * @example <Table<User> dataSource={users} />
- */
-type TableRowData = Record<string, any>;
-/** Tipos de coluna suportados */
-type TableColumnType = 'text' | 'datetime' | 'custom';
-/** Opções de alinhamento de coluna */
-type TableAlign = 'left' | 'center' | 'right';
-/**
- * Configuração de coluna da tabela
- * @typeParam T - Tipo dos dados da linha
- */
-interface TableColumn<T = TableRowData> {
-    /** Chave única identificadora da coluna */
-    key: string;
-    /** Conteúdo do cabeçalho da coluna */
-    label: ReactNode;
-    /** Tipo de dados da coluna */
-    type?: TableColumnType;
-    /** Formato de exibição (ex: 'dd/MM/yyyy' para datetime) */
-    format?: string;
-    /** Função customizada para renderizar o conteúdo da célula */
-    render?: (row: T, index: number) => ReactNode;
-    /** Alinhamento do conteúdo */
-    align?: TableAlign;
-    /** Estilos CSS customizados */
-    style?: CSSProperties;
-}
-/**
- * Props do componente Table. Use genérico para autocomplete: `<Table<User>>`
- * @typeParam T - Tipo dos dados da linha
- */
-interface TableProps<T = TableRowData> extends BaseProps {
-    /** Configuração das colunas */
-    columns: TableColumn<T>[];
-    /** Array de dados a serem exibidos */
-    dataSource: T[];
-    /** Estado de carregamento */
-    loading?: boolean;
-    /** Configuração de seleção de linhas */
-    rowSelection?: {
-        /** Keys das linhas selecionadas (modo controlado) */
-        selectedRowKeys?: (string | number)[];
-        /** Callback quando seleção muda: (keys, rows) => void */
-        onChange?: (keys: (string | number)[], rows: T[]) => void;
-        /** Customiza props dos checkboxes: (row, index) => { disabled? } */
-        getCheckboxProps?: (row: T, index: number) => {
-            disabled?: boolean;
-        };
-        /** Desabilita o checkbox "selecionar todos" */
-        disableSelectAll?: boolean;
-    };
-    /** Configurações de localização */
-    locale?: {
-        /** Texto quando não há dados */
-        emptyText?: ReactNode;
-    };
-    /** Eventos de linha: (row, index) => { onClick?, onDoubleClick?, className? } */
-    onRow?: (row: T, index: number) => {
-        /** Clique simples na linha */
-        onClick?: () => void;
-        /** Clique duplo na linha */
-        onDoubleClick?: () => void;
-        /** Classe CSS da linha */
-        className?: string;
-    };
-}
-
-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;
-    buttonText: string | React__default.ReactNode;
-    icon?: React__default.ReactElement;
-    side?: Side;
-    align?: Exclude<Align, 'center'>;
-    disabled?: boolean;
-    onToggle?: (isOpen: boolean) => void;
-    tooltip?: string;
-}
-interface CheckboxFilterItem$1 extends BaseFilterItem$1 {
-    type: 'multiple' | 'single';
-    items: FilterItem$2[];
-    selectedIds?: string[];
-    onSelectionChange?: (selectedIds: string[]) => void;
-    placeholder?: string;
-    enableSearch?: boolean;
-}
-interface CalendarFilterItem$1 extends BaseFilterItem$1 {
-    type: 'calendar';
-    selectedDate?: Date | null;
-    onDateSelect?: (date: Date) => void;
-    onClear?: () => void;
-    minDate?: Date;
-    maxDate?: Date;
-    locale?: string;
-    placeholder?: string;
-}
-type FilterItem$1 = CheckboxFilterItem$1 | CalendarFilterItem$1;
-interface TableHeaderProps extends React__default.HTMLAttributes<HTMLDivElement> {
-    searchValue?: string;
-    onSearchChange?: (value: string) => void;
-    searchPlaceholder?: string;
-    showSearch?: boolean;
-    showFilters?: boolean;
-    filters?: React__default.ReactNode;
-    filterItems?: FilterItem$1[];
-    className?: string;
-    onSearch?: (value: string) => void;
-    showClearSearch?: boolean;
-}
-declare const TableHeader: React__default.FC<TableHeaderProps>;
-
-interface TablePaginationProps extends React__default.HTMLAttributes<HTMLDivElement> {
-    currentPage: number;
-    totalItems: number;
-    itemsPerPage: number;
-    onPageChange: (page: number) => void;
-    onItemsPerPageChange: (itemsPerPage: number) => void;
-    pageSizeOptions?: number[];
-    disabled?: boolean;
-    className?: string;
-}
-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 */
@@ -1518,7 +1379,7 @@ interface CheckboxFilterItem extends BaseFilterItem {
     /** Tipo do filtro */
     type: 'multiple' | 'single';
     /** Lista de itens disponíveis para seleção */
-    items: FilterItem$2[];
+    items: FilterItem$1[];
     /** IDs dos itens atualmente selecionados */
     selectedIds?: string[];
     /** Callback chamado quando a seleção muda */
@@ -1579,10 +1440,42 @@ interface CombinedFilterItem extends BaseFilterItem {
  * Pode ser do tipo multiple/single, calendário ou combined (Drawer).
  */
 type FilterItem = CheckboxFilterItem | CalendarFilterItem | CombinedFilterItem;
+/**
+ * Item de um ToggleButton de vista da tabela.
+ */
+interface ViewToggleItem {
+    /** Valor único do item */
+    value: string;
+    /** Ícone exibido no botão (iconOnly) */
+    icon: ReactNode;
+    /** Texto do tooltip exibido no hover */
+    tooltipText?: string;
+}
+/**
+ * Props do ToggleButton de alternância de vistas no cabeçalho do TableV2.
+ */
+interface TableV2ViewToggleProps<T = Record<string, unknown>> {
+    /** Exatamente 2 itens icon-only para alternar entre as vistas */
+    items: [ViewToggleItem, ViewToggleItem];
+    /** Valor controlado do item selecionado */
+    value?: string;
+    /** Valor selecionado inicial (não controlado) */
+    defaultValue?: string;
+    /** Callback chamado quando a vista selecionada muda */
+    onValueChange?: (value: string) => void;
+    /**
+     * Mapa de vistas: cada chave corresponde ao `value` de um item do toggle.
+     * Quando presente, o TableV2 alterna internamente entre as colunas e dados de cada vista.
+     */
+    views?: Record<string, {
+        columns: ColumnDef<T, any>[];
+        data: T[];
+    }>;
+}
 /**
  * Props do cabeçalho do TableV2, com busca global e filtros.
  */
-interface TableV2HeaderProps {
+interface TableV2HeaderProps<T = Record<string, unknown>> {
     /** Placeholder do campo de busca global */
     searchPlaceholder?: string;
     /** Items de filtro (Status, Data de início, etc.) */
@@ -1603,6 +1496,12 @@ interface TableV2HeaderProps {
      * A paginação é automaticamente resetada para a página 1 ao buscar.
      */
     onSearchChange?: (value: string) => void;
+    /**
+     * Quando presente, exibe um ToggleButton de 2 vistas (iconOnly) ao lado do Search.
+     * Use `views` para que o TableV2 alterne internamente entre colunas e dados.
+     * Use `onValueChange` se preferir controlar externamente.
+     */
+    viewToggle?: TableV2ViewToggleProps<T>;
 }
 /**
  * Props do rodapé do TableV2, com controles de paginação.
@@ -1722,7 +1621,7 @@ interface TableV2Props<T = Record<string, unknown>> extends EmptyStateProps {
     /** Configuração das ações em massa exibidas quando há linhas selecionadas */
     bulkActions?: TableV2BulkActionsProps<T>;
     /** Header acima da tabela com busca + filtros */
-    header?: TableV2HeaderProps;
+    header?: TableV2HeaderProps<T>;
     /** Footer com paginação */
     footer?: TableV2FooterProps;
     /** Classe CSS personalizada para o componente */
@@ -1742,7 +1641,7 @@ declare const TableV2: <T>({ columns, data, rowSelection: rowSelectionConfig, en
 /**
  * Props base compartilhadas por todas as configurações de tooltip do TextArea.
  */
-interface BaseTooltipConfig$1 {
+interface BaseTooltipConfig$2 {
     /** Lado em que o tooltip será exibido */
     tooltipSide?: Side;
     /** Alinhamento do tooltip */
@@ -1752,14 +1651,14 @@ interface BaseTooltipConfig$1 {
  * Configuração de tooltip com texto.
  * Exibe um tooltip ao redor da label do TextArea.
  */
-interface WithTooltip$1 extends BaseTooltipConfig$1 {
+interface WithTooltip$2 extends BaseTooltipConfig$2 {
     /** Texto do tooltip exibido no hover */
     tooltipText: string;
 }
 /**
  * Configuração sem tooltip.
  */
-interface WithoutTooltip$1 {
+interface WithoutTooltip$2 {
     tooltipText?: never;
     tooltipSide?: never;
     tooltipAlign?: never;
@@ -1768,7 +1667,7 @@ interface WithoutTooltip$1 {
  * 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;
+type TextAreaTooltipConfig = WithTooltip$2 | WithoutTooltip$2;
 /**
  * Props base do componente TextArea.
  */
@@ -1808,19 +1707,14 @@ interface TextAreaPropsBase extends Omit<React__default.TextareaHTMLAttributes<H
  */
 type TextAreaProps = TextAreaPropsBase & TextAreaTooltipConfig;
 
-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;
-}>;
+declare const _default$1: React__default.NamedExoticComponent<TextAreaProps & React__default.RefAttributes<HTMLTextAreaElement>>;
 
 /** Tipos de input suportados pelo TextField */
 type TextFieldType = 'text' | 'email' | 'password' | 'number' | 'tel' | 'url';
 /**
  * Props base compartilhadas por todas as configurações de tooltip do TextField.
  */
-interface BaseTooltipConfig {
+interface BaseTooltipConfig$1 {
     /** Lado em que o tooltip será exibido */
     tooltipSide?: Side;
     /** Alinhamento do tooltip */
@@ -1830,14 +1724,14 @@ interface BaseTooltipConfig {
  * Configuração de tooltip com texto.
  * Exibe um tooltip ao redor da label do TextField.
  */
-interface WithTooltip extends BaseTooltipConfig {
+interface WithTooltip$1 extends BaseTooltipConfig$1 {
     /** Texto do tooltip exibido no hover */
     tooltipText: string;
 }
 /**
  * Configuração sem tooltip.
  */
-interface WithoutTooltip {
+interface WithoutTooltip$1 {
     tooltipText?: never;
     tooltipSide?: never;
     tooltipAlign?: never;
@@ -1846,7 +1740,7 @@ interface WithoutTooltip {
  * 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;
+type TextFieldTooltipConfig = WithTooltip$1 | WithoutTooltip$1;
 /**
  * Props base do componente TextField
  * @example
@@ -1910,12 +1804,7 @@ interface TextFieldPropsBase extends ScalableProps, Omit<React__default.InputHTM
  */
 type TextFieldProps = TextFieldPropsBase & TextFieldTooltipConfig;
 
-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;
-}>;
+declare const _default: React__default.NamedExoticComponent<TextFieldProps & React__default.RefAttributes<HTMLInputElement>>;
 
 /**
  * Props do componente individual de notificação `Toast`.
@@ -2153,6 +2042,125 @@ interface SwitchProps extends ScalableProps {
 
 declare const Switch: React$1.FC<SwitchProps>;
 
+/** Modo do componente: 'simple' (toggle único) ou 'combined' (grupo de toggles) */
+type ToggleButtonMode = 'simple' | 'combined';
+/** Tipo de seleção do grupo: 'single' (um item) ou 'multiple' (múltiplos itens) */
+type ToggleGroupType = 'single' | 'multiple';
+/** Orientação do grupo de toggles */
+type ToggleButtonOrientation = 'horizontal' | 'vertical';
+interface BaseTooltipConfig {
+    tooltipSide?: 'top' | 'bottom' | 'left' | 'right';
+    tooltipAlign?: 'start' | 'center' | 'end';
+}
+interface WithTooltip extends BaseTooltipConfig {
+    /** Texto do tooltip exibido no hover */
+    tooltipText: string;
+}
+interface WithoutTooltip {
+    tooltipText?: never;
+    tooltipSide?: never;
+    tooltipAlign?: never;
+}
+type ToggleButtonTooltipConfig = WithTooltip | WithoutTooltip;
+/**
+ * Item de um ToggleGroup
+ */
+interface ToggleGroupItem {
+    /** Valor único do item (usado em `value` e `onValueChange`) */
+    value: string;
+    /** Conteúdo textual ou nó React exibido no item */
+    label?: ReactNode;
+    /** Ícone exibido à esquerda do label */
+    icon?: ReactNode;
+    /** Exibe somente o ícone, sem label */
+    iconOnly?: boolean;
+    /** Desabilita o item, impedindo sua seleção */
+    disabled?: boolean;
+}
+/** @internal */
+type ToggleGroupSingleSelectionProps = {
+    selectionType?: 'single';
+    /** Valor do Toggle selecionado controlado */
+    value?: string;
+    /** Valor do Toggle selecionado padrão (não controlado) */
+    defaultValue?: string;
+    /**
+     * Callback chamado quando o Toggle selecionado muda.
+     * Retorna o `value` do Toggle selecionado.
+     */
+    onValueChange?: (value: string) => void;
+};
+/** @internal */
+type ToggleGroupMultipleSelectionProps = {
+    selectionType: 'multiple';
+    /** Valores dos Toggles selecionados controlados */
+    value?: string[];
+    /** Valores dos Toggles selecionados padrão (não controlados) */
+    defaultValue?: string[];
+    /**
+     * Callback chamado quando os Toggles selecionados mudam.
+     * Retorna um array com os `value`s dos Toggles selecionados.
+     */
+    onValueChange?: (value: string[]) => void;
+};
+/**
+ * Props específicas do ToggleGroup (modo `combined`).
+ *
+ * Use a prop `onValueChange` para saber qual Toggle está selecionado:
+ * - `selectionType="single"` → `onValueChange: (value: string) => void`
+ * - `selectionType="multiple"` → `onValueChange: (value: string[]) => void`
+ */
+type ToggleGroupProps = {
+    /** Orientação do grupo: `'horizontal'` (padrão) ou `'vertical'` */
+    orientation?: ToggleButtonOrientation;
+    /** Items do grupo de toggles */
+    items?: ToggleGroupItem[];
+} & (ToggleGroupSingleSelectionProps | ToggleGroupMultipleSelectionProps);
+/**
+ * Props do componente ToggleButton
+ * @example
+ * ```tsx
+ * // Toggle único (modo simple — padrão)
+ * <ToggleButton mode="simple" onPressedChange={(pressed) => console.log(pressed)}>
+ *   Negrito
+ * </ToggleButton>
+ * ```
+ * @example
+ * ```tsx
+ * // Grupo de toggles (modo combined)
+ * <ToggleButton
+ *   mode="combined"
+ *   type="single"
+ *   items={[
+ *     { value: 'left', label: 'Esquerda' },
+ *     { value: 'center', label: 'Centro' },
+ *     { value: 'right', label: 'Direita' },
+ *   ]}
+ *   onValueChange={(value) => console.log(value)}
+ * />
+ * ```
+ */
+type ToggleButtonProps = ScalableProps & {
+    /** Modo do componente: `'simple'` (toggle único, padrão) ou `'combined'` (grupo de toggles) */
+    mode?: ToggleButtonMode;
+    /** Tamanho do componente: `'lg'` (padrão) ou `'sm'` */
+    size?: Size;
+    /** Ícone exibido à esquerda do conteúdo (modo simple) */
+    icon?: ReactNode;
+    /** Exibe somente o ícone, sem texto (modo simple) */
+    iconOnly?: boolean;
+    /** Conteúdo do botão (modo combined) */
+    children?: ReactNode;
+    /** Estado pressionado controlado (modo simple) */
+    pressed?: boolean;
+    /** Estado pressionado padrão não controlado (modo simple) */
+    defaultPressed?: boolean;
+    /** Callback ao alterar estado pressionado: `(pressed: boolean) => void` (modo simple) */
+    onPressedChange?: (pressed: boolean) => void;
+} & ToggleGroupProps & ToggleButtonTooltipConfig;
+
+declare const ToggleButton: React__default.FC<ToggleButtonProps>;
+
 /** Tipos de validação suportados pelo VerificationCode */
 type OTPValidationType = 'numeric' | 'alphanumeric' | 'alpha';
 /**
@@ -2329,5 +2337,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, 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 };
+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, TableV2, _default$1 as TextArea, _default as TextField, Toast, ToastContainer, ToastProvider, ToggleButton, Tooltip, VerificationCode, VirtualKeyboard, normalizeText, useApiSimulation, useInfiniteScroll, useToast };
+export type { AvatarProps, BadgeProps, ButtonProps, CalendarProps, CalloutProps, CardProps, CheckboxProps, ChipsProps, ContainerProps, DatePickerProps, DialogProps, DrawerProps, FileUploadProps, FilterProps, ListItemProps, MenuProps, ModalProps, PopoverProps, QuantityProps, RadioGroupProps, RadioProps, SearchProps, SelectProps, SwitchProps, TableV2FooterProps, TableV2HeaderProps, TableV2Props, TextAreaProps, TextFieldProps, ToastProps, ToggleButtonMode, ToggleButtonOrientation, ToggleButtonProps, ToggleGroupItem, ToggleGroupType, TooltipProps, VerificationCodeProps, VirtualKeyboardProps, VirtualKeyboardVariant };