@iclips/ui 1.0.2 → 1.0.6

package/dist/index.d.ts

@@ -3,7 +3,7 @@ import * as React$1 from 'react';
 import React__default, { RefObject } from 'react';
 import * as AccordionPrimitive from '@radix-ui/react-accordion';
 import * as AlertDialogPrimitive from '@radix-ui/react-alert-dialog';
-import * as class_variance_authority_types from 'class-variance-authority/types';
+import * as class_variance_authority_dist_types from 'class-variance-authority/dist/types';
 import { VariantProps } from 'class-variance-authority';
 import { LucideIcon } from 'lucide-react';
 import * as AspectRatioPrimitive from '@radix-ui/react-aspect-ratio';
@@ -13,6 +13,7 @@ import useEmblaCarousel, { UseEmblaCarouselType } from 'embla-carousel-react';
 import * as RechartsPrimitive from 'recharts';
 import * as CheckboxPrimitive from '@radix-ui/react-checkbox';
 import * as CollapsiblePrimitive from '@radix-ui/react-collapsible';
+import { Locale } from 'date-fns';
 import { Command as Command$1 } from 'cmdk';
 import * as DialogPrimitive from '@radix-ui/react-dialog';
 import * as ContextMenuPrimitive from '@radix-ui/react-context-menu';
@@ -60,7 +61,7 @@ declare function AlertDialogCancel({ className, ...props }: React$1.ComponentPro
 
 declare const alertVariants: (props?: ({
     variant?: "default" | "destructive" | null | undefined;
-} & class_variance_authority_types.ClassProp) | undefined) => string;
+} & class_variance_authority_dist_types.ClassProp) | undefined) => string;
 declare function Alert({ className, variant, ...props }: React$1.ComponentProps<"div"> & VariantProps<typeof alertVariants>): react_jsx_runtime.JSX.Element;
 declare function AlertTitle({ className, ...props }: React$1.ComponentProps<"div">): react_jsx_runtime.JSX.Element;
 declare function AlertDescription({ className, ...props }: React$1.ComponentProps<"div">): react_jsx_runtime.JSX.Element;
@@ -102,10 +103,10 @@ declare function AvatarFallback({ className, ...props }: React$1.ComponentProps<
 
 declare const badgeVariants: (props?: ({
     variant?: "default" | "destructive" | "outline" | "secondary" | null | undefined;
-} & class_variance_authority_types.ClassProp) | undefined) => string;
+} & class_variance_authority_dist_types.ClassProp) | undefined) => string;
 declare const Badge: React$1.ForwardRefExoticComponent<Omit<React$1.DetailedHTMLProps<React$1.HTMLAttributes<HTMLSpanElement>, HTMLSpanElement>, "ref"> & VariantProps<(props?: ({
     variant?: "default" | "destructive" | "outline" | "secondary" | null | undefined;
-} & class_variance_authority_types.ClassProp) | undefined) => string> & {
+} & class_variance_authority_dist_types.ClassProp) | undefined) => string> & {
     asChild?: boolean;
 } & React$1.RefAttributes<HTMLSpanElement>>;
 
@@ -122,14 +123,42 @@ declare function BreadcrumbEllipsis({ className, ...props }: React$1.ComponentPr
 declare const buttonVariants: (props?: ({
     variant?: "link" | "default" | "destructive" | "outline" | "secondary" | "ghost" | null | undefined;
     size?: "default" | "sm" | "lg" | "icon" | null | undefined;
-} & class_variance_authority_types.ClassProp) | undefined) => string;
+} & class_variance_authority_dist_types.ClassProp) | undefined) => string;
 declare const Button: React$1.ForwardRefExoticComponent<Omit<React$1.ClassAttributes<HTMLButtonElement> & React$1.ButtonHTMLAttributes<HTMLButtonElement> & VariantProps<(props?: ({
     variant?: "link" | "default" | "destructive" | "outline" | "secondary" | "ghost" | null | undefined;
     size?: "default" | "sm" | "lg" | "icon" | null | undefined;
-} & class_variance_authority_types.ClassProp) | undefined) => string> & {
+} & class_variance_authority_dist_types.ClassProp) | undefined) => string> & {
     asChild?: boolean;
 }, "ref"> & React$1.RefAttributes<HTMLButtonElement>>;
 
