@zvndev/yable-react 0.1.1 → 0.3.0

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { Table as Table$1, RowData, Cell, Header, Row, TableOptions, ColumnDef, SortDirection, CellContext, ClipboardOptions, CellFlashInfo } from '@zvndev/yable-core';
-export { AccessorFnColumnDef, AccessorKeyColumnDef, AggregationFn, Cell, CellStatus as CellCommitStatus, CellContext, CellFlashEvent, CellPatch, ClipboardOptions, Column, ColumnDef, ColumnDefBase, ColumnFiltersState, ColumnMeta, ColumnOrderState, ColumnPinningState, ColumnSizingInfoState, ColumnSizingState, CommitError, CommitErrorCells, CommitRecord, CommitResult, CommitsSlice, DisplayColumnDef, EditingState, ExpandedState, FillHandleState, FilterFn, FormulaState, GroupColumnDef, Header, HeaderContext, HeaderGroup, KeyboardNavigationAction, KeyboardNavigationCell, KeyboardNavigationDirection, KeyboardNavigationState, OnChangeFn, OnCommitFn, PaginationState, PartialLocale, PivotConfig, PivotState, Row, RowData, RowDragEndEvent, RowDragEvent, RowDragState, RowEditCommitEvent, RowEditEvent, RowPinningState, RowReorderEvent, RowSelectionState, SortDirection, SortingFn, SortingState, Table as TableInstance, TableOptions, TableOptionsResolved, TableState, UndoAction, UndoRedoState, Updater, VisibilityState, YableLocale, aggregationFns, createColumnHelper, createLocale, en, filterFns, functionalUpdate, getDefaultLocale, resetLocale, setDefaultLocale, sortingFns } from '@zvndev/yable-core';
+import { Table as Table$1, RowData, Cell, Header, Row, TableOptions, Column, ColumnDef, SortDirection, CellContext, ClipboardOptions, CellFlashInfo } from '@zvndev/yable-core';
+export { AccessorFnColumnDef, AccessorKeyColumnDef, AggregationFn, Cell, CellStatus as CellCommitStatus, CellContext, CellFlashEvent, CellPatch, ClipboardOptions, Column, ColumnDef, ColumnDefBase, ColumnFiltersState, ColumnMeta, ColumnOrderState, ColumnPinningState, ColumnSizingInfoState, ColumnSizingState, CommitError, CommitErrorCells, CommitRecord, CommitResult, CommitsSlice, DisplayColumnDef, EditingState, ExpandedState, FillHandleState, FilterFn, FormulaEngine, FormulaError, FormulaFunction, FormulaState, GroupColumnDef, Header, HeaderContext, HeaderGroup, KeyboardNavigationAction, KeyboardNavigationCell, KeyboardNavigationDirection, KeyboardNavigationState, OnChangeFn, OnCommitFn, PaginationState, PartialLocale, PivotColumn, PivotConfig, PivotEngine, PivotFieldConfig, PivotRow, PivotState, PivotValueConfig, Row, RowData, RowDragEndEvent, RowDragEvent, RowDragState, RowEditCommitEvent, RowEditEvent, RowPinningState, RowReorderEvent, RowSelectionState, SortDirection, SortingFn, SortingState, Table as TableInstance, TableOptions, TableOptionsResolved, TableState, UndoAction, UndoRedoOptions, UndoRedoState, UndoStack, Updater, VisibilityState, YableLocale, aggregationFns, createColumnHelper, createLocale, createUndoRedoIntegration, en, filterFns, formulaFunctions, functionalUpdate, generatePivotColumnDefs, getDefaultLocale, getInitialPivotState, getPivotRowModel, resetLocale, setDefaultLocale, sortingFns } from '@zvndev/yable-core';
 import * as React$1 from 'react';
 import React__default, { HTMLAttributes, TdHTMLAttributes, ThHTMLAttributes } from 'react';
 import * as react_jsx_runtime from 'react/jsx-runtime';
@@ -53,6 +53,14 @@ interface TableProps<TData extends RowData> extends Omit<HTMLAttributes<HTMLDivE
     sidebarPanels?: ('columns' | 'filters')[];
     /** Default sidebar panel */
     defaultSidebarPanel?: 'columns' | 'filters';
