@mpca/react-pagination

Uma biblioteca de paginação para React, simples, tipada e pronta para projetos modernos com Vite, Webpack, Next.js e TypeScript.

• ✅ React 18+
• ✅ ESM e CJS
• ✅ TypeScript nativo
• ✅ CSS importado automaticamente
• ✅ Tree-shake friendly

📦 Instalação

npm install @mpca/react-pagination

ou

yarn add @mpca/react-pagination

ou

pnpm add @mpca/react-pagination

🚀 Uso básico

Importe os componentes diretamente da lib:

import { Pagination } from '@mpca/react-pagination'

export function Example() {
  return (
    <Pagination
      activePage={page}
      itemsCountPerPage={10}
      totalItemsCount={450}
      pageRangeDisplayed={5}
      onChange={(page) => setPage(page)}
    />
  )
}

🎨 Estilos (CSS)

O CSS da biblioteca pode ser importado da seguinte forma::

import '@mpca/react-pagination/style.css'

📚 Componentes

<Pagination />

Componente principal de paginação.

Props (exemplo)

interface PaginationProps {
  totalPages: number
  currentPage: number
  onPageChange: (page: number) => void
}

<Page />

Representa uma página individual (uso interno ou avançado).

paginator

Utilitário para lógica de paginação (ex: range de páginas, limites, etc).

import { paginator } from '@mpca/react-pagination'

🧠 Tipagem

A lib é escrita em TypeScript e exporta todos os tipos automaticamente.

import type { PaginationProps } from '@mpca/react-pagination'

🌳 Tree-shaking

A biblioteca é totalmente tree-shakeable. Somente o código realmente usado será incluído no bundle final.

🔧 Compatibilidade

• React ≥ 18
• Vite
• Webpack
• Next.js
• Node.js ≥ 16

📄 Licença

MIT © MPCA

🤝 Contribuindo

Pull requests são bem-vindos! Sinta-se à vontade para abrir issues com sugestões ou bugs.