| className | string? | '' | | Extra classes for the nav. |
| currentPage | number | — | | Active page (1-based). |
| labels | PaginationLabels? | — | | Per-field label overrides; each omitted field falls back to its i18n key. The eye applies the map. |
| pageSize | number | — | | Items per page. |
| pageSizeOptions | number[]? | — | | Page-size choices offered by the dropdown. The eye resets to the defaults. |
| size | 'xs' | 'sm' | 'md' | 'lg' | 'xl' | number | 'md' | | Control scale; numbers flow to the page-size dropdown interpolated between the steps. |
| total | number | — | | Total item count. |
| trailing | Snippet | — | | Arbitrary content pinned to the row’s right edge; committing applies it, and the dialog edits its text. |
| variant | 'numbered' | 'compact' | 'numbered' | | Presentation: paged blocks with the page-size selector, or previous/next around a “Page X of Y” summary without it. |
| onPageChange | (page: number) => void | — | — | Called on page change. |
| onPageSizeChange | (size: number) => void | — | — | Called on page-size change. |