AUP Web-only widget — not a cross-device primitive; not a Web Device layout component.
The name is registered in AUP_WIDGETS (packages/aup/src/aup-types.ts). It can be accepted by structure verification and implemented by a Web runtime (or native target where noted). It is not one of the 18 cross-device AUP_PRIMITIVES, does not enter DeviceCaps.primitives via fillPrimitives, and is not a Web Device theme/site layout component (for example content-card or page-breadcrumb).
Purpose
Brand shell header — server-driven navigation chrome. Renderer emits AUP events rather than owning client-side routing policy.
Boundaries
- Do not document this type as a portable primitive.
- Do not mix it with Web Device layout-component reference pages under
widgets/. - A parser-accepted name is not a portability or product-readiness claim.
Author entry
AUP app shell type: "app-header". Showcase prim-app-header, session, session-chrome.
Surfaces
Interactive Web + document RENDERERS. Site layout portal-header is a different layout-component.
Fallback
No shared degradation chain.
Evidence
| Source | Path |
|---|---|
| Registration | packages/aup/src/aup-types.ts |
| Registry | providers/runtime/ui/src/aup-registry.ts (app-header) |
| Interactive renderer | providers/runtime/ui/src/web-page/renderers/app-header.ts |
| Document renderer | providers/runtime/web-device/src/renderer/primitives/app-header.ts; RENDERERS in render-to-html.ts |
| Showcase | blocklets/showcase/.aup/pages/prim-app-header.json |
Paths are relative to the Arc repository checkout used for this documentation baseline.
Sample
No docs-safe live sample on this site yet. Use the listed Showcase source / factory API as a source-only reference. Run Showcase locally if you need interactive acceptance.
Related
- Widgets hub — navigation only
- Primitive taxonomy — 18 vs 42 boundary
- Custom primitives and Web widgets
- Internal matrix:
docs/aup/capability-matrix.md - Showcase route (local ARC):
prim-app-headerunderblocklets/showcase