Pagination

Pagination under a table. Controlled by the caller — it never fights the table over who owns the page state.

When to use it

The list is longer than makes sense to render at once and the data is fetched a page at a time — typically from a server.
A previous / status / next pager belongs under the table. The block order of a list screen is: filter bar, bulk-action bar, table, pager.

There are only a few dozen rows and they fit one scroll box — the table's sticky header is then simpler than extra page state.
You need numbered pages or "load more". This shape is deliberately previous / next only; a different shape means extending the primitive, not working around it.

page: number — The current page, 1-based.
pageCount: number — The total number of pages.
onPageChange: (page: number) => void — Called with the new page number; never called out of range.
prevLabel: string — Translated "Previous".
nextLabel: string — Translated "Next".
status: ReactNode — The already-composed status ("Page 2 of 8") — only the caller can interpolate it.
label: string — The label of the navigation landmark for screen readers; tells two pagers on one screen apart.
className: string — Pass-through class on the wrapper.
testId: string — data-testid of the pager.