| allSelected | boolean | — | | Header checkbox checked state. Interaction override; unset follows the selection. |
| batchActions | Snippet<[T[], () => void]>? | — | — | Batch actions in the toolbar row; receives the selected rows and a clear-selection callback. |
| bodyScroll | boolean? | false | | Fixed header band with a body-only scrollport (needs fillHeight). |
| bordered | boolean | true | | Card chrome (border, rounding, backdrop) on the viewer container. |
| chooserColumns | ChooserColumn[]? | — | | Column selector entries; checked writes the hidden-column set. |
| chooserLabel | string? | 'Choose columns' | | Accessible name for the column selector. |
| chooserResetLabel | string? | 'Reset columns' | | Accessible name for the reset button. |
| containerClassName | string? | '' | | Extra classes for the outer container; built-in scroll/border chrome when unset. |
| dense | boolean | false | | Compact padding for panel tables. |
| emptyMessage | string? | 'No rows' | | Shown when rows is empty. |
| fillHeight | boolean? | false | | Fills the parent; table body scrolls. |
| loading | boolean | false | | Shows the spinner when there are no rows yet. |
| model | TableModel<T>? | — | — | Managed mode: a createTableModel controller supplies the filter, sort, page slice, selection, and footer; the model-backed props (rows, rowId, searchValue, sortKey, sortDirection, pagination, selectedIds, allSelected, someSelected) are then ignored. |
| resizable | boolean | false | | Draggable column resize handles. |
| resetWidthsSignal | number? | 0 | | Rising signal: each new value drops managed and persisted widths. |
| rows | DemoRow[] | — | | Demo rows as JSON; the caller filters, sorts, and slices the current page. The eye resets to the default rows. |
| searchAriaLabel | string? | 'Search' | | Accessible name for the search field. |
| searchKeys | string[]? | — | | Bindable searchable column keys; derived from searchable columns when unset. The eye applies the list. |
| searchPlaceholder | string? | 'Search...' | | Search placeholder. |
| searchValue | string? | '' | | Bindable search text; filtering stays with the caller. The eye resets it to the default. |
| selectAllAriaLabel | string? | 'Select all' | | Accessible name for the header checkbox. |
| selectable | boolean | false | | Renders the checkbox column. |
| showPagination | boolean | pagination configured | | Renders the pagination footer. Unset, the footer renders only when `pagination` supplies its data and onPageChange. |
| showSearch | boolean | true | | Renders the search field. |
| size | 'xs' | 'sm' | 'md' | 'lg' | 'xl' | number | 'md' | | Cell text, padding, selection count, and the table’s own column floors scale with the search, chooser, selection, and pagination chrome; numbers are icon-scale pixels. |
| someSelected | boolean | — | | Header checkbox indeterminate state. Interaction override; unset follows the selection. |
| sortDirection | 'asc' | 'desc' | 'asc' | | Bindable sort direction; the eye resets it to the default; clearing restores the default. |
| sortKey | string? | null | | Bindable active sort column. The eye resets it to the default. |
| storageKey | string? | — | | Persists resized widths under this key. |
| storagePrefix | string? | — | | App-owned localStorage prefix for the persisted widths; the package prefix stays the read fallback. |
| tableClassName | string? | 'min-w-0' | | Extra classes for the table element; raise the minimum width when columns need a horizontal scroll floor. |
| toolbar | Snippet<[T[], () => void]>? | — | — | Leading toolbar content in the batch row (operational buttons); receives the selected rows and a clear-selection callback. |
| toolbarEnd | Snippet<[T[], () => void]>? | — | — | Trailing toolbar content, after the built-in selection actions (typically Refresh). |
| variant | 'data' | 'docs' | 'data' | | Presentation: the paged viewer, or the static docs table with a plain wrapper, non-sticky header, and no row hover. |
| columns | DataTableColumn<T>[] | — | — | Column defs with optional cell renderers. |
| pagination | DataTablePagination? | — | — | Footer config: total/pageSize/currentPage plus onPageChange gate the footer; onPageSizeChange adds the page-size selector; pageSizeOptions customizes its choices; labels overrides the aria labels; trailing is a snippet pinned to the row’s right edge. |
| rowId | (row: T) => string | — | — | Stable key per row. |
| selectedIds | Set<string>? | — | — | Selected row ids; managed by the caller. |
| selectionActions | false | { fileName?, rows? } | managed: on | — | Built-in Export/Clear pair: JSON of the selected rows with an optional export mapper. On by default in managed mode; opt-in in controlled mode, where Clear needs onClearSelection. |
| selectionCountPosition | 'start' | 'end' | 'end' | | Where the selected-count summary sits in the toolbar row. |
| onClearSelection | () => void | — | — | Controlled-mode handler for the built-in Clear action; managed mode clears through the model. |
| onResetColumns | () => void | — | — | Reset handler; the caller also bumps resetWidthsSignal to drop resized widths. |
| onSearchInput | (event: Event) => void | — | — | Search input handler. |
| onSearchKeydown | (event: KeyboardEvent) => void | — | — | Search keydown handler. |
| onSort | (key, direction) => void | — | — | Sort handler; or bind sortKey/sortDirection. |
| onToggleAll | () => void | — | — | Select-all handler for the header checkbox. |
| onToggleColumn | (key, checked) => void | — | — | Column visibility handler. |
| onToggleSelection | (id: string, checked: boolean) => void | — | — | Row-selection handler; pair with selectedIds. |
| resizeAriaLabel | (column) => string | — | — | Accessible name for the resize handles. |
| rowSelectAriaLabel | (row: T) => string | — | — | Accessible name for each selectable row checkbox. |
| sortAriaLabel | (column, direction) => string | — | — | Accessible name for the sort buttons. |