@giro-ds/react 7.0.0 → 9.0.0

package/dist/index.d.ts

@@ -3,6 +3,7 @@ import React__default, { ReactNode, ReactElement, ComponentPropsWithoutRef, CSSP
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { Matcher } from 'react-day-picker';
 import { RowData, ColumnDef } from '@tanstack/react-table';
+export { ColumnDef as TableColumnDefinition, createColumnHelper as createTableColumnHelper } from '@tanstack/react-table';
 import { Toast as Toast$1 } from 'radix-ui';
 
 /** Tamanho do componente: 'sm' (pequeno) ou 'lg' (grande) */
@@ -522,25 +523,27 @@ 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;
+    id?: BaseProps['id'];
     text: string;
     subText?: string;
     icon?: ReactNode;
-    disabled?: boolean;
+    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"
@@ -598,7 +601,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>;
@@ -973,6 +996,18 @@ 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 */
@@ -1166,7 +1201,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;
@@ -1238,12 +1273,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 */
@@ -1277,21 +1312,57 @@ 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[];
+    /** 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.
@@ -1307,6 +1378,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.
@@ -1319,6 +1398,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.
  */
@@ -1354,7 +1454,7 @@ interface TableV2BulkActionsProps<T = Record<string, unknown>> {
  *   columns={columns}
  *   data={data}
  *   enableSorting
- *   enableRowSelection
+ *   rowSelection={{ onRowChange: (rows, keys) => console.log(rows, keys) }}
  *   loading={isLoading}
  * />
  * ```
@@ -1364,14 +1464,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 */
@@ -1390,7 +1497,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