@giro-ds/react 2.0.0 → 3.0.0

package/dist/index.d.ts

@@ -32,50 +32,30 @@ interface BadgeProps {
 
 declare const Badge: React__default.FC<BadgeProps>;
 
-interface ButtonProps {
-    /** Define o elemento a ser renderizado (ex: 'button', 'a', ou componente de roteamento) */
+interface ButtonProps extends React__default.HTMLAttributes<HTMLElement> {
     as?: React__default.ElementType;
-    /** Define o texto principal do botão */
     children?: React__default.ReactNode;
-    /** Define tipo do botão entre as opções */
     variant?: 'filled' | 'outlined' | 'text';
     iconOnly?: boolean;
-    /** Define a posição do ícone entre as opções */
-    iconPosition?: 'none' | 'left' | 'right';
-    /** URL para links externos (ex: https://example.com) */
+    iconPosition?: 'left' | 'right' | 'both';
     href?: string;
-    /** Rota interna para navegação SPA (ex: /dashboard, /profile) */
     to?: string;
-    /** Indica se o link é externo */
     external?: boolean;
-    /** Target para links (_blank, _self, etc.) */
     target?: string;
-    /** Rel attribute para links */
     rel?: string;
-    /** Props para React Router (replace, state, etc.) */
-    routerProps?: Record<string, any>;
     type?: 'button' | 'submit' | 'reset';
-    /** Desabilita interações do botão */
     disabled?: boolean;
-    /** Função a ser chamada quando o botão é clicado */
     onClick?: (event: React__default.MouseEvent<HTMLElement>) => void;
-    /** Define o tamanho do botão entre as opções */
     size?: 'lg' | 'sm';
-    /** Classe CSS opcional */
     className?: string;
-    /** ID opcional */
     id?: string;
-    /** Ícone opcional */
     icon?: React__default.ReactNode;
-    /** Define se o botão deve ocupar toda a largura */
     fullWidth?: boolean;
-    /** Texto para acessibilidade */
     ariaLabel?: string;
-    /** Outros props específicos do elemento/componente */
-    [key: string]: any;
+    loading?: boolean;
 }
 
-declare const Button: React__default.ForwardRefExoticComponent<Omit<ButtonProps, "ref"> & React__default.RefAttributes<HTMLElement>>;
+declare const Button: React__default.ForwardRefExoticComponent<ButtonProps & React__default.RefAttributes<HTMLElement>>;
 
 type Locale = 'pt-br' | 'en-us';
 type DateFormat = 'dd/mm/yyyy' | 'mm/dd/yyyy';
@@ -427,49 +407,6 @@ interface ListItemProps {
  */
 declare const ListItem: React__default.FC<ListItemProps>;
 
-interface MenuItem {
-    /** ID único do item */
-    id: string;
-    /** Texto principal do item */
-    text: string;
-    /** Texto secundário opcional */
-    subText?: string;
-    /** Ícone do item */
-    icon?: ReactNode;
-    /** Estado desabilitado */
-    disabled?: boolean;
-    /** Valor customizado do item */
-    value?: unknown;
-}
-interface MenuProps {
-    /** Elemento React que será usado como âncora do menu (obrigatório) */
-    children: ReactElement<any, any>;
-    /** Array de itens do menu */
-    menuItems?: MenuItem[];
-    /** Callback executado quando um item do menu é clicado */
-    onMenuItemClick?: (item: MenuItem) => void;
-    /** Callback executado quando o menu é aberto/fechado */
-    onToggle?: (isOpen: boolean) => void;
-    /** Tipo do dropdown */
-    type?: 'text' | 'icon';
-    /** Habilita campo de busca */
-    applySearch?: boolean;
-    /** Placeholder do campo de busca */
-    placeholder?: string;
-    /** Controla exibição do subtexto */
-    showSubText?: boolean;
-    /** Classes CSS adicionais */
-    className?: string;
-    /** ID único do componente */
-    id?: string;
-    maxWidth?: string | number;
-    minWidth?: string | number;
-    /** Posição do menu em relação ao elemento âncora */
-    position?: 'left' | 'right';
-}
-
-declare const Menu: React__default.FC<MenuProps>;
-
 interface MenuItemProps {
     id?: string;
     text?: string;
@@ -479,7 +416,7 @@ interface MenuItemProps {
     children?: MenuItemProps[];
     value?: string;
 }
-interface MenuRadixProps {
+interface MenuProps {
     items: MenuItemProps[];
     children?: ReactElement;
     type?: 'text' | 'icon';
@@ -497,7 +434,7 @@ interface MenuRadixProps {
     onOpenChange?: (open: boolean) => void;
 }
 
-declare const MenuRadix: React__default.FC<MenuRadixProps>;
+declare const Menu: React__default.FC<MenuProps>;
 
 interface QuantityProps {
     /** Valor padrão inicial */
@@ -553,115 +490,11 @@ interface SearchProps {
     onMouseDown?: (e: React__default.MouseEvent<HTMLDivElement>) => void;
     className?: string;
     id?: string;
+    'data-testid'?: string;
 }
 
 declare const Search: React__default.ForwardRefExoticComponent<SearchProps & React__default.RefAttributes<HTMLInputElement>>;
 
-interface SelectOption {
-    /** ID único da opção (opcional, será gerado automaticamente se não fornecido) */
-    id?: string;
-    /** Texto principal da opção */
-    text: string;
-    /** Texto secundário/descrição da opção */
-    subText?: string;
-    /** Ícone da opção (React node) */
-    icon?: React__default.ReactNode;
-    /** Define se a opção está desabilitada */
-    disabled?: boolean;
-}
-interface SelectProps {
-    /** ID único do componente */
-    id?: string;
-    /** Array de opções para seleção - obrigatório */
-    options: SelectOption[];
-    /** Valor(es) selecionado(s) */
-    value?: string | string[];
-    /** Valor inicial para seleção (usado apenas na primeira renderização) */
-    initialValue?: string | string[];
-    /** Callback para mudanças na seleção */
-    onChange?: (selectedItems: SelectOption[]) => void;
-    /** Placeholder do campo */
-    placeholder?: string;
-    /** Tipo do dropdown (single ou multiple) */
-    type?: DropdownType;
-    maxHeight?: string;
-    /** Label do campo */
-    label?: string;
-    /** Texto de ajuda */
-    helperText?: string;
-    /** Mensagem de erro */
-    errorMessage?: string;
-    /** Campo obrigatório */
-    required?: boolean;
-    /** Campo desabilitado */
-    disabled?: boolean;
-    /** Classes CSS adicionais */
-    className?: string;
-    /** Texto para acessibilidade */
-    showSubText?: boolean;
-    /** Aria-label do campo */
-    ariaLabel?: string;
-    /** Habilita campo de busca */
-    applySearch?: boolean;
-    /** Placeholder do campo de busca */
-    searchPlaceholder?: string;
-    maxWidth?: string;
-    minWidth?: string;
-    tooltip?: boolean;
-    tooltipText?: string;
-    width?: string;
-    /** Força posição do dropdown: 'top' abre para cima, 'bottom' abre para baixo. Se não especificado, usa detecção automática */
-    position?: 'top' | 'bottom';
-    positionTooltip?: 'top-right' | 'top-left' | 'bottom-right' | 'bottom-left' | 'left' | 'right';
-    infiniteScroll?: {
-        status: 'idle' | 'loading' | 'succeeded' | 'failed';
-        page: number;
-        lastPage: number;
-        onLoadMore: () => void;
-        threshold?: number;
-        rootMargin?: string;
-    };
-}
-
-declare const Select: React__default.NamedExoticComponent<SelectProps>;
-
-interface SelectFieldProps {
-    /** ID do campo */
-    id?: string;
-    /** Nome do campo */
-    name?: string;
-    /** Valor exibido */
-    value?: string;
-    /** Placeholder */
-    placeholder?: string;
-    /** Label do campo */
-    label?: string;
-    /** Texto de ajuda */
-    helperText?: string;
-    /** Mensagem de erro */
-    errorMessage?: string;
-    /** Campo obrigatório */
-    required?: boolean;
-    /** Campo desabilitado */
-    disabled?: boolean;
-    /** Ícone (chevron) */
-    icon?: React__default.ReactNode;
-    /** Estado aberto */
-    isOpen?: boolean;
-    /** Classes CSS adicionais */
-    className?: string;
-    /** Tooltip info */
-    tooltip?: React__default.ReactNode;
-    tooltipText?: string;
-    positionTooltip?: 'top-right' | 'top-left' | 'bottom-right' | 'bottom-left' | 'left' | 'right';
-    /** Indica se o campo foi "tocado" (aberto e fechado) */
-    isTouched?: boolean;
-    /** Força estado de erro independente da validação interna */
-    hasError?: boolean;
-}
-
-declare const SelectField: React__default.ForwardRefExoticComponent<SelectFieldProps & React__default.RefAttributes<HTMLDivElement>>;
-
 interface SelectItemProps {
     id?: string;
     text: ReactNode;
@@ -670,9 +503,10 @@ interface SelectItemProps {
     disabled?: boolean;
     value: string;
     selected?: boolean;
+    children?: SelectItemProps[];
 }
 type SelectVariant = 'text' | 'icon' | 'checkbox';
-interface SelectRadixProps {
+interface SelectProps {
     items: SelectItemProps[];
     onValueChange?: (value: string | string[]) => void;
     onOpenChange?: (open: boolean) => void;
@@ -684,7 +518,7 @@ interface SelectRadixProps {
     search?: boolean;
     label?: string;
     helperText?: string;
-    maxWidth?: string | number;
+    maxWidth?: number;
     errorMessage?: string;
     disabled?: boolean;
     className?: string;
@@ -702,44 +536,80 @@ interface SelectRadixProps {
     isSearching?: boolean;
 }
 
-declare const SelectRadix: React__default.FC<SelectRadixProps>;
+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';
-interface TableColumn {
+/**
+ * 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;
-    render?: (row: TableRowData, index: number) => ReactNode;
+    /** 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;
 }
-type TableRowData = Record<string, any>;
-interface TableProps {
-    columns: TableColumn[];
-    dataSource: TableRowData[];
+/**
+ * Props do componente Table. Use genérico para autocomplete: `<Table<User>>`
+ * @typeParam T - Tipo dos dados da linha
+ */
+interface TableProps<T = TableRowData> {
+    /** Configuração das colunas */
+    columns: TableColumn<T>[];
+    /** Array de dados a serem exibidos */
+    dataSource: T[];
+    /** Classe CSS customizada */
     className?: string;
+    /** Estado de carregamento */
     loading?: boolean;
+    /** Configuração de seleção de linhas */
     rowSelection?: {
+        /** Keys das linhas selecionadas (modo controlado) */
         selectedRowKeys?: (string | number)[];
-        onChange?: (keys: (string | number)[], rows: TableRowData[]) => void;
-        getCheckboxProps?: (row: TableRowData, index: 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 */
-    onRow?: (row: TableRowData, index: number) => {
+    /** 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: React__default.FC<TableProps>;
+declare const Table: <T extends TableRowData = TableRowData>({ columns, dataSource, className, loading, rowSelection, locale, onRow, }: TableProps<T>) => react_jsx_runtime.JSX.Element | null;
 
 interface BaseFilterItem {
     id?: string;
@@ -868,8 +738,8 @@ interface TooltipProps {
 declare const Tooltip: React__default.FC<TooltipProps>;
 
 interface SwitchProps {
-    defaultChecked: boolean;
-    disabled: boolean;
+    defaultChecked?: boolean;
+    disabled?: boolean;
     onCheckedChange?: (checked: boolean) => void;
     name?: string;
     value?: string;
@@ -1012,5 +882,5 @@ declare function useInfiniteScroll({ status, page, lastPage, onLoadMore, thresho
 
 declare const normalizeText: (text: React.ReactNode) => string;
 
-export { Avatar, Badge, Button, MemoizedCalendar as Calendar, Callout, Checkbox, MemoizedChips as Chips, Container, _default$1 as DatePicker, MemoizedDialog as Dialog, Drawer, MemoizedDropdown as Dropdown, Filter, ListItem, Menu, MenuRadix, memorizedQuantity as Quantity, Radio, Search, Select, SelectField, SelectRadix, Switch, Table, TableHeader, TablePagination, _default as TextField, ToastProvider as Toast, ToastProvider, Tooltip, VerificationCode, normalizeText, useApiSimulation, useInfiniteScroll, useToast };
-export type { AvatarProps, BadgeProps, ButtonProps, CalendarItem, CalendarProps, CalloutProps, CheckboxProps, ChipsProps, ContainerProps, DateFormat, DatePickerProps, DayItem, DialogProps, DrawerProps, DropdownItem, DropdownProps, DropdownType, EmptyItem, FilterItem, FilterProps, ListItemProps, Locale, MenuItem, MenuProps, MenuRadixProps, QuantityProps, RadioGroupProps, RadioProps, SearchProps, SelectFieldProps, SelectOption, SelectProps, SelectRadixProps, SwitchProps, TableHeaderProps, TablePaginationProps, TableProps, TextFieldProps, ToastContextType, ToastMessage, ToastOptions, ToastType, TooltipProps, VerificationCodeProps, YearItem };
+export { Avatar, Badge, Button, MemoizedCalendar as Calendar, Callout, Checkbox, MemoizedChips as Chips, Container, _default$1 as DatePicker, MemoizedDialog as Dialog, Drawer, MemoizedDropdown as Dropdown, Filter, ListItem, Menu, memorizedQuantity as Quantity, Radio, Search, Select, Switch, Table, TableHeader, TablePagination, _default as TextField, ToastProvider as Toast, ToastProvider, Tooltip, VerificationCode, normalizeText, useApiSimulation, useInfiniteScroll, useToast };
+export type { AvatarProps, BadgeProps, ButtonProps, CalendarItem, CalendarProps, CalloutProps, CheckboxProps, ChipsProps, ContainerProps, DateFormat, DatePickerProps, DayItem, DialogProps, DrawerProps, DropdownItem, DropdownProps, DropdownType, EmptyItem, FilterItem, FilterProps, ListItemProps, Locale, MenuProps, QuantityProps, RadioGroupProps, RadioProps, SearchProps, SelectProps, SwitchProps, TableHeaderProps, TablePaginationProps, TableProps, TextFieldProps, ToastContextType, ToastMessage, ToastOptions, ToastType, TooltipProps, VerificationCodeProps, YearItem };