map 是 AUP 跨设备 primitive，不是 Web Device 的 layout 组件，也不是 Web-only widget。它属于 AUP_PRIMITIVES 中的 18 个名称之一，并出现在每个 target 的 DeviceCaps.primitives map 中（取值为 native、webview、partial 或 unsupported）。
合同
| 字段 | 值 |
|---|---|
| Primitive 名称 | map |
| 层级 | AUP 跨设备 primitive（AUP_PRIMITIVES） |
| 公共状态 | unsupported (document) |
| Document 能力 | unsupported |
| 共享 degradation chain | map → media → text |
| 作者入口 | full-web 上的 AUP/DSL（Showcase 中 Leaflet / MapLibre） |
| Document renderer / 备注 | No document native map renderer; chain applies |
| Showcase 证据 | blocklets/showcase-dsl/.aup/pages/map.aup |
何时使用
在报告支持 map 的 target 上做交互地图/地球 UI。
何时不要使用
不要在静态文档嵌入 live map。瓦片 CDN 与 JS map 栈不是 document 能力。
Document sample
不提供。 document 能力为 unsupported。共享 chain：map → media → text。在 Showcase map（full-web）验收地图，不要作为文档 live sample。
证据锚点
| 项 | 值 |
|---|---|
| 注册表 | 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 |
| 内部矩阵 | docs/aup/capability-matrix.md（内部，不对外路由） |
| Taxonomy hub | Primitive 类型分类与证据 |
| Sample 合同规则 | Live 示例：范围与合同 |
相关页面
Deck 路径例外
普通 document 页不嵌入 live map。slides: true deck 可在 DEVICE_CAPS_DECK 下保留 map progressive-enhance shell（arc#4005 / #4011 + #4013）。tour 演示仅作 deck 证据。