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
1.7 KiB
JSON
2 lines
1.7 KiB
JSON
{"slug":"themeswitcher","contract":{"unknowns":[],"doNot":["暗色令牌的具体取值（见 colors_and_type.css 的 html.aa-dark）"],"structure":{"modes":"日间 / 夜间 / 自动","brand":"6 预设色 + 自定义色板","persist":"localStorage（见 unknowns 键名说明）"},"clarificationNotes":[{"item":"预设品牌色清单","kind":"decision","meaning":"组件内置的 6 个品牌预设色。","why":"H5/React/Vue2/Vue3 四端实现一致：#2F54EB #1677FF #722ED1 #13C2C2 #FA541C #EB2F96。","decision":"拍板：升为正式契约；新增预设需同步四端实现与本契约。"},{"item":"偏好保存的位置（localStorage 键名）","kind":"decision","meaning":"模式与品牌色的持久化键。","why":"实现现状：组件端用 aa-mode 存 light/dark/auto；文档站用 aa-theme 存品牌色对象。","decision":"拍板：按实现现状写入契约；组件宿主不得要求文档站键名，文档站不得要求组件读 aa-theme。"}],"variants":["浅色 + 默认品牌蓝","深色主题","跟随系统 + 自定义品牌色"],"usage":["明暗主题","品牌色切换","实时预览","保存偏好","适用于个性化"],"anatomy":{"mode":"日间 / 夜间 / 自动主题","brand":"品牌色切换（6 预设 + 自定义）","preview":"实时预览","persist":"保存偏好（组件 aa-mode 存模式；文档站 aa-theme 存品牌色）"},"dims":[{"name":"mode","values":["light","dark","auto"]},{"name":"brandColor","values":["#2F54EB","#1677FF","#722ED1","#13C2C2","#FA541C","#EB2F96","custom"]}]},"specLines":["- 明暗主题","- 品牌色切换","- 实时预览","- 保存偏好","- 适用于个性化"],"family":"preference-switcher","familyRole":"base","familyParams":{"extra":"brand-palette","applyScope":"global"}}
|