document caps 与 deck caps

本 deck 使用 DEVICE_CAPS_DECK（arc#4005 / #4011 / #4012）。人工锁定（#4006）：仅 rtc 与 camera-preview 为硬排除；其它 surface 以 readonly + 作者数据 演示。普通文章仍会 chart→table、map→media 降级。

view — native

可移植容器。在 document 上，tabs / steps 是静态 UI chrome（仅切换面板——无 session、无 exec）。

text — native

普通 Markdown 正文是主要的 text 路径。Callout 在 document 上呈现为 text-admonition。

media — native

语义媒体节点（此处为 image 路径）。frame 的同源 / 白名单规则另表。

input — native

document 上的未绑定表单控件。输入只改浏览器控件——无 bind、session 或 AFS 写入。

action — native

document 上仅导航。无 exec，无静态样例上的破坏性确认。

overlay — deck 打开态 shell

本 deck 上的打开 dialog chrome（readonly）。Dismiss bus / session confirm 仍属交互目标。

table — native（GFM 路径）

GFM 表格在 document 目标上可渲染。页面需要数据时，优先手写表格。

time — partial

document 报告 partial。display 模式是静态快照，不是实时时钟。

此路径无连续客户端 ticker。clock / countdown 产品声明属于交互目标，且需重新验收。

chart — 季度 bar

map — 巴黎

calendar — 2026 年 8 月

chat — deck readonly + data

仅作者消息。输入栏禁用——无 session bus、无写入（人工 #4006）。

rtc — 排除（人工 #4006）

媒体权限与 peer session 不是 slideshow 产品演示。camera-preview widget 同理排除。

explorer — deck 静态树

仅作者 items——不是 path-backed AFS 浏览。

editor — native（experimental）

document 将 editor 渲染为本地 textarea。输入只留在浏览器——无 IDE、无 AFS 回写。

::editor{id="aup-tour-editor" language="json" label="示例片段" value="{ "ok": true }"}

Markdown 属性字符串不保证等于 AUP JSON 布尔（readOnly）。需要严格 props 时用 JSON/DSL。

canvas — deck 绘制 shell

宿主 + canvas；progressive enhance 启用本地画笔（无 AFS 持久化）。

surface — deck 宿主 shell

带标签的宿主区域 + children。分类：primitive surface ≠ wm-surface ≠ layout surface 目录。

afs-list — document（静态子节点）

document 可渲染列表 chrome。路径驱动的 live AFS 数据在公开 docs 上尚未闭环——仅用静态子节点。

• 静态行一 — 作为 document 子节点编写，非拉取。

• 静态行二 — 仍不是 AFS 路径证明。

无子节点时的 empty / loading chrome 见单元页；本导览只展示静态子节点路径。

Document 可承载 widget

Widget 不是 18 个跨设备 primitive。Deck SSR 现在为其中许多注册了 focused shell（arc#4012 / #4008 / #4009）。数组/对象 props 用 JSON 字符串 会做 coerce（与 chart/map 相同）。app-header 的嵌套 portal chrome 仍需要来自 DSL 的 object props。每页一类——MD + document 能展示则 live，不能则诚实标边界。

app-header — document shell

document 注册 app-header，并输出与交互路径相同的 .aup-app-header* chrome 类名。嵌套的 brand / nav / actions 需要 object props（Showcase / AUP DSL）。Markdown directive 的 attribute 恒为字符串，故本页只展示已注册 shell——不是完整 portal 顶栏。

单元页：app-header。Showcase：prim-app-header。

app-footer — document shell

document 渲染静态页脚。遗留的顶层 copyright 字符串对 MD 安全，可生成底栏。多列 brand / columns / social 需要 object props（与 header 相同的 MD 字符串限制）。

单元页：app-footer。Showcase：prim-app-footer。

ticker — document 静态

Document RENDERERS 强制 data-mode="static"：子节点以项目符号分隔——不是连续滚动 ticker。

交互的 scroll/flip 模式留在 web-full。单元页：ticker。

broadcast — document 静态 shell

Document RENDERERS 把 broadcast 当类 view 容器：子节点会渲染，共享频道 / 导播接线不会。

角色展开（live-badge、lower-third 等）属交互路径。单元页：broadcast。

deck — 本导览即宿主

本记录已是 deck：front matter slides: true + layout: slides 构建播放器。document 将 deck 报告为 partial 宿主 chrome——不是每页再嵌一套产品 deck。

你已在演示内部。单元页：deck。Markdown slides 指南：markdown-slides。

frame — document partial

经 AUP type: "frame" 的沙箱 iframe。信任边界与 embed 相同：http(s) 或白名单路径；未知/不安全 src 变为错误或链接回退。

::embed{url=…} 是 Markdown 写法，常编译成 frame 形节点。本页显式点名 widget 类型。document 能力为 partial。单元页：frame。

globe — 世界标记

Admonition（GFM callout）

与 text admonition 同路径——作为你在 Markdown 里直接写的作者表面再演示一次。

Steps（::::steps）

教程 chrome 落在 document 的 view 渲染上。外层 fence 必须包住每个 :::step。

1. 先命名目标

   先分清 document 与 web-full——再选目标已上报的 primitive。

2. 演示或标注

   native → live MD 样例。unsupported → 一张诚实的「不在 document」幻灯片。

YouTube partial

正文让 embed 保持 partial——普通 deck 内边距，无 data-media-fill。受支持提供方以沙箱 frame 嵌入；无法识别的 URL 保持为普通链接。

这是 frame / embed 路径——不是通用特权 iframe API。

GFM 表格（MD 结构）

document 需要数据时，用普通 Markdown 写表。本 deck 上的 live chart 是实验性独立节点（generic directive）——不是全站 MD chart 合同。不要用 GFM 表夹带 chart。

图片（Markdown 结构）

行内图片是有别于 ::media 的结构路径，但两者都是 document 可达的媒体呈现。

需要 caption / type 等 AUP 节点 props 时优先 ::media；普通文章插图用 ![alt](src)。

Link card + 导航 action

卡片是 Markdown 指令，与仅导航的 action 组合。

一个舞台 · 多种媒体模式

Deck 是 1280×720 媒体宿主，不只是散文卡片。

后续页：每页一种效果 — 视觉优先。

单张照片

Mosaic

Grid

Sized stage

Full-bleed · plates

Full-bleed · YouTube

Tweet clamp