Add UsePagination

[Tyson910]

Describe the feature in detail (code, mocks, or screenshots encouraged)

Create a usePagination rune for pagination component, allowing users to manage active page state and navigate between multiple pages. Implementation would follow these interfaces:

export interface PaginationParams {
  /** Page selected on initial render, defaults to 1 */
  initialPage?: number;

  /** Total amount of pages */
  total: number;

  /** Callback fired after change of each page */
  onChange?: (page: number) => void;
}

export interface PaginationReturn {
  currentPage: number
  pageCount: number
  prev: () => void
  next: () => void
  // not sure if these last 2 are valuable or not
  isFirstPage: boolean
  isLastPage: boolean
}

What type of pull request would this be?

New Feature

Provide relevant links or additional information.

This implementation could follow the UseIdle hook created by VueUse or Mantine

[specialdoom]

is somebody working on this?

[abdel-17]

I don't think this is a good inclusion to the library. You should probably use the URL as your source of truth for pagination state to preserve the page across navigations and/or sharing links. The best we could do is provide a wrapper around SvelteKit APIs, but not everyone uses SvelteKit.

Thoughts? @huntabyte