Pagination breadth: page-number, Link-header strategies, and a page cap (#8)

* docs: design spec for pagination breadth subsystem

Page-number and Link-header strategy constructors plus an RFC 8288 NextLink
parser and a WithMaxPages cap, built on the existing token-based Pager.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

* docs: implementation plan for pagination breadth subsystem

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

* feat(pagination): add WithMaxPages cap

* feat(pagination): add page-number and Link-header strategies

* test(pagination): cover page-number cap and parser recovery; use slices.Equal

* docs: document pagination strategies and WithMaxPages

---------

Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>

Author: OmarAlJarrah

README.md

@@ -56,7 +56,7 @@ standard library.
 | [`httperr`](./httperr) | `ResponseError` for non-success responses; buffers and rewinds the body. |
 | [`mediatype`](./mediatype) | Immutable media-type value with parsing and common constants. |
 | [`header`](./header) | Canonical HTTP header-name constants. |
-| [`pagination`](./pagination) | Generic token-pagination as `iter.Seq2` range-over-func iterators. |
+| [`pagination`](./pagination) | Generic pagination as `iter.Seq2` range-over-func iterators — cursor/token, page-number, and RFC 8288 Link-header strategies, with a `WithMaxPages` cap. |
 | [`config`](./config) | Layered override → environment → default settings resolver; non-failing typed getters. |
 | [`serde`](./serde) | Serialization seam (Marshaler/Unmarshaler) with a JSON default, plus Tristate for PATCH payloads. |
 | root [`dexpace`](.) | Umbrella `Client` wiring the default policy stack. |