+type CalendarProps = React$1.ComponentProps<typeof DayPicker>;
+/**
+ * Calendar - Componente base de calendário
+ *
+ * Grid de dias para seleção de datas. Usado internamente pelo DatePicker
+ * e DateRangePicker, mas também pode ser usado standalone.
+ *
+ * @example
+ * // Seleção única
+ * <Calendar
+ *   mode="single"
+ *   selected={date}
+ *   onSelect={setDate}
+ * />
+ *
+ * @example
+ * // Seleção de intervalo
+ * <Calendar
+ *   mode="range"
+ *   selected={dateRange}
+ *   onSelect={setDateRange}
+ * />
+ */
+declare function Calendar({ className, classNames, showOutsideDays, locale, ...props }: CalendarProps): react_jsx_runtime.JSX.Element;
+declare namespace Calendar {
+    var displayName: string;
+}
+
 interface DadosContrato {
     numeroContrato: string;
     dataEmissao: string;
@@ -260,8 +289,6 @@ declare const ContractPrintPreview: React$1.ForwardRefExoticComponent<{
     className?: string;
 } & React$1.RefAttributes<HTMLDivElement>>;
 
-declare function Calendar({ className, classNames, showOutsideDays, ...props }: React$1.ComponentProps<typeof DayPicker>): react_jsx_runtime.JSX.Element;
-
 declare function Card({ className, ...props }: React$1.ComponentProps<"div">): react_jsx_runtime.JSX.Element;
 declare function CardHeader({ className, ...props }: React$1.ComponentProps<"div">): react_jsx_runtime.JSX.Element;
 declare function CardTitle({ className, ...props }: React$1.ComponentProps<"div">): react_jsx_runtime.JSX.Element;
@@ -339,35 +366,319 @@ declare function Collapsible({ ...props }: React.ComponentProps<typeof Collapsib
 declare function CollapsibleTrigger({ ...props }: React.ComponentProps<typeof CollapsiblePrimitive.CollapsibleTrigger>): react_jsx_runtime.JSX.Element;
 declare function CollapsibleContent({ ...props }: React.ComponentProps<typeof CollapsiblePrimitive.CollapsibleContent>): react_jsx_runtime.JSX.Element;
 
-interface DateTimePickerProps {
-    date?: Date;
+interface DatePickerProps {
+    /**
+     * Data selecionada
+     */
+    value?: Date;
+    /**
+     * Callback quando a data muda
+     */
     onChange?: (date: Date | undefined) => void;
-    label?: string;
+    /**
+     * Placeholder do campo
+     * @default "Selecione uma data"
+     */
     placeholder?: string;
-    className?: string;
+    /**
+     * Desabilita o componente
+     */
     disabled?: boolean;
+    /**
+     * Data mínima permitida
+     */
+    minDate?: Date;
+    /**
+     * Data máxima permitida
+     */
+    maxDate?: Date;
+    /**
+     * Formato de exibição da data
+     * @default "dd/MM/yyyy" ou "dd/MM/yyyy HH:mm" se showTime
+     */
+    dateFormat?: string;
+    /**
+     * Locale para formatação
+     * @default ptBR
+     */
+    locale?: Locale;
+    /**
+     * Classes CSS adicionais para o trigger
+     */
+    className?: string;
+    /**
+     * Estado de erro
+     */
+    error?: boolean;
+    /**
+     * Mostra seletor de hora
+     * @default false
+     */
+    showTime?: boolean;
+    /**
+     * Formato de hora (12h ou 24h)
+     * @default "24h"
+     */
+    timeFormat?: "12h" | "24h";
+    /**
+     * Incremento de minutos
+     * @default 5
+     */
+    minuteStep?: 1 | 5 | 10 | 15 | 30;
+    /**
+     * Horário padrão quando showTime=true e uma data é selecionada
+     * @default "09:00"
+     */
+    defaultTime?: string;
+    /**
+     * ID do campo para acessibilidade
+     */
+    id?: string;
+    /**
+     * Nome do campo para formulários
+     */
+    name?: string;
+}
+/**
+ * DatePicker - Campo de seleção de data com hora opcional
+ *
+ * @example
+ * // Apenas data
+ * <DatePicker
+ *   value={date}
+ *   onChange={setDate}
+ *   placeholder="Data de nascimento"
+ * />
+ *
+ * @example
+ * // Data e hora
+ * <DatePicker
+ *   value={appointmentDate}
+ *   onChange={setAppointmentDate}
+ *   placeholder="Data e hora da reunião"
+ *   showTime
+ *   minuteStep={15}
+ * />
+ *
+ * @example
+ * // Com limites
+ * <DatePicker
+ *   value={date}
+ *   onChange={setDate}
+ *   minDate={new Date()}
+ *   maxDate={addMonths(new Date(), 3)}
+ * />
+ */
+declare function DatePicker({ value, onChange, placeholder, disabled, minDate, maxDate, dateFormat, locale, className, error, showTime, timeFormat, minuteStep, defaultTime, id, name, }: DatePickerProps): react_jsx_runtime.JSX.Element;
+declare namespace DatePicker {
+    var displayName: string;
 }
-declare function DateTimePicker({ date, onChange, label, placeholder, className, disabled, }: DateTimePickerProps): react_jsx_runtime.JSX.Element;
 
+interface DateRangePreset {
+    label: string;
+    value: DateRange;
+}
 interface DateRangePickerProps {
-    dateRange?: DateRange;
+    /**
+     * Intervalo de datas selecionado
+     */
+    value?: DateRange;
+    /**
+     * Callback quando o intervalo muda
+     */
     onChange?: (range: DateRange | undefined) => void;
-    label?: string;
+    /**
+     * Placeholder do campo
+     * @default "Selecione um período"
+     */
     placeholder?: string;
-    className?: string;
+    /**
+     * Desabilita o componente
+     */
     disabled?: boolean;
-    withTime?: boolean;
+    /**
+     * Data mínima permitida
+     */
+    minDate?: Date;
+    /**
+     * Data máxima permitida
+     */
+    maxDate?: Date;
+    /**
+     * Formato de exibição da data
+     * @default "dd/MM/yyyy"
+     */
+    dateFormat?: string;
+    /**
+     * Locale para formatação
+     * @default ptBR
+     */
+    locale?: Locale;
+    /**
+     * Classes CSS adicionais para o trigger
+     */
+    className?: string;
+    /**
+     * Estado de erro
+     */
+    error?: boolean;
+    /**
+     * Número de meses a exibir
+     * @default 2
+     */
+    numberOfMonths?: 1 | 2;
+    /**
+     * Mostra seletor de hora
+     * @default false
+     */
+    showTime?: boolean;
+    /**
+     * Formato de hora (12h ou 24h)
+     * @default "24h"
+     */
+    timeFormat?: "12h" | "24h";
+    /**
+     * Incremento de minutos
+     * @default 15
+     */
+    minuteStep?: 1 | 5 | 10 | 15 | 30;
+    /**
+     * Presets de intervalos rápidos
+     */
+    presets?: DateRangePreset[];
+    /**
+     * Mostra presets padrão (Hoje, Últimos 7 dias, etc.)
+     * @default true
+     */
+    showDefaultPresets?: boolean;
+    /**
+     * ID do campo para acessibilidade
+     */
+    id?: string;
+    /**
+     * Nome do campo para formulários
+     */
+    name?: string;
+}
+/**
+ * DateRangePicker - Campo de seleção de intervalo de datas com hora opcional
+ *
+ * @example
+ * // Básico
+ * <DateRangePicker
+ *   value={dateRange}
+ *   onChange={setDateRange}
+ *   placeholder="Período do relatório"
+ * />
+ *
+ * @example
+ * // Com hora
+ * <DateRangePicker
+ *   value={booking}
+ *   onChange={setBooking}
+ *   placeholder="Reserva da sala"
+ *   showTime
+ *   minuteStep={30}
+ * />
+ *
+ * @example
+ * // Com presets customizados
+ * <DateRangePicker
+ *   value={period}
+ *   onChange={setPeriod}
+ *   presets={[
+ *     { label: "Q1", value: { from: q1Start, to: q1End } },
+ *     { label: "Q2", value: { from: q2Start, to: q2End } },
+ *   ]}
+ * />
+ */
+declare function DateRangePicker({ value, onChange, placeholder, disabled, minDate, maxDate, dateFormat, locale, className, error, numberOfMonths, showTime, timeFormat, minuteStep, presets, showDefaultPresets, id, name, }: DateRangePickerProps): react_jsx_runtime.JSX.Element;
+declare namespace DateRangePicker {
+    var displayName: string;
 }
-declare function DateRangePicker({ dateRange, onChange, label, placeholder, className, disabled, withTime, }: DateRangePickerProps): react_jsx_runtime.JSX.Element;
 
 interface TimePickerProps {
-    date?: Date;
-    onChange?: (date: Date | undefined) => void;
-    label?: string;
-    className?: string;
+    /**
+     * Valor atual no formato "HH:mm"
+     */
+    value?: string;
+    /**
+     * Callback quando o horário muda
+     */
+    onChange?: (time: string) => void;
+    /**
+     * Formato de exibição (12h com AM/PM ou 24h)
+     * @default "24h"
+     */
+    format?: "12h" | "24h";
+    /**
+     * Incremento de minutos no seletor
+     * @default 5
+     */
+    minuteStep?: 1 | 5 | 10 | 15 | 30;
+    /**
+     * Horário mínimo permitido (formato "HH:mm")
+     */
+    minTime?: string;
+    /**
+     * Horário máximo permitido (formato "HH:mm")
+     */
+    maxTime?: string;
+    /**
+     * Desabilita o componente
+     */
     disabled?: boolean;
+    /**
+     * Placeholder
+     * @default "HH:MM"
+     */
+    placeholder?: string;
+    /**
+     * Classes CSS adicionais
+     */
+    className?: string;
+    /**
+     * Mostra o ícone de relógio
+     * @default true
+     */
+    showIcon?: boolean;
+    /**
+     * Variante de exibição
+     * @default "input"
+     */
+    variant?: "input" | "select" | "inline";
+}
+/**
+ * TimePicker - Componente para seleção de horário
+ *
+ * @example
+ * // Input simples
+ * <TimePicker
+ *   value={time}
+ *   onChange={setTime}
+ *   placeholder="Horário"
+ * />
+ *
+ * @example
+ * // Com step de 15 minutos
+ * <TimePicker
+ *   value={time}
+ *   onChange={setTime}
+ *   minuteStep={15}
+ * />
+ *
+ * @example
+ * // Formato 12h
+ * <TimePicker
+ *   value={time}
+ *   onChange={setTime}
+ *   format="12h"
+ * />
+ */
+declare function TimePicker({ value, onChange, format, minuteStep, minTime, maxTime, disabled, placeholder, className, showIcon, variant, }: TimePickerProps): react_jsx_runtime.JSX.Element | null;
+declare namespace TimePicker {
+    var displayName: string;
 }
-declare function TimePicker({ date, onChange, label, className, disabled, }: TimePickerProps): react_jsx_runtime.JSX.Element;
 
 interface KanbanCardTag {
     id: string;
@@ -551,7 +862,7 @@ declare function NavigationMenu({ className, children, viewport, ...props }: Rea
 }): react_jsx_runtime.JSX.Element;
 declare function NavigationMenuList({ className, ...props }: React$1.ComponentProps<typeof NavigationMenuPrimitive.List>): react_jsx_runtime.JSX.Element;
 declare function NavigationMenuItem({ className, ...props }: React$1.ComponentProps<typeof NavigationMenuPrimitive.Item>): react_jsx_runtime.JSX.Element;
-declare const navigationMenuTriggerStyle: (props?: class_variance_authority_types.ClassProp | undefined) => string;
+declare const navigationMenuTriggerStyle: (props?: class_variance_authority_dist_types.ClassProp | undefined) => string;
 declare function NavigationMenuTrigger({ className, children, ...props }: React$1.ComponentProps<typeof NavigationMenuPrimitive.Trigger>): react_jsx_runtime.JSX.Element;
 declare function NavigationMenuContent({ className, ...props }: React$1.ComponentProps<typeof NavigationMenuPrimitive.Content>): react_jsx_runtime.JSX.Element;
 declare function NavigationMenuLink({ className, ...props }: React$1.ComponentProps<typeof NavigationMenuPrimitive.Link>): react_jsx_runtime.JSX.Element;
@@ -654,7 +965,7 @@ declare function SidebarMenuItem({ className, ...props }: React$1.ComponentProps
 declare const sidebarMenuButtonVariants: (props?: ({
     variant?: "default" | "outline" | null | undefined;
     size?: "default" | "sm" | "lg" | null | undefined;
-} & class_variance_authority_types.ClassProp) | undefined) => string;
+} & class_variance_authority_dist_types.ClassProp) | undefined) => string;
 declare function SidebarMenuButton({ asChild, isActive, variant, size, tooltip, className, ...props }: React$1.ComponentProps<"button"> & {
     asChild?: boolean;
     isActive?: boolean;
@@ -688,14 +999,459 @@ declare const Toaster: ({ ...props }: ToasterProps) => react_jsx_runtime.JSX.Ele
 
 declare function Switch({ className, ...props }: React$1.ComponentProps<typeof SwitchPrimitive.Root>): react_jsx_runtime.JSX.Element;
 
-declare function Table({ className, ...props }: React$1.ComponentProps<"table">): react_jsx_runtime.JSX.Element;
-declare function TableHeader({ className, ...props }: React$1.ComponentProps<"thead">): react_jsx_runtime.JSX.Element;
-declare function TableBody({ className, ...props }: React$1.ComponentProps<"tbody">): react_jsx_runtime.JSX.Element;
-declare function TableFooter({ className, ...props }: React$1.ComponentProps<"tfoot">): react_jsx_runtime.JSX.Element;
-declare const TableRow: React$1.ForwardRefExoticComponent<Omit<React$1.DetailedHTMLProps<React$1.HTMLAttributes<HTMLTableRowElement>, HTMLTableRowElement>, "ref"> & React$1.RefAttributes<HTMLTableRowElement>>;
-declare function TableHead({ className, ...props }: React$1.ComponentProps<"th">): react_jsx_runtime.JSX.Element;
-declare function TableCell({ className, ...props }: React$1.ComponentProps<"td">): react_jsx_runtime.JSX.Element;
-declare function TableCaption({ className, ...props }: React$1.ComponentProps<"caption">): react_jsx_runtime.JSX.Element;
+interface TableProps extends React$1.ComponentProps<"table"> {
+}
+interface TableHeaderProps extends React$1.ComponentProps<"thead"> {
+}
+interface TableBodyProps extends React$1.ComponentProps<"tbody"> {
+}
+interface TableFooterProps extends React$1.ComponentProps<"tfoot"> {
+}
+interface TableRowProps extends React$1.ComponentProps<"tr"> {
+}
+interface TableHeadProps extends React$1.ComponentProps<"th"> {
+}
+interface TableCellProps extends React$1.ComponentProps<"td"> {
+}
+interface TableCaptionProps extends React$1.ComponentProps<"caption"> {
+}
+declare const Table: React$1.ForwardRefExoticComponent<Omit<TableProps, "ref"> & React$1.RefAttributes<HTMLTableElement>>;
+declare const TableHeader: React$1.ForwardRefExoticComponent<Omit<TableHeaderProps, "ref"> & React$1.RefAttributes<HTMLTableSectionElement>>;
+declare const TableBody: React$1.ForwardRefExoticComponent<Omit<TableBodyProps, "ref"> & React$1.RefAttributes<HTMLTableSectionElement>>;
+declare const TableFooter: React$1.ForwardRefExoticComponent<Omit<TableFooterProps, "ref"> & React$1.RefAttributes<HTMLTableSectionElement>>;
+declare const TableRow: React$1.ForwardRefExoticComponent<Omit<TableRowProps, "ref"> & React$1.RefAttributes<HTMLTableRowElement>>;
+declare const TableHead: React$1.ForwardRefExoticComponent<Omit<TableHeadProps, "ref"> & React$1.RefAttributes<HTMLTableCellElement>>;
+declare const TableCell: React$1.ForwardRefExoticComponent<Omit<TableCellProps, "ref"> & React$1.RefAttributes<HTMLTableCellElement>>;
+declare const TableCaption: React$1.ForwardRefExoticComponent<Omit<TableCaptionProps, "ref"> & React$1.RefAttributes<HTMLTableCaptionElement>>;
+
+/**
+ * Labels for internationalization
+ */
+interface TablePaginationLabels {
+    /** "Anterior" */
+    previous?: string;
+    /** "Próxima" */
+    next?: string;
+    /** "Primeira" */
+    first?: string;
+    /** "Última" */
+    last?: string;
+    /** "Mostrando" */
+    showing?: string;
+    /** "de" */
+    of?: string;
+    /** "resultados" */
+    results?: string;
+    /** "Itens por página" */
+    itemsPerPage?: string;
+    /** "Página" */
+    page?: string;
+}
+/**
+ * Props for the TablePagination component
+ *
+ * @example
+ * ```tsx
+ * // With useTablePagination hook
+ * const pagination = useTablePagination(data, { pageSize: 10 });
+ *
+ * <TablePagination
+ *   currentPage={pagination.currentPage}
+ *   totalPages={pagination.totalPages}
+ *   pageSize={pagination.pageSize}
+ *   totalItems={pagination.totalItems}
+ *   onPageChange={pagination.goToPage}
+ *   onPageSizeChange={pagination.setPageSize}
+ * />
+ * ```
+ */
+interface TablePaginationProps {
+    /** Current page number (1-indexed) */
+    currentPage: number;
+    /** Total number of pages */
+    totalPages: number;
+    /** Current page size */
+    pageSize: number;
+    /** Total number of items */
+    totalItems: number;
+    /** Callback when page changes */
+    onPageChange: (page: number) => void;
+    /** Callback when page size changes */
+    onPageSizeChange?: (size: number) => void;
+    /** Available page size options */
+    pageSizeOptions?: number[];
+    /** Maximum number of visible page buttons */
+    maxVisiblePages?: number;
+    /** Show "Showing X of Y" info */
+    showInfo?: boolean;
+    /** Show page number buttons */
+    showPageNumbers?: boolean;
+    /** Show page size selector */
+    showPageSizeSelector?: boolean;
+    /** Show first/last page buttons */
+    showFirstLastButtons?: boolean;
+    /** Custom labels for i18n */
+    labels?: TablePaginationLabels;
+    /** Additional className */
+    className?: string;
+}
+/**
+ * Generate array of page numbers with ellipsis
+ */
+declare function getPageNumbers(currentPage: number, totalPages: number, maxVisible?: number): (number | "ellipsis")[];
+/**
+ * TablePagination Component
+ *
+ * A complete, ready-to-use pagination component for tables and data grids.
+ * Integrates seamlessly with the `useTablePagination` hook.
+ *
+ * @example
+ * ```tsx
+ * import { useTablePagination, TablePagination, Table, TableBody, ... } from "@iclips/ui";
+ *
+ * function MyTable({ data }) {
+ *   const pagination = useTablePagination(data, { pageSize: 10 });
+ *
+ *   return (
+ *     <>
+ *       <Table>
+ *         <TableBody>
+ *           {pagination.paginatedData.map(item => (
+ *             <TableRow key={item.id}>...</TableRow>
+ *           ))}
+ *         </TableBody>
+ *       </Table>
+ *
+ *       <TablePagination
+ *         currentPage={pagination.currentPage}
+ *         totalPages={pagination.totalPages}
+ *         pageSize={pagination.pageSize}
+ *         totalItems={pagination.totalItems}
+ *         onPageChange={pagination.goToPage}
+ *         onPageSizeChange={pagination.setPageSize}
+ *       />
+ *     </>
+ *   );
+ * }
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // Minimal usage (without page size selector)
+ * <TablePagination
+ *   currentPage={1}
+ *   totalPages={10}
+ *   pageSize={20}
+ *   totalItems={200}
+ *   onPageChange={(page) => setCurrentPage(page)}
+ *   showPageSizeSelector={false}
+ * />
+ * ```
+ */
+declare function TablePagination({ currentPage, totalPages, pageSize, totalItems, onPageChange, onPageSizeChange, pageSizeOptions, maxVisiblePages, showInfo, showPageNumbers, showPageSizeSelector, showFirstLastButtons, labels: customLabels, className, }: TablePaginationProps): react_jsx_runtime.JSX.Element | null;
+declare namespace TablePagination {
+    var displayName: string;
+}
+
+/**
+ * Utility types for DataTable implementations
+ *
+ * These types provide standard interfaces for common DataTable patterns
+ * like sorting, pagination, column definitions, and selection.
+ */
+/**
+ * Direction of sorting
+ */
+type SortDirection = "asc" | "desc" | null;
+/**
+ * Sort configuration for a table
+ *
+ * @example
+ * ```tsx
+ * const [sortConfig, setSortConfig] = useState<SortConfig<User>>({
+ *   column: "name",
+ *   direction: "asc"
+ * });
+ * ```
+ */
+interface SortConfig<T> {
+    column: keyof T | null;
+    direction: SortDirection;
+}
+/**
+ * Column definition for a DataTable
+ *
+ * @example
+ * ```tsx
+ * const columns: ColumnDef<User>[] = [
+ *   {
+ *     key: "name",
+ *     header: "Name",
+ *     sortable: true,
+ *     width: "200px"
+ *   },
+ *   {
+ *     key: "email",
+ *     header: "Email",
+ *     render: (value, row) => <a href={`mailto:${value}`}>{value}</a>
+ *   }
+ * ];
+ * ```
+ */
+interface ColumnDef<T extends Record<string, any>> {
+    /** Key of the data property to display */
+    key: keyof T;
+    /** Header label or React node */
+    header: string | React.ReactNode;
+    /** Whether this column is sortable */
+    sortable?: boolean;
+    /** Column width (CSS value) */
+    width?: string | number;
+    /** Text alignment */
+    align?: "left" | "center" | "right";
+    /** Custom render function for the cell content */
+    render?: (value: T[keyof T], row: T, index: number) => React.ReactNode;
+    /** Additional className for the cell */
+    className?: string;
+    /** Additional className for the header */
+    headerClassName?: string;
+}
+/**
+ * Pagination configuration
+ *
+ * @example
+ * ```tsx
+ * const [pagination, setPagination] = useState<PaginationConfig>({
+ *   currentPage: 1,
+ *   pageSize: 10,
+ *   totalItems: 100
+ * });
+ * ```
+ */
+interface PaginationConfig {
+    /** Current page number (1-indexed) */
+    currentPage: number;
+    /** Number of items per page */
+    pageSize: number;
+    /** Total number of items */
+    totalItems: number;
+    /** Callback when page changes */
+    onPageChange?: (page: number) => void;
+    /** Callback when page size changes */
+    onPageSizeChange?: (size: number) => void;
+}
+/**
+ * Helper to calculate pagination metadata
+ */
+interface PaginationMetadata {
+    totalPages: number;
+    startIndex: number;
+    endIndex: number;
+    hasNextPage: boolean;
+    hasPreviousPage: boolean;
+}
+/**
+ * Selection state for table rows
+ *
+ * @example
+ * ```tsx
+ * const [selection, setSelection] = useState<SelectionState>({
+ *   selectedIds: new Set(["1", "2"]),
+ *   isAllSelected: false
+ * });
+ * ```
+ */
+interface SelectionState {
+    /** Set of selected row IDs */
+    selectedIds: Set<string | number>;
+    /** Whether all rows are selected */
+    isAllSelected: boolean;
+}
+/**
+ * Complete table state with all common features
+ *
+ * @example
+ * ```tsx
+ * const [tableState, setTableState] = useState<TableState<User>>({
+ *   data: users,
+ *   sort: { column: "name", direction: "asc" },
+ *   pagination: { currentPage: 1, pageSize: 10, totalItems: 100 },
+ *   selection: { selectedIds: new Set(), isAllSelected: false }
+ * });
+ * ```
+ */
+interface TableState<T extends Record<string, any>> {
+    /** Table data */
+    data: T[];
+    /** Sort configuration */
+    sort?: SortConfig<T>;
+    /** Pagination configuration */
+    pagination?: PaginationConfig;
+    /** Selection state */
+    selection?: SelectionState;
+    /** Loading state */
+    isLoading?: boolean;
+    /** Error state */
+    error?: string | null;
+}
+/**
+ * Filter operator types
+ */
+type FilterOperator = "equals" | "contains" | "startsWith" | "endsWith" | "greaterThan" | "lessThan" | "between" | "in";
+/**
+ * Filter configuration for a column
+ *
+ * @example
+ * ```tsx
+ * const filters: FilterConfig<User>[] = [
+ *   {
+ *     column: "status",
+ *     operator: "in",
+ *     value: ["active", "pending"]
+ *   },
+ *   {
+ *     column: "age",
+ *     operator: "greaterThan",
+ *     value: 18
+ *   }
+ * ];
+ * ```
+ */
+interface FilterConfig<T> {
+    column: keyof T;
+    operator: FilterOperator;
+    value: any;
+}
+/**
+ * Configuration for draggable rows
+ */
+interface DragDropConfig {
+    /** Whether drag and drop is enabled */
+    enabled: boolean;
+    /** Callback when a row is dropped */
+    onDrop?: (dragIndex: number, dropIndex: number) => void;
+    /** Custom drag handle component */
+    dragHandle?: React.ReactNode;
+}
+/**
+ * Configuration for expandable rows
+ *
+ * @example
+ * ```tsx
+ * const expandConfig: RowExpansionConfig<User> = {
+ *   enabled: true,
+ *   expandedRows: new Set(["1", "3"]),
+ *   renderExpandedContent: (row) => (
+ *     <div>Details for {row.name}</div>
+ *   )
+ * };
+ * ```
+ */
+interface RowExpansionConfig<T extends Record<string, any>> {
+    /** Whether row expansion is enabled */
+    enabled: boolean;
+    /** Set of expanded row IDs */
+    expandedRows?: Set<string | number>;
+    /** Callback when row expansion changes */
+    onExpansionChange?: (rowId: string | number, isExpanded: boolean) => void;
+    /** Custom content to render when row is expanded */
+    renderExpandedContent?: (row: T, index: number) => React.ReactNode;
+}
+/**
+ * Sort function type
+ */
+type SortFunction<T extends Record<string, any>> = (a: T, b: T, config: SortConfig<T>) => number;
+/**
+ * Filter function type
+ */
+type FilterFunction<T extends Record<string, any>> = (row: T, filters: FilterConfig<T>[]) => boolean;
+/**
+ * Helper function to calculate pagination metadata
+ */
+declare function calculatePaginationMetadata(config: PaginationConfig): PaginationMetadata;
+
+interface FilterCondition {
+    id: string;
+    field: string;
+    operator: string;
+    value: string | string[];
+}
+interface FilterField {
+    value: string;
+    label: string;
+    type?: "text" | "number" | "select" | "date";
+    options?: {
+        value: string;
+        label: string;
+    }[];
+    multiSelect?: boolean;
+}
+interface FilterBuilderProps {
+    conditions: FilterCondition[];
+    onConditionsChange: (conditions: FilterCondition[]) => void;
+    fields: FilterField[];
+    className?: string;
+}
+declare function FilterBuilder({ conditions, onConditionsChange, fields, className, }: FilterBuilderProps): react_jsx_runtime.JSX.Element;
+
+interface DataTableProps<T extends Record<string, any>> {
+    data: T[];
+    columns: ColumnDef<T>[];
+    searchPlaceholder?: string;
+    searchableColumns?: (keyof T)[];
+    enableSearch?: boolean;
+    filterFields?: FilterField[];
+    enableFilters?: boolean;
+    pageSizeOptions?: number[];
+    initialPageSize?: number;
+    toolbarActions?: React__default.ReactNode;
+    className?: string;
+}
+declare function DataTable<T extends Record<string, any>>({ data, columns, searchPlaceholder, searchableColumns, enableSearch, filterFields, enableFilters, pageSizeOptions, initialPageSize, toolbarActions, className, }: DataTableProps<T>): react_jsx_runtime.JSX.Element;
+
+/**
+ * Example component demonstrating the enhanced DataTable with Search + Filters
+ */
+declare function DataTableExample(): react_jsx_runtime.JSX.Element;
+
+interface ActiveFilter {
+    id: string;
+    label: string;
+    value?: string;
+    onRemove?: () => void;
+}
+interface FilterBarProps {
+    activeFilters?: ActiveFilter[];
+    onClearAll?: () => void;
+    onOpenFilters?: () => void;
+    className?: string;
+    children?: React$1.ReactNode;
+}
+declare function FilterBar({ activeFilters, onClearAll, onOpenFilters, className, children, }: FilterBarProps): react_jsx_runtime.JSX.Element;
+
+interface FilterChipProps {
+    label: string;
+    value?: string;
+    onRemove?: () => void;
+    className?: string;
+}
+declare function FilterChip({ label, value, onRemove, className }: FilterChipProps): react_jsx_runtime.JSX.Element;
+
+interface SavedFilter {
+    id: string;
+    name: string;
+    description?: string;
+    isFavorite?: boolean;
+    filterCount?: number;
+}
+interface SavedFiltersProps {
+    filters?: SavedFilter[];
+    onSelectFilter?: (filterId: string) => void;
+    onToggleFavorite?: (filterId: string) => void;
+    onDeleteFilter?: (filterId: string) => void;
+    className?: string;
+}
+declare function SavedFilters({ filters, onSelectFilter, onToggleFavorite, onDeleteFilter, className, }: SavedFiltersProps): react_jsx_runtime.JSX.Element;
 
 declare function Tabs({ className, ...props }: React$1.ComponentProps<typeof TabsPrimitive.Root>): react_jsx_runtime.JSX.Element;
 declare function TabsList({ className, ...props }: React$1.ComponentProps<typeof TabsPrimitive.List>): react_jsx_runtime.JSX.Element;
@@ -734,7 +1490,7 @@ declare function Textarea({ className, ...props }: React$1.ComponentProps<"texta
 declare const toggleVariants: (props?: ({
     variant?: "default" | "outline" | null | undefined;
     size?: "default" | "sm" | "lg" | null | undefined;
-} & class_variance_authority_types.ClassProp) | undefined) => string;
+} & class_variance_authority_dist_types.ClassProp) | undefined) => string;
 declare function Toggle({ className, variant, size, ...props }: React$1.ComponentProps<typeof TogglePrimitive.Root> & VariantProps<typeof toggleVariants>): react_jsx_runtime.JSX.Element;
 
 declare function ToggleGroup({ className, variant, size, children, ...props }: React$1.ComponentProps<typeof ToggleGroupPrimitive.Root> & VariantProps<typeof toggleVariants>): react_jsx_runtime.JSX.Element;
@@ -1038,4 +1794,4 @@ interface PrintInfoGridProps {
 }
 declare function PrintInfoGrid({ items, columns, className, }: PrintInfoGridProps): react_jsx_runtime.JSX.Element;
 
-export { Accordion, AccordionContent, AccordionItem, AccordionTrigger, Alert, AlertDescription, AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogTitle, AlertDialogTrigger, AlertTitle, AppLayout, type AppLayoutProps, AspectRatio, Avatar, AvatarFallback, AvatarImage, Badge, Breadcrumb, BreadcrumbEllipsis, BreadcrumbItem, BreadcrumbLink, BreadcrumbList, BreadcrumbPage, BreadcrumbSeparator, Button, Calendar, Card, CardAction, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, Carousel, CarouselContent, CarouselItem, CarouselNext, CarouselPrevious, type ChartConfig, ChartContainer, ChartLegend, ChartLegendContent, ChartTooltip, ChartTooltipContent, Checkbox, Collapsible, CollapsibleContent, CollapsibleTrigger, ColorPicker, Command, CommandDialog, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList, CommandSeparator, CommandShortcut, ContextMenu, ContextMenuCheckboxItem, ContextMenuContent, ContextMenuGroup, ContextMenuItem, ContextMenuLabel, ContextMenuPortal, ContextMenuRadioGroup, ContextMenuRadioItem, ContextMenuSeparator, ContextMenuShortcut, ContextMenuSub, ContextMenuSubContent, ContextMenuSubTrigger, ContextMenuTrigger, ContractPrint, ContractPrintPreview, type ContractPrintProps, ContractTemplate, type DadosContrato, DateRangePicker, type DateRangePickerProps, DateTimePicker, type DateTimePickerProps, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogTitle, DialogTrigger, Drawer, DrawerClose, DrawerContent, DrawerDescription, DrawerFooter, DrawerHeader, DrawerTitle, DrawerTrigger, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, EmptyCalendarIllustration, EmptyInboxIllustration, EmptyProjectsIllustration, EmptySearchIllustration, ErrorStateIllustration, Form, FormControl, FormDescription, FormField, FormItem, FormLabel, FormMessage, HoverCard, HoverCardContent, HoverCardTrigger, type IllustrationProps, Illustrations, ImageWithFallback, Input, InputOTP, InputOTPGroup, InputOTPSeparator, InputOTPSlot, KanbanCard, type KanbanCardAssignee, type KanbanCardProps, type KanbanCardTag, Label, Menubar, MenubarCheckboxItem, MenubarContent, MenubarGroup, MenubarItem, MenubarLabel, MenubarMenu, MenubarPortal, MenubarRadioGroup, MenubarRadioItem, MenubarSeparator, MenubarShortcut, MenubarSub, MenubarSubContent, MenubarSubTrigger, MenubarTrigger, NavigationMenu, NavigationMenuContent, NavigationMenuItem, NavigationMenuLink, NavigationMenuList, NavigationMenuTrigger, Pagination, PaginationContent, PaginationEllipsis, PaginationItem, PaginationLink, PaginationNext, PaginationPrevious, Popover, PopoverContent, PopoverTrigger, type PrimaryNavItem, PrintFooter, PrintHeader, PrintInfoGrid, PrintSection, PrintSignature, PrintTable, Progress, type ProposalData, ProposalTemplate, RadioGroup, RadioGroupItem, ResizableHandle, ResizablePanel, ResizablePanelGroup, ScrollArea, ScrollBar, type SecondaryNavItem, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectSeparator, SelectTrigger, SelectValue, Separator, Sheet, SheetClose, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetTitle, SheetTrigger, Sidebar, SidebarContent, SidebarFooter, SidebarGroup, SidebarGroupAction, SidebarGroupContent, SidebarGroupLabel, SidebarHeader, SidebarInset, SidebarMenu, SidebarMenuAction, SidebarMenuBadge, SidebarMenuButton, SidebarMenuItem, SidebarMenuSkeleton, SidebarMenuSub, SidebarMenuSubButton, SidebarMenuSubItem, SidebarProvider, SidebarRail, SidebarSeparator, SidebarTrigger, Skeleton, Slider, Toaster as Sonner, SuccessStateIllustration, Switch, Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, TableRow, Tabs, TabsContent, TabsList, TabsTrigger, Textarea, TimePicker, type TimePickerProps, Toggle, ToggleGroup, ToggleGroupItem, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, UnderlineTabs, UnderlineTabsContent, UnderlineTabsList, UnderlineTabsTrigger, type UsePrintContractOptions, badgeVariants, buttonVariants, cn, dadosContratoExemplo, navigationMenuTriggerStyle, toggleVariants, useFormField, useIsMobile, usePrintContract, useSidebar };
+export { Accordion, AccordionContent, AccordionItem, AccordionTrigger, type ActiveFilter, Alert, AlertDescription, AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogTitle, AlertDialogTrigger, AlertTitle, AppLayout, type AppLayoutProps, AspectRatio, Avatar, AvatarFallback, AvatarImage, Badge, Breadcrumb, BreadcrumbEllipsis, BreadcrumbItem, BreadcrumbLink, BreadcrumbList, BreadcrumbPage, BreadcrumbSeparator, Button, Calendar, type CalendarProps, Card, CardAction, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, Carousel, CarouselContent, CarouselItem, CarouselNext, CarouselPrevious, type ChartConfig, ChartContainer, ChartLegend, ChartLegendContent, ChartTooltip, ChartTooltipContent, Checkbox, Collapsible, CollapsibleContent, CollapsibleTrigger, ColorPicker, type ColumnDef, Command, CommandDialog, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList, CommandSeparator, CommandShortcut, ContextMenu, ContextMenuCheckboxItem, ContextMenuContent, ContextMenuGroup, ContextMenuItem, ContextMenuLabel, ContextMenuPortal, ContextMenuRadioGroup, ContextMenuRadioItem, ContextMenuSeparator, ContextMenuShortcut, ContextMenuSub, ContextMenuSubContent, ContextMenuSubTrigger, ContextMenuTrigger, ContractPrint, ContractPrintPreview, type ContractPrintProps, ContractTemplate, type DadosContrato, DataTable, DataTableExample, DatePicker, type DatePickerProps, DateRangePicker, type DateRangePickerProps, type DateRangePreset, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogTitle, DialogTrigger, type DragDropConfig, Drawer, DrawerClose, DrawerContent, DrawerDescription, DrawerFooter, DrawerHeader, DrawerTitle, DrawerTrigger, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, EmptyCalendarIllustration, EmptyInboxIllustration, EmptyProjectsIllustration, EmptySearchIllustration, ErrorStateIllustration, FilterBar, type FilterBarProps, FilterBuilder, type FilterBuilderProps, FilterChip, type FilterChipProps, type FilterCondition, type FilterConfig, type FilterField, type FilterFunction, type FilterOperator, Form, FormControl, FormDescription, FormField, FormItem, FormLabel, FormMessage, HoverCard, HoverCardContent, HoverCardTrigger, type IllustrationProps, Illustrations, ImageWithFallback, Input, InputOTP, InputOTPGroup, InputOTPSeparator, InputOTPSlot, KanbanCard, type KanbanCardAssignee, type KanbanCardProps, type KanbanCardTag, Label, Menubar, MenubarCheckboxItem, MenubarContent, MenubarGroup, MenubarItem, MenubarLabel, MenubarMenu, MenubarPortal, MenubarRadioGroup, MenubarRadioItem, MenubarSeparator, MenubarShortcut, MenubarSub, MenubarSubContent, MenubarSubTrigger, MenubarTrigger, NavigationMenu, NavigationMenuContent, NavigationMenuItem, NavigationMenuLink, NavigationMenuList, NavigationMenuTrigger, Pagination, type PaginationConfig, PaginationContent, PaginationEllipsis, PaginationItem, PaginationLink, type PaginationMetadata, PaginationNext, PaginationPrevious, Popover, PopoverContent, PopoverTrigger, type PrimaryNavItem, PrintFooter, PrintHeader, PrintInfoGrid, PrintSection, PrintSignature, PrintTable, Progress, type ProposalData, ProposalTemplate, RadioGroup, RadioGroupItem, ResizableHandle, ResizablePanel, ResizablePanelGroup, type RowExpansionConfig, type SavedFilter, SavedFilters, type SavedFiltersProps, ScrollArea, ScrollBar, type SecondaryNavItem, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectSeparator, SelectTrigger, SelectValue, type SelectionState, Separator, Sheet, SheetClose, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetTitle, SheetTrigger, Sidebar, SidebarContent, SidebarFooter, SidebarGroup, SidebarGroupAction, SidebarGroupContent, SidebarGroupLabel, SidebarHeader, SidebarInset, SidebarMenu, SidebarMenuAction, SidebarMenuBadge, SidebarMenuButton, SidebarMenuItem, SidebarMenuSkeleton, SidebarMenuSub, SidebarMenuSubButton, SidebarMenuSubItem, SidebarProvider, SidebarRail, SidebarSeparator, SidebarTrigger, Skeleton, Slider, Toaster as Sonner, type SortConfig, type SortDirection, type SortFunction, SuccessStateIllustration, Switch, Table, TableBody, type TableBodyProps, TableCaption, type TableCaptionProps, TableCell, type TableCellProps, TableFooter, type TableFooterProps, TableHead, type TableHeadProps, TableHeader, type TableHeaderProps, TablePagination, type TablePaginationLabels, type TablePaginationProps, type TableProps, TableRow, type TableRowProps, type TableState, Tabs, TabsContent, TabsList, TabsTrigger, Textarea, TimePicker, type TimePickerProps, Toggle, ToggleGroup, ToggleGroupItem, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, UnderlineTabs, UnderlineTabsContent, UnderlineTabsList, UnderlineTabsTrigger, type UsePrintContractOptions, badgeVariants, buttonVariants, calculatePaginationMetadata, cn, dadosContratoExemplo, getPageNumbers, navigationMenuTriggerStyle, toggleVariants, useFormField, useIsMobile, usePrintContract, useSidebar };