| total | number | — | Total item count. |
| pageSize | number | — | Items per page. |
| currentPage | number | — | Active page (1-based). |
| size | 'xs' | 'sm' | 'md' | 'lg' | 'sm' | Control scale. |
| className | string | '' | Extra classes for the nav. |
| pageSizeOptions | number[] | [10, 20, 50] | Page-size choices. |
| onPageChange | (page: number) => void | — | Called on page change. |
| onPageSizeChange | (size: number) => void | — | Called on page-size change. |
| previousLabel | string | locale | Accessible name for the previous arrow. |
| nextLabel | string | locale | Accessible name for the next arrow. |
| pageSizeLabel | string | locale | Label beside the page-size select. |
| currentPageLabel | string | locale | Accessible name for the page jump input. |
| paginationLabel | string | locale | Accessible name for the nav. |
| trailing | Snippet | — | Arbitrary content pinned to the row’s right edge. |