aurora-admin
eb25feedaf
【本次核心 · S6-P21】 - 族层数据：families.json + 44 份契约注入 family/familyRole/familyParams； data.json / data.js / site/details 同步。13 族 / 44 成员 / 35 独立 → 概念组件 79→48。 - 79 个 slug 全保留、集合逐一不变（铁律 5 对外承诺未破）；frameworks 仍 395 文件、薄壳仍 79。 - 归族判据为契约中可核对字段（semanticTypeCandidates 重叠 / anatomy 为同一骨架子集 / 变体维度同构 / doNotInvent 显式从属声明），每族 mergeBasis 写明依据，不按名字猜。 - 实现层合并（导航族端到端切片）：tools/gen-family-impl.mjs 从 5 端模板生成 TopMenu / SideMenu / MixedNavigation 共 15 文件，参数 direction=top|side|mixed； 三份 CSS md5 完全相同 = 一份样式表服务三个组件。 - 新增 tools/gen-families.mjs、tools/gen-family-impl.mjs、tools/verify-families.mjs、 tools/lib/family-model.mjs、tools/lib/family-impl/nav-menu/*.tpl。 【同时清掉此前已完成但未提交的批次】 生成物（data.json / data.js / site/sources / site/components 薄壳 / sitemap.xml / tests 报告） 跨阶段交织，无法拆成互相自洽的多个提交，故按既有批量风格合并提交： - Package：三端可 import（S5-P18）+ 发布到私有 npm 源 - Docs site：导航语言改下拉（S5-P19）、详情页代码块默认展开、中英切换完整性 - Security：生产部署链审计修复（2026-09-19）+ 线上部署 - Theme modes 日间/夜间/自动；S1-P4 data.js 瘦身；S2-P5 暗色；S2-P6 跨端一致性； S2-P7 行为断言；S2-P9 FAQ；S3-P8 RTL；S3-P9 契约缺口解释层；S4-P12 发布流程 - 补入 tools/pack-deploy.mjs、run-site-smoke.mjs、verify-*.mjs，.dockerignore、 安全审计修复与待决策项.md 【验收】 - node tools/verify-families.mjs → OK: 族层端到端一致（13 族 / 44 成员 / 79 组件不变 / 395 文件不变） - node tools/verify-cross-platform.mjs → 79/79 identical（HEAD 基线 high 44） - node tools/run-regression.mjs → 100%（79/79 页，1017/1017 断言，N/A 34），连跑 8 次一致，0 超时 - 逐页实测：topmenu / sidemenu / mixednavigation 各 13/13，帧内 direction 参数正确，0 JS 错误 - 零运行时依赖 OK；build-site.ps1 ASCII-only OK 【未纳入】site/components/<slug>/ 平台薄壳 316 个 —— 历史从未跟踪且属构建产物，保持现状。
2 lines
2.7 KiB
JSON
2 lines
2.7 KiB
JSON
{"slug":"card","contract":{"unknowns":["卡片网格间距规范"],"doNot":["整卡可点击","整卡 hover 位移/边框变化","整卡过渡时长","整卡键盘 focus 行为","卡片 hover 交互规范"],"structure":{"radius":"var(--radius-large)","border":"1px solid var(--color-border)","shadow":"var(--shadow-low)","padding":"16px / 24px"},"clarificationNotes":[{"item":"整卡可点击","kind":"decision","meaning":"整张卡片是否作为一个可点击整体。","why":"实现侧 Card.html 整卡无点击处理与 pointer 光标，只有内部链接/按钮可交互。","decision":"拍板：整卡不可点击；可交互内容必须用内部链接或按钮承载。"},{"item":"整卡 hover 位移/边框变化","kind":"decision","meaning":"鼠标悬停整卡时是否产生位移、边框或阴影之外的反馈。","why":"实现侧无整卡 hover 规则；规范只定义默认低阴影。","decision":"拍板：无整卡 hover 反馈；悬停中阴影仅为容器视觉层级，不代表可点击。"},{"item":"卡片 hover 交互规范","kind":"boundary","meaning":"指整张卡片在鼠标悬停和键盘聚焦时是否产生反馈，不是卡片内部链接或按钮自己的 hover 状态。","why":"现有规范只定义了卡片默认低阴影与悬停中阴影，没有定义整卡是否可点击、边框或位移变化、过渡时长、光标和键盘 focus 的完整状态矩阵。","decision":"已拍板：整卡不可点击、无整卡 hover；focus-visible 仅作用于卡片内部可聚焦元素。"},{"item":"卡片网格间距规范","kind":"open-question","meaning":"指同一栅格中相邻卡片之间的 gap，以及不同容器宽度下 gap 是否保持不变。","why":"通用规范只给出组件之间 16px/24px 的间距梯度，CardList 只说明采用栅格，没有给出卡片专用 gap、列数或响应式断点。","decision":"保持开放：需要确认 CardList 的默认 gap、列数和响应式断点后，才能把实现值升级为正式契约。"}],"variants":["边框卡片","阴影卡片","含标题与操作区"],"usage":["圆角8px，边框1px var(--color-border) 或低阴影","内边距16px/24px","结构：标题区、内容区、操作区"],"anatomy":{"container":"卡片容器：圆角8px，边框1px var(--color-border) 或低阴影","titleArea":"标题区：可含标题与右侧操作","contentArea":"内容区","actionArea":"操作区"},"dims":[{"name":"style","values":["bordered","shadowed"]},{"name":"padding","values":["16px","24px"]},{"name":"section","values":["title","content","actions"]}]},"specLines":["- 圆角8px，边框1px #E8ECF1 或低阴影","- 内边距16px/24px","- 结构：标题区、内容区、操作区"],"family":"card-shell","familyRole":"base","familyParams":{}}
|