原型文档覆盖索引
查找已实现原型家族的文档,区分导出、实验与待迁移缺口。
本索引将实现家族对应到读者文档。家族页同时记录其组成部件;源码文件、生成图标、authoring asHook、CLI facade 与编目身份不是同一种计数单位。选择 API 前应阅读对应页面的生命周期与宿主边界。包已发布不等于 draft P-* 实体已经转为 active。
如何阅读清单
Section titled “如何阅读清单”源码目录为 packages/prototypes/<library>/src/<family>。下面的部件标签标识源码文件,不定义新的导出命名:overlay 实现文档中的 Mask;Transition 的 as-transition 与 transition 属于同一协议。实际 import 以详情页和包导出为准。复合部件共用家族页,不以只有一句话的独立页制造虚假覆盖。
| 家族文档 | 源码部件 |
|---|---|
| Async Region | root |
| Button | button |
| Checkbox | indicator, root |
| Dialog | close, content, description, overlay, root, title, trigger |
| Dropdown Menu | content, item, root, trigger |
| Hover Card | content, root, trigger |
| Image | root |
| Input:文档 PR #812 | root |
| Live Region | root |
| Radio Group | indicator, item, root |
| Scroll Area | root, scrollbar, thumb, viewport |
| Select | content, item, root, trigger, value |
| Separator | root |
| Switch | root, thumb |
| Table | caption, cell, header-cell, root, row |
| Tabs | content, indicator, list, root, trigger |
| Textarea | root |
| Toggle | toggle |
| Tooltip | content, group, root, trigger |
| Transition | as-transition, transition |
bootstrap-2-3-2
Section titled “bootstrap-2-3-2”| 家族文档 | 源码部件 |
|---|---|
| Button | button |
brutalist
Section titled “brutalist”| 家族文档 | 源码部件 |
|---|---|
| Badge | root |
| Button | button |
| Card | content, footer, header, root |
| Checkbox | indicator, root |
| Dialog | close-icon, close, content, description, footer, header, overlay, root, title, trigger |
| Dropdown Menu | content, item, root, trigger |
| Hover Card | content, root, trigger |
| Scroll Area | root, scrollbar, thumb, viewport |
| Select | content, item, root, trigger, value |
| Separator | root |
| Skeleton | root |
| Spinner | root |
| Switch | root, thumb |
| Tabs | content, list, root, trigger |
| Textarea | root |
| Toggle | toggle |
| Tooltip | content, group, root, trigger |
liquid-glass
Section titled “liquid-glass”| 家族文档 | 源码部件 |
|---|---|
| Button | button |
lucide
Section titled “lucide”| 家族文档 | 源码部件 |
|---|---|
| Icons | icon |
逐图标生成导出是 P-LUCIDE-ICON 的特化,由可搜索图标目录记录。manifest、snippets、loaders 是工具数据,不是新增协议。
shadcn
Section titled “shadcn”| 家族文档 | 源码部件 |
|---|---|
| Button | button |
| Checkbox | indicator, root |
| Dialog | close-icon, close, content, description, footer, header, overlay, root, title, trigger |
| Dropdown Menu | content, item, root, trigger |
| Hover Card | content, root, trigger |
| Input | root |
| Radio Group | indicator, item, root |
| Scroll Area | root, scrollbar, thumb, viewport |
| Select | content, item, root, trigger, value |
| Separator | root |
| Switch | root, thumb |
| Tabs | content, list, root, trigger |
| Textarea | root |
| Toggle | toggle |
| Tooltip | content, group, root, trigger |
当前工作区新增被动原子
Section titled “当前工作区新增被动原子”Text 与 Surface 页面记录 PR #777 实际增加的可复用工作区原子。它们的名称与输入可复用,首页只是一个消费者;以下家族保持 draft,各自页面分别列出 Adapter/Compiler 限制。
- base: Text, Surface
- shadcn: Text, Surface
- brutalist: Text, Surface
- bootstrap-2-3-2: Surface
- liquid-glass: Surface
分支新增项与缺口
Section titled “分支新增项与缺口”本节是 2026-10-04 的审计检查点,不是发布公告。main 基线为 d4bdb66b54d68625fb3da1109a76e0829c1e77d7;后续集成与精确提交验证请查看所链接 PR。
- Base Input 在该基线已有源码和编目归属,但缺少 Base 详情路由。PR #812 补充双语 API 页面和真实的四种 Web runtime 预览;Shadcn Input 页面不能代替 Base 协议文档。
- PR #808 增加 Bootstrap Checkbox Root/Indicator、Switch Root/Thumb、Toggle、Input、Textarea、Separator。六个新增家族页覆盖八个新增部件,加上 Button 共七类组件、九个部件,仍是部分 draft 家族;上面的 main 基线表不会提前把这些条目当成已集成。
- Material 实验 单独记录 PR #809 的
experimental-owned-material-button,不与现有 stage-0 Liquid Glass Button 混淆。它不是已发布的库导出,也不代表通用 Compiler 支持。 - PR #777 曾引入五个
site-*定义;当前工作区用可复用 Text/Surface 与既有 Lucide 组合替代。三个 image-zoom 定义(两个继承自 main,一个新增)也由后续依赖移除。文档图片预览改为组合已有 Button/Dialog owner 与公开 Surface 绘制,不准入页面专用 API;日期审计保留精确源码身份和迁移检查点。
让新增原型同时进入文档
Section titled “让新增原型同时进入文档”每新增一个身份或部件,都应在对应家族页补齐 import、anatomy、输入、可观察输出、生命周期与明确不支持的范围,并从库入口或贡献入口连接可到达页面。真实 runtime 示例必须 import 已实现的公开表面;不要为制造 Demo 而注册不存在的原型。Adapter 执行与 Compiler 准入应分别陈述;明确拒绝的诊断不等于编译成功。
网站源码审计也检查包外定义与实验,避免它们藏在公开导出检查之外。对不支持或页面专用的实现记录有界缺口,再由受治理原子或既有组合替代。apps/www/docs/prototype-coverage-audit-2026-10-04.md 保存了已检查的精确提交与迁移对象。