Table
Два уровня. base — дословный набор частей shadcn/ui (Table, TableHeader, TableBody,
TableFooter, TableRow, TableHead, TableCell, TableCaption) для ручной вёрстки:
Table оборачивает <table> в скролл-контейнер (overflow-x-auto), остальные части —
тонкие стилизованные обёртки над соответствующими тегами.
DataGrid — data-driven обёртка поверх base. Движок @tanstack/react-table
работает в режиме manualPagination / manualSorting / manualFiltering, поэтому реальную
сортировку, пагинацию и фильтрацию выполняет ваш dataProvider (server-driven): грид держит
только состояние и на каждое изменение filters / sorting / pagination дёргает провайдер.
Состояния загрузки / ошибки / пустого результата показываются через AsyncBoundary + State
(LoadingState / ErrorState), а навигация по страницам — через компонент Pagination.
@tanstack/react-table — тяжёлая опциональная зависимость (optional peer), поэтому компонент
живёт вне главного barrel и импортируется по subpath:
import { DataGrid } from '@reformer/ui-kit/table'.
Variants — готовые конфигурации компонента: один и тот же компонент с разными преднастроенными пропсами. Витрина состояний (напр. обычный Select и Select с расширенной информацией — два варианта).
Examples — приёмы в коде: как решить задачу. Напр. как разные Data Provider’ы работают с компонентом (рецепты использования).