Skip to main content

Web Device surface · ARC 2.0.0-beta.28

`pagination` surface

Web Device surface `pagination`: purpose, boundaries, author entry, evidence, and sample honesty.

Web Device surface — not an AUP primitive (surface); not an AUP widget (wm-surface / same-named widgets); not a theme layout component.

Package: providers/runtime/web-device/surfaces/pagination/ (manifest.json + render.js).

Purpose

Prev/next and numbered pager for a statically paginated collection list page.

Boundaries

  • Surface packages are mounted by boards/routes/layout shells — they are not Markdown directives.
  • Same type name as a widget does not merge layers; this page is the surface contract only.
  • Do not document multiple surfaces on this page.

Author entry

collection list layout

Common author-facing props (from manifest): basePath, currentPage, totalPages

Surfaces

As implemented by this package (document shell, layout list, interactive site, etc. — see notes).

Public status

released

Fallback

Empty page → empty pager chrome.

Sample

No isolated docs-safe live mock on this page. The contract is proven by site pages that mount this unit in layout.aup (or the docs shell). Copy author source from the evidence paths; do not invent props beyond the target manifest.json.

Evidence

ItemPath
Surface packageproviders/runtime/web-device/surfaces/pagination/
Manifest…/pagination/manifest.json
Renderer…/pagination/render.js
Internal matrixdocs/aup/capability-matrix.md §4 (internal, non-routed)
Matrix row conceptsurface · pagination

Notes

Same type name as the AUP widget pagination, different layer. This page is the Web Device surface package.