docs(web/guides): document paginationNav Bootstrap args and update CLAUDE.md

Add Bootstrap 5 like-for-like swap example to the 3x-to-4x upgrade guide's
paginationLinks() section, and update CLAUDE.md Pagination View Helpers with
the new prepend/append/prependToPage/appendToPage/addActiveClassToPrependedParent/
anchorDivider args added in #2715.

Signed-off-by: claude[bot] <41898282+claude[bot]@users.noreply.github.com>

Author: github-actions[bot]

CLAUDE.md

@@ -464,17 +464,29 @@ Requires a paginated query: `findAll(page=params.page, perPage=25)`. The recomme
 #paginationNav()#
 #paginationNav(showInfo=true, showFirst=false, showLast=false, navClass="my-pagination")#
 
+// Bootstrap 5 — like-for-like swap for legacy paginationLinks() Bootstrap markup
+#paginationNav(
+    navClass="",
+    prepend='<ul class="pagination">',
+    append="</ul>",
+    prependToPage='<li class="page-item">',
+    appendToPage="</li>",
+    class="page-link",
+    classForCurrent="active",
+    addActiveClassToPrependedParent=true
+)#
+
 // Individual helpers for custom layouts
 #paginationInfo()#            // "Showing 26-50 of 1,000 records"
 #firstPageLink()#             // link to page 1
 #previousPageLink()#          // link to previous page
 #pageNumberLinks()#           // windowed page number links (default windowSize=2)
 #nextPageLink()#              // link to next page
 #lastPageLink()#              // link to last page
-#pageNumberLinks(windowSize=5, classForCurrent="active")#
+#pageNumberLinks(windowSize=5, classForCurrent="active", addActiveClassToPrependedParent=true)#
 ```
 
-Disabled links render as `<span class="disabled">` by default. All helpers accept `handle` for named pagination queries.
+Disabled links render as `<span class="disabled">` by default. All helpers accept `handle` for named pagination queries. `paginationNav()` also accepts `prepend`/`append` (HTML inside `<nav>` before/after the link list), `prependToPage`/`appendToPage` (per-anchor wrappers applied to all navigation anchors including first/prev/next/last), `addActiveClassToPrependedParent` (injects `active ` into the current-page `prependToPage` class attribute), and `anchorDivider` (separator between sections, default `" "`).
 
 ## Testing Quick Reference
 

web/sites/guides/src/content/docs/v4-0-1-snapshot/upgrading/3x-to-4x.mdx

@@ -323,6 +323,23 @@ See [Packages](/v4-0-1-snapshot/digging-deeper/packages/) for manifest fields, p
 
 **CHANGELOG:** composable pagination helpers added (#1930). The 3.x `paginationLinks()` is retained. New code should use `paginationNav()` or compose the individual helpers (`paginationInfo`, `firstPageLink`, `previousPageLink`, `pageNumberLinks`, `nextPageLink`, `lastPageLink`).
 
+Bootstrap-styled 3.x apps that relied on `paginationLinks()` emitting `<li class="page-item active">` wrappers can now do a like-for-like swap using `paginationNav()` with the Bootstrap-style arguments added in v4.0.1 (#2715):
+
+```cfm
+##paginationNav(
+    navClass                    = "",
+    prepend                     = '<ul class="pagination">',
+    append                      = "</ul>",
+    prependToPage               = '<li class="page-item">',
+    appendToPage                = "</li>",
+    class                       = "page-link",
+    classForCurrent             = "active",
+    addActiveClassToPrependedParent = true
+)##
+```
+
+This produces markup equivalent to the 3.x output: `<nav><ul class="pagination"><li class="active page-item"><span class="page-link">N</span></li>…</ul></nav>`.
+
 ### RocketUnit test style
 
 **CHANGELOG:** `Deprecated: RocketUnit test style for new tests` (#1925) and `Removed: Legacy RocketUnit core test scaffolding` (#1925). Existing app specs still run; the framework-level RocketUnit runner is gone. Do not write new tests in RocketUnit style.