Add a pagination component

[caendesilva]

About

Adds a class to aid in creating paginated pages, and with a corresponding component to render the links. The PR does not implement any actual pagination, just the framework to do so.

Cherry picks the pagination feature from #685

See also #56

Usage

Simply create a paginator instance with a collection or array of items (like pages), and render the component. You will also likely need to find some way to pass the current page being rendered (if you're on pagination page 3, pass that to the constructor)

@php
    $paginator = new \Hyde\Framework\Features\Paginator(
        items: \Hyde\Pages\MarkdownPost::getLatestPosts(), // The items to paginate
        pageSize: 25, // How many items to show on each page
        currentPageNumber: 3, // The current page index
        paginationRouteBasename: 'posts' // Links will be 'posts/page-1.html' instead of 'page-1.html'
    )
@endphp
@include('hyde::components.pagination-navigation')

Screenshots

Verbose version:

Compact version:

[codecov]

Codecov Report

Merging #832 (8de814b) into master (989b308) will not change coverage.
The diff coverage is 100.00%.

@@              Coverage Diff              @@
##              master      #832     +/-   ##
=============================================
  Coverage     100.00%   100.00%             
- Complexity      1209      2490   +1281     
=============================================
  Files            145       292    +147     
  Lines           3186      6522   +3336     
=============================================
+ Hits            3186      6522   +3336     

Impacted Files	Coverage Δ
...ges/framework/src/Framework/Features/Paginator.php	100.00% <100.00%> (ø)
...k/Features/Blogging/Models/RemoteFeaturedImage.php	100.00% <0.00%> (ø)
...mework/src/Foundation/Concerns/BootsHydeKernel.php	100.00% <0.00%> (ø)
...work/src/Foundation/Concerns/ManagesHydeKernel.php	100.00% <0.00%> (ø)
...ework/src/Framework/Actions/MarkdownFileParser.php	100.00% <0.00%> (ø)
...c/Framework/Features/Navigation/NavigationMenu.php	100.00% <0.00%> (ø)
...framework/src/Markdown/Models/MarkdownDocument.php	100.00% <0.00%> (ø)
...mework/Features/Session/SessionServiceProvider.php	100.00% <0.00%> (ø)
...src/Framework/Exceptions/FileNotFoundException.php	100.00% <0.00%> (ø)
...rc/Framework/Features/Metadata/PageMetadataBag.php	100.00% <0.00%> (ø)
... and 137 more

Help us with your feedback. Take ten seconds to tell us how you rate us. Have a feature suggestion? Share it here.

[caendesilva]

I wonder if we could add a helper method that generates the paginated virtual pages / blade pages (using a specified template) this could then be used in a provider when booting to inject those pages into the page collection. Something for another PR.