explorer 是 AUP 跨设备 primitive,不是 Web Device 的 layout 组件,也不是 Web-only widget。它属于 AUP_PRIMITIVES 中的 18 个名称之一,并出现在每个 target 的 DeviceCaps.primitives map 中(取值为 native、webview、partial 或 unsupported)。
合同
| 字段 | 值 |
|---|---|
| Primitive 名称 | explorer |
| 层级 | AUP 跨设备 primitive(AUP_PRIMITIVES) |
| 公共状态 | unsupported (document) |
| Document 能力 | unsupported |
| 共享 degradation chain | 无共享 chain(透传 / unknown 处理) |
| 作者入口 | 交互 target 上的 AUP 组合(常为 afs-list + widgets) |
| Document renderer / 备注 | Document RENDERERS: none for explorer; Showcase composes primitives/widgets |
| Showcase 证据 | blocklets/showcase-dsl/.aup/pages/explorer.aup |
何时使用
用声明式 select/navigate 重定向做 IDE 风格目录浏览器组合。
何时不要使用
不要把 explorer 当成单个 layout 组件。document 没有 native explorer renderer。
Document sample
不提供。 document 能力为 unsupported。Explorer 演示是多节点组合(见 Showcase explorer),需要交互数据路径。列表半边见 afs-list——本站仍无闭环 live 数据合同。
证据锚点
| 项 | 值 |
|---|---|
| 注册表 | 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 示例:范围与合同 |