map is an AUP cross-device primitive, not a Web Device layout component and not a Web-only widget. It is one of the 18 names in AUP_PRIMITIVES and appears in every target's DeviceCaps.primitives map as native, webview, partial, or unsupported.
Contract
| Field | Value |
|---|---|
| Primitive name | map |
| Layer | AUP cross-device primitive (AUP_PRIMITIVES) |
| Public status | unsupported (document) |
| Document capability | unsupported |
| Shared degradation chain | map → media → text |
| Author entry | AUP/DSL on full-web (Leaflet / MapLibre in Showcase) |
| Document renderer / notes | No document native map renderer; chain applies |
| Showcase evidence | blocklets/showcase-dsl/.aup/pages/map.aup |
When to use
Interactive map/globe UI on a target that reports map support.
When not to use
Do not embed live maps in static docs. Tile CDN and JS map stacks are not document capabilities.
Document sample
Not provided. Document capability is unsupported. Shared chain: map → media → text. Accept maps on Showcase map (full-web), not as a docs live sample.
Evidence anchors
| Item | Value |
|---|---|
| Registry | packages/aup/src/aup-types.ts · AUP_PRIMITIVES |
| Document caps | providers/runtime/web-device/src/device-caps.ts · DEVICE_CAPS_DOCUMENT |
| Degradation | packages/aup/src/degradation.ts · DEGRADATION_CHAINS |
| Internal matrix | docs/aup/capability-matrix.md (internal, non-routed) |
| Taxonomy hub | Primitive taxonomy and evidence |
| Sample contract rules | Live examples: scope and contract |
Nearby pages
Deck path exception
Ordinary document pages do not embed a live map. A slides: true deck may keep a map progressive-enhance shell under DEVICE_CAPS_DECK (arc#4005 / #4011 + #4013). Tour demos are deck-scoped evidence only.