feat(S6-P21): 组件族参数化(13族/44成员/导航族15文件同源/79→48概念组件)

【本次核心 · 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 个 —— 历史从未跟踪且属构建产物,保持现状。
This commit is contained in:
aurora-admin
2026-09-20 03:32:31 +08:00
parent 7e3d442dab
commit eb25feedaf
372 changed files with 16928 additions and 12810 deletions
+98 -37
View File
@@ -1,52 +1,113 @@
<template>
<div class="aa-mixed">
<div class="aa-mixed-top">
<div
v-for="(m, i) in menu"
:key="i"
class="aa-mixed-topitem"
:class="{ 'is-active': topIdx === i }"
@click="selectTop(i)"
>{{ m.name }}</div>
</div>
<div class="aa-mixed-body">
<div class="aa-mixed-side">
<div
v-for="(it, i) in menu[topIdx].items"
:key="i"
class="aa-mixed-sideitem"
:class="{ 'is-active': sideIdx === i }"
@click="sideIdx = i"
>{{ it.name }}</div>
</div>
<div class="aa-mixed-content">
<h4>{{ menu[topIdx].name }} / {{ menu[topIdx].items[sideIdx].name }}</h4>
<div>{{ menu[topIdx].items[sideIdx].desc }}</div>
<nav class="aa-menu" :data-direction="params.direction" :data-collapsed="collapsedAttr" aria-label="主菜单">
<div v-if="params.direction === 'mixed'" class="aa-menu-top">
<div v-for="it in items" :key="it.key" class="aa-menu-item" :class="itemClass(it)"
role="menuitem" tabindex="0" @click="select(it)">
<span v-if="it.icon" class="aa-menu-icon">{{ it.icon }}</span>
<span class="aa-menu-label">{{ it.label }}</span>
<span v-if="it.badge" class="aa-menu-badge">{{ it.badge }}</span>
</div>
</div>
</div>
<div v-if="params.direction === 'mixed'" class="aa-menu-side">
<div v-for="it in sideItems" :key="it.key" class="aa-menu-item" :class="itemClass(it)"
role="menuitem" tabindex="0" @click="select(it)">
<span class="aa-menu-label">{{ it.label }}</span>
</div>
</div>
<template v-if="params.direction !== 'mixed'">
<div v-for="it in items" :key="it.key" class="aa-menu-item" :class="itemClass(it)"
role="menuitem" tabindex="0" :aria-expanded="hasKids(it) ? String(open === it.key) : undefined"
@click="select(it)">
<span v-if="it.icon" class="aa-menu-icon">{{ it.icon }}</span>
<span class="aa-menu-label">{{ it.label }}</span>
<span v-if="it.badge" class="aa-menu-badge">{{ it.badge }}</span>
<span v-if="hasKids(it) && params.direction !== 'top'" class="aa-menu-arrow">›</span>
<div v-if="hasKids(it) && params.direction !== 'mixed'" class="aa-menu-children">
<div v-for="c in it.children" :key="c.key" class="aa-menu-item" :class="itemClass(c)"
role="menuitem" tabindex="0" @click.stop="select(c)">
<span class="aa-menu-label">{{ c.label }}</span>
</div>
</div>
</div>
</template>
<div v-if="popItem" class="aa-menu-pop">
<div class="aa-menu-pop-title">{{ popItem.label }}</div>
<div v-for="c in popItem.children" :key="c.key" class="aa-menu-item" :class="itemClass(c)"
role="menuitem" tabindex="0" @click="select(c)">
<span class="aa-menu-label">{{ c.label }}</span>
</div>
</div>
</nav>
</template>
<script>
/* Aurora Admin Menu 族 · MixedNavigation(Vue 2)
* @generated by tools/gen-family-impl.mjs
* 生成物 - 由 tools/gen-family-impl.mjs 从族模板生成,请勿手改。
* 族 nav-menu:本组件是同一份 Menu 实现,参数 direction=mixed。
* 族参数取值:direction=mixed, level=2, collapsed=false
* 重跑生成:node tools/gen-family-impl.mjs nav-menu
*/
var FAMILY_DIRECTION = 'mixed';
var FAMILY_PARAMS = { direction: FAMILY_DIRECTION, collapsed: false };
export default {
name: 'AaMixedNavigation',
props: {
menu: {
type: Array,
default: () => [
{ name: '工作台', items: [{ name: '概览', desc: '数据看板总览' }, { name: '待办', desc: '我的待处理任务' }, { name: '报表', desc: '统计报表入口' }] },
{ name: '系统管理', items: [{ name: '用户管理', desc: '用户增删改查' }, { name: '角色管理', desc: '角色与权限分配' }, { name: '菜单管理', desc: '导航菜单配置' }] },
{ name: '业务中心', items: [{ name: '订单', desc: '订单列表与详情' }, { name: '商品', desc: '商品上下架' }, { name: '库存', desc: '库存预警' }] }
]
items: { type: Array, default: function () { return []; } },
activeKey: { type: String, default: '' }
},
data: function () {
return {
params: FAMILY_PARAMS,
active: this.activeKey,
open: '',
collapsed: FAMILY_PARAMS.collapsed === true
};
},
computed: {
collapsedAttr: function () {
return this.params.direction === 'side' ? String(this.collapsed) : undefined;
},
sideItems: function () {
var self = this;
var current = this.items.filter(function (x) { return self.isTopActive(x); })[0] || this.items[0];
return (current && current.children) || [];
},
popItem: function () {
var self = this;
if (this.params.direction !== 'side' || !this.collapsed) return null;
return this.items.filter(function (x) { return x.key === self.open; })[0] || null;
}
},
data() {
return { topIdx: 0, sideIdx: 0 };
},
methods: {
selectTop(i) {
this.topIdx = i;
this.sideIdx = 0;
hasKids: function (it) {
return !!(it.children && it.children.length);
},
isTopActive: function (it) {
if (it.key === this.active) return true;
return (it.children || []).some(function (c) { return c.key === this.active; }, this);
},
itemClass: function (it) {
return [
it.key === this.active ? 'is-active' : '',
it.disabled ? 'is-disabled' : '',
this.hasKids(it) && it.key === this.open ? 'is-open' : ''
];
},
select: function (it) {
if (it.disabled) return;
if (this.hasKids(it)) {
this.open = this.open === it.key ? '' : it.key;
if (this.params.direction === 'mixed') this.active = it.key;
return;
}
this.active = it.key;
this.$emit('update:activeKey', it.key);
this.$emit('change', it.key);
}
}
};