better-table 1.2.0 → 1.3.0

package/dist/components/BetterTable/hooks/useColumnResize.d.ts

@@ -0,0 +1,23 @@
+import { Column, TableData } from '../types';
+interface UseColumnResizeOptions<T extends TableData> {
+    columns: Column<T>[];
+    enabled: boolean;
+    minWidth?: number;
+    maxWidth?: number;
+    onColumnResize?: (columnId: string, width: number) => void;
+    tableRef: React.RefObject<HTMLTableElement | null>;
+}
+interface UseColumnResizeReturn {
+    /** Current column widths (only populated for resized columns) */
+    columnWidths: Record<string, number>;
+    /** Whether a resize is currently in progress */
+    isResizing: boolean;
+    /** Start resizing a column */
+    startResize: (columnId: string, startX: number) => void;
+    /** Get effective width for a column (resized width or initial width) */
+    getColumnWidth: (columnId: string) => number | undefined;
+    /** Reset all column widths to initial */
+    resetColumnWidths: () => void;
+}
+export declare function useColumnResize<T extends TableData>({ columns, enabled, minWidth, maxWidth, onColumnResize, tableRef, }: UseColumnResizeOptions<T>): UseColumnResizeReturn;
+export {};

package/dist/components/BetterTable/hooks/useExpandableRows.d.ts

@@ -0,0 +1,19 @@
+export interface UseExpandableRowsOptions {
+    /** Controlled expanded row keys */
+    controlledExpandedRows?: string[];
+    /** Callback when expanded rows change */
+    onExpandChange?: (expandedRows: string[]) => void;
+    /** Only allow one row expanded at a time */
+    accordion?: boolean;
+}
+export interface UseExpandableRowsReturn {
+    /** Set of currently expanded row keys */
+    expandedRowKeys: Set<string>;
+    /** Check if a row is expanded */
+    isExpanded: (rowKey: string) => boolean;
+    /** Toggle a row's expanded state */
+    toggleExpand: (rowKey: string) => void;
+    /** Collapse all rows */
+    collapseAll: () => void;
+}
+export declare function useExpandableRows({ controlledExpandedRows, onExpandChange, accordion, }: UseExpandableRowsOptions): UseExpandableRowsReturn;

package/dist/components/BetterTable/hooks/useFocusTrap.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Traps focus within a container element while active.
+ * On activate: stores previously focused element and focuses first focusable child.
+ * On deactivate: restores focus to the previously focused element.
+ */
+export declare function useFocusTrap(containerRef: React.RefObject<HTMLElement | null>, isActive: boolean): void;

package/dist/components/BetterTable/hooks/useTableFilter.d.ts

