Data Table

Overview

Data Table is a design-system component intended for reusable, product-agnostic UI composition.

Import


import { DataTable } from "@tesseract-nexus/tesserix-ui"

Exports


export { DataTable } from "./data-table"
export type { DataTableProps, DataTableColumn } from "./data-table"

Props


export interface DataTableProps<TRow extends object>
  extends Omit<React.HTMLAttributes<HTMLDivElement>, "children"> {
  columns: DataTableColumn<TRow>[]
  data: TRow[]
  searchPlaceholder?: string
  emptyMessage?: string
  pageSizeOptions?: number[]
  defaultPageSize?: number
  columnFiltersEnabled?: boolean
  enableRowSelection?: boolean
  selectedRowIds?: string[]
  onSelectedRowIdsChange?: (rowIds: string[]) => void
  getRowId?: (row: TRow, index: number) => string
}

Variations


No explicit cva variant map found. Variations are primarily structural/compositional for this component.

Usage Patterns

Basic


import { DataTable } from "@tesseract-nexus/tesserix-ui"
 
export function Example() {
  return <DataTable />
}

Do / Don’t

Do


// Compose with domain wrappers in product code
<DataTable className="w-full" />

Don’t


// Avoid one-off hardcoded values that bypass tokens
<DataTable className="bg-[#123456] text-[#fafafa] px-[13px]" />

Token / Theming Mapping

Color tokens: —primary, —secondary, —muted, —destructive, —foreground, —background
Shape tokens: —radius
Border/input tokens: —border, —input, —ring
Spacing and typography: Tailwind scale via design-system preset

Interaction Test Checklist

Interaction: click/keyboard activation for primary paths.
Focus: visible focus styles and logical tab order.
Variants: core variants and sizes render correctly.
Disabled/error states: behavior and ARIA attributes are correct.
Regression: Storybook visual check for primary states.

Accessibility

Verify keyboard behavior for all interactive states.
Ensure labels and semantic roles are present in consuming screens.
Validate focus treatment and screen-reader output during QA.