+    /** Render a second header row with per-column floating filters */
+    floatingFilters?: boolean;
+    /** Virtualize wide tables horizontally when safe to do so */
+    columnVirtualization?: boolean;
+    /** Additional columns rendered beyond the viewport when column virtualization is enabled */
+    columnVirtualizationOverscan?: number;
+    /** Accessible label for the grid container. Default: "Data table" */
+    ariaLabel?: string;
 }
 /** Status bar panel configuration */
 interface StatusBarPanelConfig {
@@ -75,6 +83,20 @@ interface TableHeaderCellProps<TData extends RowData, TValue = unknown> extends
     header: Header<TData, TValue>;
 }
 
+/**
+ * React hook that wraps the framework-agnostic core table engine.
+ *
+ * Returns a stable {@link Table} instance whose `state` reflects either
+ * the consumer's controlled `options.state` or the hook's internal state.
+ *
+ * Re-renders are triggered by `setState` from the default `onStateChange`
+ * implementation. Consumers may pass their own `onStateChange` to control
+ * state externally.
+ *
+ * Gotcha: `options.onStateChange` is captured via a latest-ref, so a fresh
+ * function identity from the parent is always invoked — even if every other
+ * option key is shallow-equal to the previous render.
+ */
 declare function useTable<TData extends RowData>(options: TableOptions<TData>): Table$1<TData>;
 
 interface VirtualRow {
@@ -104,10 +126,40 @@ interface UseVirtualizationResult {
  * Computes which rows are visible in a scrollable container and returns
  * positioning data so only those rows (plus an overscan buffer) are rendered.
  *
- * Supports both fixed and variable row heights.
+ * Returns `{ virtualRows, totalHeight, startIndex, endIndex, scrollTo }`.
+ * Re-renders are triggered by scroll (rAF-throttled) and ResizeObserver
+ * container resize. Supports fixed, variable, and Pretext-pre-measured heights.
+ *
+ * Gotcha: variable-height mode caches measured heights per index — pass new
+ * `pretextHeights` arrays (or change `totalRows`) to invalidate the cache.
  */
 declare function useVirtualization({ containerRef, totalRows, rowHeight, overscan, estimateRowHeight: _estimateRowHeight, pretextHeights, pretextPrefixSums, }: UseVirtualizationOptions): UseVirtualizationResult;
 
+interface VirtualColumn<TData extends RowData> {
+    column: Column<TData, unknown>;
+    index: number;
+    start: number;
+    size: number;
+}
+interface UseColumnVirtualizationOptions<TData extends RowData> {
+    containerRef: React.RefObject<HTMLElement | null>;
+    columns: Column<TData, unknown>[];
+    overscan?: number;
+    enabled?: boolean;
+}
+interface UseColumnVirtualizationResult<TData extends RowData> {
+    virtualColumns: VirtualColumn<TData>[];
+    startOffset: number;
+    endOffset: number;
+    totalWidth: number;
+    visibleWidth: number;
+    startIndex: number;
+    endIndex: number;
+    isVirtualized: boolean;
+    scrollToIndex: (index: number) => void;
+}
+declare function useColumnVirtualization<TData extends RowData>({ containerRef, columns, overscan, enabled, }: UseColumnVirtualizationOptions<TData>): UseColumnVirtualizationResult<TData>;
+
 interface CellMeasurement {
     /** Column ID */
     columnId: string;
@@ -154,11 +206,15 @@ interface UsePretextMeasurementResult {
 }
 /**
  * Pre-computes exact pixel heights for every row using Pretext's
- * DOM-free text measurement. Returns typed arrays for cache-friendly
- * access by the virtualizer.
+ * DOM-free text measurement.
  *
- * layout() is pure arithmetic (~0.0003ms per cell) so column resizing
- * re-computes all heights near-instantly.
+ * Returns `{ rowHeights, prefixSums, totalHeight, ready, ... }` as typed
+ * arrays for cache-friendly access by the virtualizer. `prepare()` re-runs
+ * when `data` or fonts change; `layout()` re-runs only when column widths
+ * change (pure math, ~0.0003ms per cell).
+ *
+ * Gotcha: pretext is loaded lazily — `ready` flips to true on the first
+ * render after the dynamic import resolves and heights are computed.
  */
 declare function usePretextMeasurement({ data, columns, getCellText, minRowHeight, enabled, }: UsePretextMeasurementOptions): UsePretextMeasurementResult;
 
@@ -337,18 +393,19 @@ declare function getRegisteredCellTypes(): readonly string[];
 declare const TableProvider: React$1.Provider<Table$1<any> | null>;
 declare function useTableContext<TData extends RowData>(): Table$1<TData>;
 
-declare function Table<TData extends RowData>({ table, stickyHeader, striped, bordered, compact, theme, clickableRows, footer, loading, loadingComponent, loadingText, emptyMessage, emptyComponent, emptyIcon, emptyDetail, renderEmpty, renderLoading, children, className, direction, statusBar, statusBarPanels, sidebar, sidebarPanels, defaultSidebarPanel, ...rest }: TableProps<TData>): react_jsx_runtime.JSX.Element;
+declare function Table<TData extends RowData>({ table, stickyHeader, striped, bordered, compact, theme, clickableRows, footer, loading, loadingComponent, loadingText, emptyMessage, emptyComponent, emptyIcon, emptyDetail, renderEmpty, renderLoading, children, className, direction, statusBar, statusBarPanels, sidebar, sidebarPanels, defaultSidebarPanel, floatingFilters, columnVirtualization, columnVirtualizationOverscan, ariaLabel, ...rest }: TableProps<TData>): react_jsx_runtime.JSX.Element;
 
 interface TableHeaderProps<TData extends RowData> {
     table: Table$1<TData>;
+    floatingFilters?: boolean;
 }
-declare function TableHeader<TData extends RowData>({ table, }: TableHeaderProps<TData>): react_jsx_runtime.JSX.Element;
+declare function TableHeader<TData extends RowData>({ table, floatingFilters, }: TableHeaderProps<TData>): react_jsx_runtime.JSX.Element;
 
 interface TableBodyProps<TData extends RowData> {
     table: Table$1<TData>;
     clickableRows?: boolean;
 }
-declare function TableBody<TData extends RowData>({ table, clickableRows, }: TableBodyProps<TData>): react_jsx_runtime.JSX.Element;
+declare function TableBody<TData extends RowData>({ table, clickableRows }: TableBodyProps<TData>): react_jsx_runtime.JSX.Element;
 
 interface TableCellProps<TData extends RowData> {
     cell: Cell<TData, unknown>;
@@ -363,7 +420,7 @@ declare function TableCell<TData extends RowData>({ cell, table, rowIndex, colum
 interface TableFooterProps<TData extends RowData> {
     table: Table$1<TData>;
 }
-declare function TableFooter<TData extends RowData>({ table, }: TableFooterProps<TData>): react_jsx_runtime.JSX.Element | null;
+declare function TableFooter<TData extends RowData>({ table }: TableFooterProps<TData>): react_jsx_runtime.JSX.Element | null;
 
 interface PaginationProps<TData extends RowData> {
     table: Table$1<TData>;
@@ -389,6 +446,17 @@ interface GlobalFilterProps<TData extends RowData> {
 }
 declare function GlobalFilter<TData extends RowData>({ table, placeholder, debounce, className, }: GlobalFilterProps<TData>): react_jsx_runtime.JSX.Element;
 
+interface FloatingFilterProps<TData extends RowData> {
+    column: Column<TData, unknown>;
+}
+declare function FloatingFilter<TData extends RowData>({ column }: FloatingFilterProps<TData>): react_jsx_runtime.JSX.Element;
+
+interface SetFilterProps<TData extends RowData> {
+    column: Column<TData, unknown>;
+    className?: string;
+}
+declare function SetFilter<TData extends RowData>({ column, className }: SetFilterProps<TData>): react_jsx_runtime.JSX.Element;
+
 interface SortIndicatorProps {
     direction: SortDirection | false;
     index?: number;
@@ -933,7 +1001,7 @@ interface UsePrintLayoutOptions {
      */
     additionalCSS?: string;
 }
-declare function usePrintLayout<TData extends RowData>(table: Table$1<TData>, options?: UsePrintLayoutOptions): {
+declare function usePrintLayout<TData extends RowData>(_table: Table$1<TData>, options?: UsePrintLayoutOptions): {
     preparePrint: () => void;
     isPrinting: boolean;
 };
@@ -954,4 +1022,4 @@ declare function useTheme(options?: UseThemeOptions): {
     containerRef: React$1.RefObject<HTMLElement | null>;
 };
 
-export { type AutoMeasurementsOptions, CellBadge, type CellBadgeProps, CellBoolean, type CellBooleanProps, CellCheckbox, CellCurrency, type CellCurrencyProps, CellDate, CellDatePicker, type CellDateProps, CellErrorBoundary, CellInput, CellLink, type CellLinkProps, type CellMeasureRecipe, type CellMeasurement, CellNumeric, type CellNumericProps, CellProgress, type CellProgressProps, CellRating, type CellRatingProps, CellSelect, CellStatus, CellStatusBadge, type CellStatusBadgeProps, type CellStatusProps, CellToggle, ColumnsPanel, ContextMenu, ContextMenuItem, type ContextMenuItemDef, DEFAULT_TEXT_RECIPE, DragHandle, ErrorBoundary, ExpandIcon, FillHandle, type FillHandleDragState, type FillHandleProps, FiltersPanel, FlashCell, GlobalFilter, LoadingOverlay, type LoadingOverlayProps, MasterDetail, NoRowsOverlay, type NoRowsOverlayProps, Pagination, PivotConfigPanel, type PivotConfigProps, type PivotFieldItem, type PivotValueItem, PrintLayout, Sidebar, SortIndicator, StatusBar, StatusBarPanelComponent, type StatusBarPanelComponentProps, type StatusBarPanelConfig, type StatusBarPanelProps, Table, TableBody, TableCell, type TableCellProps$1 as TableCellProps, TableFooter, TableHeader, type TableHeaderCellProps, type TableProps, TableProvider, type TableRowProps, Tooltip, type TooltipPosition, type TooltipProps, TreeToggle, type UseCellFlashOptions, type UseClipboardOptions, type UseFillHandleOptions, type UseFillHandleReturn, type UseKeyboardNavigationOptions, type UsePretextMeasurementOptions, type UsePretextMeasurementResult, type UsePrintLayoutOptions, type UseRowAnimationOptions, type UseRowDragOptions, type UseRowDragReturn, type UseTableRowHeightsOptions, type UseThemeOptions, type UseTooltipOptions, type UseVirtualizationOptions, type UseVirtualizationResult, type VirtualRow, getMeasureRecipeForCellType, getRegisteredCellTypes, resolveMeasureRecipe, useAutoMeasurements, useCellFlash, useClipboard, useContextMenu, useFillHandle, useKeyboardNavigation, usePretextMeasurement, usePrintLayout, useRowAnimation, useRowDrag, useTable, useTableContext, useTableRowHeights, useTheme, useTooltip, useVirtualization };
+export { type AutoMeasurementsOptions, CellBadge, type CellBadgeProps, CellBoolean, type CellBooleanProps, CellCheckbox, CellCurrency, type CellCurrencyProps, CellDate, CellDatePicker, type CellDateProps, CellErrorBoundary, CellInput, CellLink, type CellLinkProps, type CellMeasureRecipe, type CellMeasurement, CellNumeric, type CellNumericProps, CellProgress, type CellProgressProps, CellRating, type CellRatingProps, CellSelect, CellStatus, CellStatusBadge, type CellStatusBadgeProps, type CellStatusProps, CellToggle, ColumnsPanel, ContextMenu, ContextMenuItem, type ContextMenuItemDef, DEFAULT_TEXT_RECIPE, DragHandle, ErrorBoundary, ExpandIcon, FillHandle, type FillHandleDragState, type FillHandleProps, FiltersPanel, FlashCell, FloatingFilter, GlobalFilter, LoadingOverlay, type LoadingOverlayProps, MasterDetail, NoRowsOverlay, type NoRowsOverlayProps, Pagination, PivotConfigPanel, type PivotConfigProps, type PivotFieldItem, type PivotValueItem, PrintLayout, SetFilter, Sidebar, SortIndicator, StatusBar, StatusBarPanelComponent, type StatusBarPanelComponentProps, type StatusBarPanelConfig, type StatusBarPanelProps, Table, TableBody, TableCell, type TableCellProps$1 as TableCellProps, TableFooter, TableHeader, type TableHeaderCellProps, type TableProps, TableProvider, type TableRowProps, Tooltip, type TooltipPosition, type TooltipProps, TreeToggle, type UseCellFlashOptions, type UseClipboardOptions, type UseColumnVirtualizationOptions, type UseColumnVirtualizationResult, type UseFillHandleOptions, type UseFillHandleReturn, type UseKeyboardNavigationOptions, type UsePretextMeasurementOptions, type UsePretextMeasurementResult, type UsePrintLayoutOptions, type UseRowAnimationOptions, type UseRowDragOptions, type UseRowDragReturn, type UseTableRowHeightsOptions, type UseThemeOptions, type UseTooltipOptions, type UseVirtualizationOptions, type UseVirtualizationResult, type VirtualColumn, type VirtualRow, getMeasureRecipeForCellType, getRegisteredCellTypes, resolveMeasureRecipe, useAutoMeasurements, useCellFlash, useClipboard, useColumnVirtualization, useContextMenu, useFillHandle, useKeyboardNavigation, usePretextMeasurement, usePrintLayout, useRowAnimation, useRowDrag, useTable, useTableContext, useTableRowHeights, useTheme, useTooltip, useVirtualization };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { Table as Table$1, RowData, Cell, Header, Row, TableOptions, ColumnDef, SortDirection, CellContext, ClipboardOptions, CellFlashInfo } from '@zvndev/yable-core';
-export { AccessorFnColumnDef, AccessorKeyColumnDef, AggregationFn, Cell, CellStatus as CellCommitStatus, CellContext, CellFlashEvent, CellPatch, ClipboardOptions, Column, ColumnDef, ColumnDefBase, ColumnFiltersState, ColumnMeta, ColumnOrderState, ColumnPinningState, ColumnSizingInfoState, ColumnSizingState, CommitError, CommitErrorCells, CommitRecord, CommitResult, CommitsSlice, DisplayColumnDef, EditingState, ExpandedState, FillHandleState, FilterFn, FormulaState, GroupColumnDef, Header, HeaderContext, HeaderGroup, KeyboardNavigationAction, KeyboardNavigationCell, KeyboardNavigationDirection, KeyboardNavigationState, OnChangeFn, OnCommitFn, PaginationState, PartialLocale, PivotConfig, PivotState, Row, RowData, RowDragEndEvent, RowDragEvent, RowDragState, RowEditCommitEvent, RowEditEvent, RowPinningState, RowReorderEvent, RowSelectionState, SortDirection, SortingFn, SortingState, Table as TableInstance, TableOptions, TableOptionsResolved, TableState, UndoAction, UndoRedoState, Updater, VisibilityState, YableLocale, aggregationFns, createColumnHelper, createLocale, en, filterFns, functionalUpdate, getDefaultLocale, resetLocale, setDefaultLocale, sortingFns } from '@zvndev/yable-core';
+import { Table as Table$1, RowData, Cell, Header, Row, TableOptions, Column, ColumnDef, SortDirection, CellContext, ClipboardOptions, CellFlashInfo } from '@zvndev/yable-core';
+export { AccessorFnColumnDef, AccessorKeyColumnDef, AggregationFn, Cell, CellStatus as CellCommitStatus, CellContext, CellFlashEvent, CellPatch, ClipboardOptions, Column, ColumnDef, ColumnDefBase, ColumnFiltersState, ColumnMeta, ColumnOrderState, ColumnPinningState, ColumnSizingInfoState, ColumnSizingState, CommitError, CommitErrorCells, CommitRecord, CommitResult, CommitsSlice, DisplayColumnDef, EditingState, ExpandedState, FillHandleState, FilterFn, FormulaEngine, FormulaError, FormulaFunction, FormulaState, GroupColumnDef, Header, HeaderContext, HeaderGroup, KeyboardNavigationAction, KeyboardNavigationCell, KeyboardNavigationDirection, KeyboardNavigationState, OnChangeFn, OnCommitFn, PaginationState, PartialLocale, PivotColumn, PivotConfig, PivotEngine, PivotFieldConfig, PivotRow, PivotState, PivotValueConfig, Row, RowData, RowDragEndEvent, RowDragEvent, RowDragState, RowEditCommitEvent, RowEditEvent, RowPinningState, RowReorderEvent, RowSelectionState, SortDirection, SortingFn, SortingState, Table as TableInstance, TableOptions, TableOptionsResolved, TableState, UndoAction, UndoRedoOptions, UndoRedoState, UndoStack, Updater, VisibilityState, YableLocale, aggregationFns, createColumnHelper, createLocale, createUndoRedoIntegration, en, filterFns, formulaFunctions, functionalUpdate, generatePivotColumnDefs, getDefaultLocale, getInitialPivotState, getPivotRowModel, resetLocale, setDefaultLocale, sortingFns } from '@zvndev/yable-core';
 import * as React$1 from 'react';
 import React__default, { HTMLAttributes, TdHTMLAttributes, ThHTMLAttributes } from 'react';
 import * as react_jsx_runtime from 'react/jsx-runtime';
@@ -53,6 +53,14 @@ interface TableProps<TData extends RowData> extends Omit<HTMLAttributes<HTMLDivE
     sidebarPanels?: ('columns' | 'filters')[];
     /** Default sidebar panel */
     defaultSidebarPanel?: 'columns' | 'filters';
+    /** Render a second header row with per-column floating filters */
+    floatingFilters?: boolean;
+    /** Virtualize wide tables horizontally when safe to do so */
+    columnVirtualization?: boolean;
+    /** Additional columns rendered beyond the viewport when column virtualization is enabled */
+    columnVirtualizationOverscan?: number;
+    /** Accessible label for the grid container. Default: "Data table" */
+    ariaLabel?: string;
 }
 /** Status bar panel configuration */
 interface StatusBarPanelConfig {
@@ -75,6 +83,20 @@ interface TableHeaderCellProps<TData extends RowData, TValue = unknown> extends
     header: Header<TData, TValue>;
 }
 
+/**
+ * React hook that wraps the framework-agnostic core table engine.
+ *
+ * Returns a stable {@link Table} instance whose `state` reflects either
+ * the consumer's controlled `options.state` or the hook's internal state.
+ *
+ * Re-renders are triggered by `setState` from the default `onStateChange`
+ * implementation. Consumers may pass their own `onStateChange` to control
+ * state externally.
+ *
+ * Gotcha: `options.onStateChange` is captured via a latest-ref, so a fresh
+ * function identity from the parent is always invoked — even if every other
+ * option key is shallow-equal to the previous render.
+ */
 declare function useTable<TData extends RowData>(options: TableOptions<TData>): Table$1<TData>;
 
 interface VirtualRow {
@@ -104,10 +126,40 @@ interface UseVirtualizationResult {
  * Computes which rows are visible in a scrollable container and returns
  * positioning data so only those rows (plus an overscan buffer) are rendered.
  *
- * Supports both fixed and variable row heights.
+ * Returns `{ virtualRows, totalHeight, startIndex, endIndex, scrollTo }`.
+ * Re-renders are triggered by scroll (rAF-throttled) and ResizeObserver
+ * container resize. Supports fixed, variable, and Pretext-pre-measured heights.
+ *
+ * Gotcha: variable-height mode caches measured heights per index — pass new
+ * `pretextHeights` arrays (or change `totalRows`) to invalidate the cache.
  */
 declare function useVirtualization({ containerRef, totalRows, rowHeight, overscan, estimateRowHeight: _estimateRowHeight, pretextHeights, pretextPrefixSums, }: UseVirtualizationOptions): UseVirtualizationResult;
 
+interface VirtualColumn<TData extends RowData> {
+    column: Column<TData, unknown>;
+    index: number;
+    start: number;
+    size: number;
+}
+interface UseColumnVirtualizationOptions<TData extends RowData> {
+    containerRef: React.RefObject<HTMLElement | null>;
+    columns: Column<TData, unknown>[];
+    overscan?: number;
+    enabled?: boolean;
+}
+interface UseColumnVirtualizationResult<TData extends RowData> {
+    virtualColumns: VirtualColumn<TData>[];
+    startOffset: number;
+    endOffset: number;
+    totalWidth: number;
+    visibleWidth: number;
+    startIndex: number;
+    endIndex: number;
+    isVirtualized: boolean;
+    scrollToIndex: (index: number) => void;
+}
+declare function useColumnVirtualization<TData extends RowData>({ containerRef, columns, overscan, enabled, }: UseColumnVirtualizationOptions<TData>): UseColumnVirtualizationResult<TData>;
+
 interface CellMeasurement {
     /** Column ID */
     columnId: string;
@@ -154,11 +206,15 @@ interface UsePretextMeasurementResult {
 }
 /**
  * Pre-computes exact pixel heights for every row using Pretext's
- * DOM-free text measurement. Returns typed arrays for cache-friendly
- * access by the virtualizer.
+ * DOM-free text measurement.
  *
- * layout() is pure arithmetic (~0.0003ms per cell) so column resizing
- * re-computes all heights near-instantly.
+ * Returns `{ rowHeights, prefixSums, totalHeight, ready, ... }` as typed
+ * arrays for cache-friendly access by the virtualizer. `prepare()` re-runs
+ * when `data` or fonts change; `layout()` re-runs only when column widths
+ * change (pure math, ~0.0003ms per cell).
+ *
+ * Gotcha: pretext is loaded lazily — `ready` flips to true on the first
+ * render after the dynamic import resolves and heights are computed.
  */
 declare function usePretextMeasurement({ data, columns, getCellText, minRowHeight, enabled, }: UsePretextMeasurementOptions): UsePretextMeasurementResult;
 
@@ -337,18 +393,19 @@ declare function getRegisteredCellTypes(): readonly string[];
 declare const TableProvider: React$1.Provider<Table$1<any> | null>;
 declare function useTableContext<TData extends RowData>(): Table$1<TData>;
 
-declare function Table<TData extends RowData>({ table, stickyHeader, striped, bordered, compact, theme, clickableRows, footer, loading, loadingComponent, loadingText, emptyMessage, emptyComponent, emptyIcon, emptyDetail, renderEmpty, renderLoading, children, className, direction, statusBar, statusBarPanels, sidebar, sidebarPanels, defaultSidebarPanel, ...rest }: TableProps<TData>): react_jsx_runtime.JSX.Element;
+declare function Table<TData extends RowData>({ table, stickyHeader, striped, bordered, compact, theme, clickableRows, footer, loading, loadingComponent, loadingText, emptyMessage, emptyComponent, emptyIcon, emptyDetail, renderEmpty, renderLoading, children, className, direction, statusBar, statusBarPanels, sidebar, sidebarPanels, defaultSidebarPanel, floatingFilters, columnVirtualization, columnVirtualizationOverscan, ariaLabel, ...rest }: TableProps<TData>): react_jsx_runtime.JSX.Element;
 
 interface TableHeaderProps<TData extends RowData> {
     table: Table$1<TData>;
+    floatingFilters?: boolean;
 }
-declare function TableHeader<TData extends RowData>({ table, }: TableHeaderProps<TData>): react_jsx_runtime.JSX.Element;
+declare function TableHeader<TData extends RowData>({ table, floatingFilters, }: TableHeaderProps<TData>): react_jsx_runtime.JSX.Element;
 
 interface TableBodyProps<TData extends RowData> {
     table: Table$1<TData>;
     clickableRows?: boolean;
 }
-declare function TableBody<TData extends RowData>({ table, clickableRows, }: TableBodyProps<TData>): react_jsx_runtime.JSX.Element;
+declare function TableBody<TData extends RowData>({ table, clickableRows }: TableBodyProps<TData>): react_jsx_runtime.JSX.Element;
 
 interface TableCellProps<TData extends RowData> {
     cell: Cell<TData, unknown>;
@@ -363,7 +420,7 @@ declare function TableCell<TData extends RowData>({ cell, table, rowIndex, colum
 interface TableFooterProps<TData extends RowData> {
     table: Table$1<TData>;
 }
-declare function TableFooter<TData extends RowData>({ table, }: TableFooterProps<TData>): react_jsx_runtime.JSX.Element | null;
+declare function TableFooter<TData extends RowData>({ table }: TableFooterProps<TData>): react_jsx_runtime.JSX.Element | null;
 
 interface PaginationProps<TData extends RowData> {
     table: Table$1<TData>;
@@ -389,6 +446,17 @@ interface GlobalFilterProps<TData extends RowData> {
 }
 declare function GlobalFilter<TData extends RowData>({ table, placeholder, debounce, className, }: GlobalFilterProps<TData>): react_jsx_runtime.JSX.Element;
 
+interface FloatingFilterProps<TData extends RowData> {
+    column: Column<TData, unknown>;
+}
+declare function FloatingFilter<TData extends RowData>({ column }: FloatingFilterProps<TData>): react_jsx_runtime.JSX.Element;
+
+interface SetFilterProps<TData extends RowData> {
+    column: Column<TData, unknown>;
+    className?: string;
+}
+declare function SetFilter<TData extends RowData>({ column, className }: SetFilterProps<TData>): react_jsx_runtime.JSX.Element;
+
 interface SortIndicatorProps {
     direction: SortDirection | false;
     index?: number;
@@ -933,7 +1001,7 @@ interface UsePrintLayoutOptions {
      */
     additionalCSS?: string;
 }
-declare function usePrintLayout<TData extends RowData>(table: Table$1<TData>, options?: UsePrintLayoutOptions): {
+declare function usePrintLayout<TData extends RowData>(_table: Table$1<TData>, options?: UsePrintLayoutOptions): {
     preparePrint: () => void;
     isPrinting: boolean;
 };
@@ -954,4 +1022,4 @@ declare function useTheme(options?: UseThemeOptions): {
     containerRef: React$1.RefObject<HTMLElement | null>;
 };
 
-export { type AutoMeasurementsOptions, CellBadge, type CellBadgeProps, CellBoolean, type CellBooleanProps, CellCheckbox, CellCurrency, type CellCurrencyProps, CellDate, CellDatePicker, type CellDateProps, CellErrorBoundary, CellInput, CellLink, type CellLinkProps, type CellMeasureRecipe, type CellMeasurement, CellNumeric, type CellNumericProps, CellProgress, type CellProgressProps, CellRating, type CellRatingProps, CellSelect, CellStatus, CellStatusBadge, type CellStatusBadgeProps, type CellStatusProps, CellToggle, ColumnsPanel, ContextMenu, ContextMenuItem, type ContextMenuItemDef, DEFAULT_TEXT_RECIPE, DragHandle, ErrorBoundary, ExpandIcon, FillHandle, type FillHandleDragState, type FillHandleProps, FiltersPanel, FlashCell, GlobalFilter, LoadingOverlay, type LoadingOverlayProps, MasterDetail, NoRowsOverlay, type NoRowsOverlayProps, Pagination, PivotConfigPanel, type PivotConfigProps, type PivotFieldItem, type PivotValueItem, PrintLayout, Sidebar, SortIndicator, StatusBar, StatusBarPanelComponent, type StatusBarPanelComponentProps, type StatusBarPanelConfig, type StatusBarPanelProps, Table, TableBody, TableCell, type TableCellProps$1 as TableCellProps, TableFooter, TableHeader, type TableHeaderCellProps, type TableProps, TableProvider, type TableRowProps, Tooltip, type TooltipPosition, type TooltipProps, TreeToggle, type UseCellFlashOptions, type UseClipboardOptions, type UseFillHandleOptions, type UseFillHandleReturn, type UseKeyboardNavigationOptions, type UsePretextMeasurementOptions, type UsePretextMeasurementResult, type UsePrintLayoutOptions, type UseRowAnimationOptions, type UseRowDragOptions, type UseRowDragReturn, type UseTableRowHeightsOptions, type UseThemeOptions, type UseTooltipOptions, type UseVirtualizationOptions, type UseVirtualizationResult, type VirtualRow, getMeasureRecipeForCellType, getRegisteredCellTypes, resolveMeasureRecipe, useAutoMeasurements, useCellFlash, useClipboard, useContextMenu, useFillHandle, useKeyboardNavigation, usePretextMeasurement, usePrintLayout, useRowAnimation, useRowDrag, useTable, useTableContext, useTableRowHeights, useTheme, useTooltip, useVirtualization };
+export { type AutoMeasurementsOptions, CellBadge, type CellBadgeProps, CellBoolean, type CellBooleanProps, CellCheckbox, CellCurrency, type CellCurrencyProps, CellDate, CellDatePicker, type CellDateProps, CellErrorBoundary, CellInput, CellLink, type CellLinkProps, type CellMeasureRecipe, type CellMeasurement, CellNumeric, type CellNumericProps, CellProgress, type CellProgressProps, CellRating, type CellRatingProps, CellSelect, CellStatus, CellStatusBadge, type CellStatusBadgeProps, type CellStatusProps, CellToggle, ColumnsPanel, ContextMenu, ContextMenuItem, type ContextMenuItemDef, DEFAULT_TEXT_RECIPE, DragHandle, ErrorBoundary, ExpandIcon, FillHandle, type FillHandleDragState, type FillHandleProps, FiltersPanel, FlashCell, FloatingFilter, GlobalFilter, LoadingOverlay, type LoadingOverlayProps, MasterDetail, NoRowsOverlay, type NoRowsOverlayProps, Pagination, PivotConfigPanel, type PivotConfigProps, type PivotFieldItem, type PivotValueItem, PrintLayout, SetFilter, Sidebar, SortIndicator, StatusBar, StatusBarPanelComponent, type StatusBarPanelComponentProps, type StatusBarPanelConfig, type StatusBarPanelProps, Table, TableBody, TableCell, type TableCellProps$1 as TableCellProps, TableFooter, TableHeader, type TableHeaderCellProps, type TableProps, TableProvider, type TableRowProps, Tooltip, type TooltipPosition, type TooltipProps, TreeToggle, type UseCellFlashOptions, type UseClipboardOptions, type UseColumnVirtualizationOptions, type UseColumnVirtualizationResult, type UseFillHandleOptions, type UseFillHandleReturn, type UseKeyboardNavigationOptions, type UsePretextMeasurementOptions, type UsePretextMeasurementResult, type UsePrintLayoutOptions, type UseRowAnimationOptions, type UseRowDragOptions, type UseRowDragReturn, type UseTableRowHeightsOptions, type UseThemeOptions, type UseTooltipOptions, type UseVirtualizationOptions, type UseVirtualizationResult, type VirtualColumn, type VirtualRow, getMeasureRecipeForCellType, getRegisteredCellTypes, resolveMeasureRecipe, useAutoMeasurements, useCellFlash, useClipboard, useColumnVirtualization, useContextMenu, useFillHandle, useKeyboardNavigation, usePretextMeasurement, usePrintLayout, useRowAnimation, useRowDrag, useTable, useTableContext, useTableRowHeights, useTheme, useTooltip, useVirtualization };