@@ -5,6 +5,8 @@ interface UseTableFilterOptions<T extends TableData> {
     initialFilters?: FilterState;
     controlledFilters?: FilterState;
     onFilterChange?: (filters: FilterState) => void;
+    /** When true, skip client-side filtering — data is returned as-is */
+    manual?: boolean;
 }
 interface UseTableFilterReturn<T extends TableData> {
     filteredData: T[];
@@ -13,5 +15,5 @@ interface UseTableFilterReturn<T extends TableData> {
     clearFilters: () => void;
     clearFilter: (columnId: string) => void;
 }
-export declare function useTableFilter<T extends TableData>({ data, columns, initialFilters, controlledFilters, onFilterChange, }: UseTableFilterOptions<T>): UseTableFilterReturn<T>;
+export declare function useTableFilter<T extends TableData>({ data, columns, initialFilters, controlledFilters, onFilterChange, manual, }: UseTableFilterOptions<T>): UseTableFilterReturn<T>;
 export {};

package/dist/components/BetterTable/hooks/useTablePagination.d.ts

@@ -3,6 +3,8 @@ interface UseTablePaginationOptions<T extends TableData> {
     data: T[];
     config?: PaginationConfig | false;
     onPageChange?: (page: number, pageSize: number) => void;
+    /** When true, skip client-side pagination — data represents the current page from the server */
+    manual?: boolean;
 }
 interface UseTablePaginationReturn<T extends TableData> {
     paginatedData: T[];
@@ -19,5 +21,5 @@ interface UseTablePaginationReturn<T extends TableData> {
     startIndex: number;
     endIndex: number;
 }
-export declare function useTablePagination<T extends TableData>({ data, config, onPageChange, }: UseTablePaginationOptions<T>): UseTablePaginationReturn<T>;
+export declare function useTablePagination<T extends TableData>({ data, config, onPageChange, manual, }: UseTablePaginationOptions<T>): UseTablePaginationReturn<T>;
 export {};

package/dist/components/BetterTable/hooks/useTableSearch.d.ts

@@ -7,6 +7,8 @@ interface UseTableSearchOptions<T extends TableData> {
     controlledValue?: string;
     onSearchChange?: (value: string) => void;
     debounceMs?: number;
+    /** When true, skip client-side search — data is returned as-is */
+    manual?: boolean;
 }
 interface UseTableSearchReturn<T extends TableData> {
     searchedData: T[];
@@ -14,5 +16,5 @@ interface UseTableSearchReturn<T extends TableData> {
     handleSearch: (value: string) => void;
     clearSearch: () => void;
 }
-export declare function useTableSearch<T extends TableData>({ data, columns, searchColumns, initialValue, controlledValue, onSearchChange, debounceMs, }: UseTableSearchOptions<T>): UseTableSearchReturn<T>;
+export declare function useTableSearch<T extends TableData>({ data, columns, searchColumns, initialValue, controlledValue, onSearchChange, debounceMs, manual, }: UseTableSearchOptions<T>): UseTableSearchReturn<T>;
 export {};

package/dist/components/BetterTable/hooks/useTableSort.d.ts

@@ -10,6 +10,8 @@ interface UseTableSortOptions<T extends TableData> {
     controlledMultiSort?: MultiSortState;
     /** Callback when multi-sort changes */
     onMultiSortChange?: (sorts: MultiSortState) => void;
+    /** When true, skip client-side sorting — data is returned as-is */
+    manual?: boolean;
 }
 interface UseTableSortReturn<T extends TableData> {
     sortedData: T[];
@@ -21,5 +23,5 @@ interface UseTableSortReturn<T extends TableData> {
     /** Whether multi-sort is enabled */
     isMultiSort: boolean;
 }
-export declare function useTableSort<T extends TableData>({ data, initialSort, controlledSort, onSortChange, multiSort, controlledMultiSort, onMultiSortChange, }: UseTableSortOptions<T>): UseTableSortReturn<T>;
+export declare function useTableSort<T extends TableData>({ data, initialSort, controlledSort, onSortChange, multiSort, controlledMultiSort, onMultiSortChange, manual, }: UseTableSortOptions<T>): UseTableSortReturn<T>;
 export {};

package/dist/components/BetterTable/hooks/useVirtualization.d.ts

@@ -0,0 +1,25 @@
+import { RefObject } from 'react';
+interface UseVirtualizationOptions {
+    /** Ref to the scrollable container */
+    containerRef: RefObject<HTMLElement | null>;
+    /** Total number of items */
+    itemCount: number;
+    /** Fixed height per row in pixels */
+    rowHeight: number;
+    /** Extra rows to render above/below the viewport */
+    buffer: number;
+    /** Whether virtualization is active */
+    enabled: boolean;
+}
+interface UseVirtualizationResult {
+    /** Total height of the virtualized content (px) */
+    totalHeight: number;
+    /** Index of the first row to render */
+    startIndex: number;
+    /** Index of the last row to render (exclusive) */
+    endIndex: number;
+    /** Top offset for the first rendered row (px) */
+    offsetTop: number;
+}
+export declare function useVirtualization({ containerRef, itemCount, rowHeight, buffer, enabled, }: UseVirtualizationOptions): UseVirtualizationResult;
+export {};

package/dist/components/BetterTable/index.d.ts

@@ -7,8 +7,8 @@ export { useTablePagination } from './hooks/useTablePagination';
 export { useTableSelection } from './hooks/useTableSelection';
 export { useTableSearch } from './hooks/useTableSearch';
 export { useColumnVisibility } from './hooks/useColumnVisibility';
-export { useTableContext, TableProvider } from './context';
-export type { TableContextValue } from './context';
+export { TableProvider, useTableData, useTableSortContext, useTableFilterContext, useTableSelectionContext, useTablePaginationContext, useTableUI, } from './context';
+export type { TableProviderProps, TableDataContextValue, TableSortContextValue, TableFilterContextValue, TableSelectionContextValue, TablePaginationContextValue, TableUIContextValue, } from './context';
 export { getValueFromPath } from './utils/getValueFromPath';
 export { sortData } from './utils/sortData';
 export { filterData, searchData } from './utils/filterData';

package/dist/components/BetterTable/types.d.ts

@@ -26,6 +26,12 @@ export interface Column<T extends TableData = TableData> {
     filterable?: boolean;
     /** Ancho de columna */
     width?: string | number;
+    /** Ancho mínimo de columna en px (default: 50) */
+    minWidth?: number;
+    /** Ancho máximo de columna en px */
+    maxWidth?: number;
+    /** Whether this column can be resized (default: inherits from table-level resizable) */
+    resizable?: boolean;
     /** Alineación del contenido */
     align?: "left" | "center" | "right";
     /** Columna oculta */
@@ -93,6 +99,15 @@ export interface PaginationConfig {
     /** Mostrar salto a página */
     showQuickJumper?: boolean;
 }
+/**
+ * Configuration for expandable rows
+ */
+export interface ExpandableConfig<T extends TableData = TableData> {
+    /** Render function for the expanded row content */
+    render: (row: T, rowIndex: number) => ReactNode;
+    /** Whether only one row can be expanded at a time (default: false) */
+    accordion?: boolean;
+}
 /**
  * Estado de ordenamiento
  */
@@ -172,6 +187,13 @@ export interface TableLocale {
     hideColumn?: string;
     sortPriority?: string;
     clearSort?: string;
+    /** aria-live announcements */
+    resultsFound?: string;
+    noResultsFound?: string;
+    rowsSelected?: string;
+    /** Expandable rows */
+    expandRow?: string;
+    collapseRow?: string;
 }
 /**
  * Locale por defecto (Inglés)
@@ -213,6 +235,11 @@ export declare const locales: {
         hideColumn: string;
         sortPriority: string;
         clearSort: string;
+        resultsFound: string;
+        noResultsFound: string;
+        rowsSelected: string;
+        expandRow: string;
+        collapseRow: string;
     };
     readonly pt: {
         search: string;
@@ -245,6 +272,11 @@ export declare const locales: {
         hideColumn: string;
         sortPriority: string;
         clearSort: string;
+        resultsFound: string;
+        noResultsFound: string;
+        rowsSelected: string;
+        expandRow: string;
+        collapseRow: string;
     };
 };
 /** Claves de locales predefinidos */
@@ -295,6 +327,12 @@ export interface BetterTableProps<T extends TableData = TableData> {
     searchColumns?: string[];
     /** Milisegundos de debounce en la búsqueda (default: 300) */
     searchDebounceMs?: number;
+    /** Skip client-side sorting — data is assumed pre-sorted by the server (default: false) */
+    manualSorting?: boolean;
+    /** Skip client-side filtering and search — data is assumed pre-filtered by the server (default: false) */
+    manualFiltering?: boolean;
+    /** Skip client-side pagination — data represents the current page from the server (default: false) */
+    manualPagination?: boolean;
     /** Habilitar selección de filas */
     selectable?: boolean;
     /** Filas seleccionadas (controlado) */
@@ -340,6 +378,14 @@ export interface BetterTableProps<T extends TableData = TableData> {
     hoverable?: boolean;
     /** Tamaño de la tabla */
     size?: "small" | "medium" | "large";
+    /** Enable column resizing via drag (default: false) */
+    resizable?: boolean;
+    /** Callback when a column is resized */
+    onColumnResize?: (columnId: string, width: number) => void;
+    /** Minimum column width in px when resizing (default: 50) */
+    minColumnWidth?: number;
+    /** Maximum column width in px when resizing */
+    maxColumnWidth?: number;
     /** Callback al hacer click en una fila */
     onRowClick?: (row: T, rowIndex: number) => void;
     /** Callback al hacer doble click en una fila */
@@ -348,4 +394,16 @@ export interface BetterTableProps<T extends TableData = TableData> {
     ariaLabel?: string;
     /** ID del elemento que describe la tabla */
     ariaDescribedBy?: string;
+    /** Configuration for expandable rows (render function for expanded content) */
+    expandable?: ExpandableConfig<T>;
+    /** Array of expanded row keys (controlled mode) */
+    expandedRows?: string[];
+    /** Callback when expanded rows change */
+    onExpandChange?: (expandedRows: string[]) => void;
+    /** Force-enable virtualization (auto-enabled when pagination is off and dataset > VIRTUALIZATION_THRESHOLD) */
+    virtualize?: boolean;
+    /** Fixed row height in px for virtualized rendering (default: 48) */
+    rowHeight?: number;
+    /** Extra rows rendered above/below the viewport as scroll buffer (default: 5) */
+    virtualBuffer?: number;
 }

package/dist/index.d.ts

@@ -1,20 +1,20 @@
 /**
- * @juanb/better-table
+ * better-table
  * A modern, flexible, and fully typed React data table component
  *
  * @packageDocumentation
  */
 export { BetterTable } from './components/BetterTable';
 export { defaultLocale, locales } from './components/BetterTable/types';
-export type { BetterTableProps, Column, RowAction, GlobalAction, PaginationConfig, SortState, MultiSortState, FilterState, DateFilterRange, TableClassNames, TableLocale, TableData, LocaleKey, } from './components/BetterTable/types';
+export type { BetterTableProps, Column, RowAction, GlobalAction, ExpandableConfig, PaginationConfig, SortState, MultiSortState, FilterState, DateFilterRange, TableClassNames, TableLocale, TableData, LocaleKey, } from './components/BetterTable/types';
 export { useTableSort } from './components/BetterTable/hooks/useTableSort';
 export { useTableFilter } from './components/BetterTable/hooks/useTableFilter';
 export { useTablePagination } from './components/BetterTable/hooks/useTablePagination';
 export { useTableSelection } from './components/BetterTable/hooks/useTableSelection';
 export { useTableSearch } from './components/BetterTable/hooks/useTableSearch';
 export { useColumnVisibility } from './components/BetterTable/hooks/useColumnVisibility';
-export { useTableContext, TableProvider, } from './components/BetterTable/context';
-export type { TableContextValue } from './components/BetterTable/context';
+export { TableProvider, useTableData, useTableSortContext, useTableFilterContext, useTableSelectionContext, useTablePaginationContext, useTableUI, } from './components/BetterTable/context';
+export type { TableProviderProps, TableDataContextValue, TableSortContextValue, TableFilterContextValue, TableSelectionContextValue, TablePaginationContextValue, TableUIContextValue, } from './components/BetterTable/context';
 export { getValueFromPath } from './components/BetterTable/utils/getValueFromPath';
 export { sortData } from './components/BetterTable/utils/sortData';
 export { filterData, searchData, } from './components/BetterTable/utils/filterData';

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "better-table",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "A modern, flexible, and fully typed React data table component",
-  "author": "Juan Puca",
+  "author": "jrodrigopuca",
   "license": "Apache-2.0",
   "type": "module",
   "main": "./dist/better-table.cjs.js",
@@ -41,6 +41,12 @@
     "pagination",
     "selection",
     "column-visibility",
+    "column-resize",
+    "expandable-rows",
+    "virtualization",
+    "sticky-header",
+    "server-side",
+    "accessible",
     "responsive",
     "i18n"
   ],
@@ -77,17 +83,6 @@
     "vite-plugin-dts": "^4.5.0",
     "vitest": "^4.0.18"
   },
-  "scripts": {
-    "dev": "vite --config demo/vite.config.ts",
-    "build": "vite build",
-    "build:types": "tsc -p tsconfig.build.json",
-    "preview": "vite preview",
-    "test": "vitest --config vitest.config.ts",
-    "test:run": "vitest run --config vitest.config.ts",
-    "test:coverage": "vitest run --coverage --config vitest.config.ts",
-    "lint": "tsc --noEmit",
-    "prepublishOnly": "npm run build"
-  },
   "browserslist": {
     "production": [
       ">0.2%",
@@ -99,5 +94,15 @@
       "last 1 firefox version",
       "last 1 safari version"
     ]
+  },
+  "scripts": {
+    "dev": "vite --config demo/vite.config.ts",
+    "build": "vite build",
+    "build:types": "tsc -p tsconfig.build.json",
+    "preview": "vite preview",
+    "test": "vitest --config vitest.config.ts",
+    "test:run": "vitest run --config vitest.config.ts",
+    "test:coverage": "vitest run --coverage --config vitest.config.ts",
+    "lint": "tsc --noEmit"
   }
-}
+}