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 个 —— 历史从未跟踪且属构建产物，保持现状。
2026-09-20 03:32:31 +08:00
parent 7e3d442dab
commit eb25feedaf
372 changed files with 16928 additions and 12810 deletions
@@ -1,17 +1,187 @@
-/* Aurora Admin TopMenu 样式 — 对齐 组件7.txt TopMenu：水平导航，选中态底部 2px 品牌色指示条，支持多级下拉 */
+/* Aurora Admin Menu 族样式 — 由 tools/gen-family-impl.mjs 从族模板生成，勿手改。
+ *
+ * @generated by tools/gen-family-impl.mjs
+ * 族：nav-menu（基座 Menu + direction 参数）。
+ * 本文件服务：sidemenu / topmenu / mixednavigation。
+ *
+ * 三个组件的 CSS 是同一份样式表 —— 差异全部由根元素的 data-direction /
+ * data-collapsed 参数表达，不再各自手写一遍。改样式请改模板后重跑生成器：
+ *   node tools/gen-family-impl.mjs nav-menu
+ */

-.aa-topmenu { display: flex; background: var(--au-color-card-bg); border-bottom: 1px solid var(--au-color-border); padding: 0 8px;
-  font-family: var(--font-family, -apple-system, "PingFang SC", "Microsoft YaHei", sans-serif); }
-.aa-topmenu-item { position: relative; display: flex; align-items: center; gap: 6px; height: 48px;
-  padding: 0 16px; cursor: pointer; color: var(--au-color-text-body); font-size: 14px; white-space: nowrap; }
-.aa-topmenu-item:hover { color: var(--au-color-brand); }
-.aa-topmenu-item.is-active { color: var(--au-color-brand); font-weight: 500; }
-.aa-topmenu-item.is-active::after { content: ''; position: absolute; left: 12px; right: 12px; bottom: 0; height: 2px; background: var(--au-color-brand); }
-.aa-topmenu-badge { background: var(--au-color-error); color: var(--au-color-text-inverse); font-size: 11px; line-height: 1; border-radius: 8px; padding: 2px 5px; }
-.aa-topmenu-caret { font-size: 10px; color: var(--au-color-text-secondary); }
-.aa-topmenu-dropdown { position: absolute; top: 48px; left: 0; min-width: 160px; background: var(--au-color-card-bg);
-  border: 1px solid var(--au-color-border); border-radius: 6px; box-shadow: 0 4px 12px rgba(0,0,0,0.08); padding: 4px; display: none; z-index: 50; }
-.aa-topmenu-item:hover > .aa-topmenu-dropdown { display: block; }
-.aa-topmenu-sub { display: block; padding: 8px 12px; font-size: 13px; color: var(--au-color-text-body); border-radius: 4px; }
-.aa-topmenu-sub:hover { background: var(--au-color-brand-bg); color: var(--au-color-brand); }
-.aa-topmenu-sub.is-active { color: var(--au-color-brand); background: var(--au-color-brand-bg); }
+/* ---------- 基础：方向无关 ---------- */
+.aa-menu {
+  font-family: var(--font-family, -apple-system, "PingFang SC", "Microsoft YaHei", sans-serif);
+  color: var(--au-color-text-body);
+  background: var(--au-color-card-bg);
+  user-select: none;
+}
+
+.aa-menu-item {
+  position: relative;
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  cursor: pointer;
+  font-size: 14px;
+  color: var(--au-color-text-body);
+  transition: background .15s, color .15s, border-color .15s;
+}
+.aa-menu-item:hover { background: var(--au-color-page-bg); }
+.aa-menu-item.is-active { color: var(--au-color-brand); font-weight: 500; }
+.aa-menu-item.is-disabled { color: var(--au-color-text-disabled); cursor: not-allowed; }
+.aa-menu-item.is-disabled:hover { background: none; }
+
+.aa-menu-icon { width: 16px; text-align: center; flex-shrink: 0; font-size: 15px; }
+.aa-menu-label { flex: 1; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+.aa-menu-badge {
+  background: var(--au-color-error);
+  color: var(--au-color-text-inverse);
+  font-size: 11px;
+  min-width: 16px;
+  height: 16px;
+  border-radius: var(--au-radius-large);
+  padding: 0 5px;
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+}
+.aa-menu-arrow { color: var(--au-color-text-secondary); font-size: 12px; transition: transform .15s; }
+.aa-menu-item.is-open > .aa-menu-arrow { transform: rotate(90deg); }
+
+.aa-menu-children { background: var(--au-color-table-header-bg); }
+.aa-menu-children .aa-menu-item { height: 40px; padding-inline-start: 40px; font-size: 13px; }
+
+/* 折叠态悬浮浮层（side 方向专用） */
+.aa-menu-pop {
+  position: absolute;
+  inset-inline-start: 56px;
+  top: 0;
+  min-width: 180px;
+  background: var(--au-color-card-bg);
+  border: 1px solid var(--au-color-border);
+  border-radius: var(--au-radius-medium);
+  box-shadow: var(--au-shadow-medium, 0 4px 12px rgba(0, 0, 0, .12));
+  padding: 4px 0;
+  z-index: 200;
+}
+.aa-menu-pop-title { padding: 6px 16px; font-size: 12px; color: var(--au-color-text-secondary); }
+.aa-menu-pop .aa-menu-item { height: 40px; padding: 0 16px; }
+
+/* ---------- direction=top：水平导航，选中态底部指示条 ---------- */
+.aa-menu[data-direction="top"] {
+  display: flex;
+  align-items: stretch;
+  border-bottom: 1px solid var(--au-color-border);
+  padding: 0 8px;
+}
+.aa-menu[data-direction="top"] > .aa-menu-item { height: 48px; padding: 0 16px; }
+.aa-menu[data-direction="top"] > .aa-menu-item:hover { background: none; color: var(--au-color-brand); }
+.aa-menu[data-direction="top"] > .aa-menu-item.is-active::after {
+  content: '';
+  position: absolute;
+  inset-inline: 12px;
+  bottom: 0;
+  height: 2px;
+  background: var(--au-color-brand);
+}
+/* top 方向的下拉：绝对定位面板，hover / focus-within 展开（键盘同样可达） */
+.aa-menu[data-direction="top"] .aa-menu-children {
+  position: absolute;
+  top: 100%;
+  inset-inline-start: 0;
+  display: none;
+  min-width: 160px;
+  background: var(--au-color-card-bg);
+  border: 1px solid var(--au-color-border);
+  border-radius: var(--au-radius-medium);
+  box-shadow: var(--au-shadow-medium, 0 4px 12px rgba(0, 0, 0, .08));
+  padding: 4px;
+  z-index: 50;
+}
+.aa-menu[data-direction="top"] .aa-menu-item:hover > .aa-menu-children,
+.aa-menu[data-direction="top"] .aa-menu-item:focus-within > .aa-menu-children { display: block; }
+.aa-menu[data-direction="top"] .aa-menu-children .aa-menu-item {
+  height: auto;
+  padding: 8px 12px;
+  font-size: 13px;
+  border-radius: var(--au-radius-small);
+}
+.aa-menu[data-direction="top"] .aa-menu-children .aa-menu-item:hover {
+  background: var(--au-color-brand-bg);
+  color: var(--au-color-brand);
+}
+.aa-menu[data-direction="top"] .aa-menu-children .aa-menu-item.is-active {
+  background: var(--au-color-brand-bg);
+}
+
+/* ---------- direction=side：侧边栏，选中态品牌底 + 侧指示条 ---------- */
+.aa-menu[data-direction="side"] {
+  width: 220px;
+  border-inline-end: 1px solid var(--au-color-border);
+}
+.aa-menu[data-direction="side"] > .aa-menu-item { height: 44px; padding: 0 16px; }
+.aa-menu[data-direction="side"] > .aa-menu-item.is-active { background: var(--au-color-brand-bg); }
+.aa-menu[data-direction="side"] > .aa-menu-item.is-active::before {
+  content: '';
+  position: absolute;
+  inset-inline-start: 0;
+  top: 0;
+  bottom: 0;
+  width: 3px;
+  background: var(--au-color-brand);
+}
+
+/* ---------- direction=mixed：顶部一级 + 侧边二级 ---------- */
+.aa-menu[data-direction="mixed"] {
+  border: 1px solid var(--au-color-border);
+  border-radius: var(--au-radius-large);
+  overflow: hidden;
+}
+.aa-menu[data-direction="mixed"] > .aa-menu-top {
+  display: flex;
+  gap: 4px;
+  border-bottom: 1px solid var(--au-color-border);
+  padding: 0 8px;
+}
+.aa-menu[data-direction="mixed"] > .aa-menu-top > .aa-menu-item { height: 48px; padding: 0 16px; }
+.aa-menu[data-direction="mixed"] > .aa-menu-top > .aa-menu-item:hover { background: none; }
+.aa-menu[data-direction="mixed"] > .aa-menu-top > .aa-menu-item.is-active::after {
+  content: '';
+  position: absolute;
+  inset-inline: 12px;
+  bottom: 0;
+  height: 2px;
+  background: var(--au-color-brand);
+}
+.aa-menu[data-direction="mixed"] > .aa-menu-side {
+  width: 168px;
+  min-height: 200px;
+  background: var(--au-color-table-header-bg);
+  border-inline-end: 1px solid var(--au-color-border);
+  padding: 8px 0;
+}
+.aa-menu[data-direction="mixed"] > .aa-menu-side > .aa-menu-item { height: 40px; padding: 0 16px; }
+.aa-menu[data-direction="mixed"] > .aa-menu-side > .aa-menu-item.is-active {
+  background: var(--au-color-brand-bg);
+}
+.aa-menu[data-direction="mixed"] > .aa-menu-side > .aa-menu-item.is-active::before {
+  content: '';
+  position: absolute;
+  inset-inline-start: 0;
+  top: 0;
+  bottom: 0;
+  width: 3px;
+  background: var(--au-color-brand);
+}
+
+/* ---------- 参数：collapsed（仅 side 方向生效） ---------- */
+.aa-menu[data-direction="side"][data-collapsed="true"] { width: 56px; }
+.aa-menu[data-direction="side"][data-collapsed="true"] .aa-menu-label,
+.aa-menu[data-direction="side"][data-collapsed="true"] .aa-menu-badge,
+.aa-menu[data-direction="side"][data-collapsed="true"] .aa-menu-arrow { display: none; }
+.aa-menu[data-direction="side"][data-collapsed="true"] > .aa-menu-item { justify-content: center; padding: 0; }
+.aa-menu[data-direction="side"][data-collapsed="true"] > .aa-menu-item.is-active::before { display: none; }
+
+/* 嵌套 children 的层级缩进（side 方向展开时） */
+.aa-menu[data-direction="side"] > .aa-menu-item > .aa-menu-children .aa-menu-item.is-active::before { display: none; }
@@ -3,53 +3,159 @@
 <head>
  <meta charset="UTF-8" />
  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-  <title>Aurora Admin · TopMenu（普通 H5）</title>
+  <title>Aurora Admin · TopMenu（顶部菜单，普通 H5）</title>
  <link rel="stylesheet" href="../.design_library/aurora-admin/colors_and_type.css" />
  <link rel="stylesheet" href="TopMenu.css" />
+  <style>
+    body { margin: 0; padding: 16px; background: var(--au-color-page-bg); }
+    p { font-size: 13px; color: var(--au-color-text-secondary); margin: 0 0 8px; }
+    .demo-block { margin-bottom: 20px; }
+  </style>
 </head>
 <body>
-  <div class="aa-topmenu" role="navigation" id="app"></div>
+  <!--
+    Aurora Admin Menu 族 · TopMenu
+    @generated by tools/gen-family-impl.mjs
+    生成物 — 由 tools/gen-family-impl.mjs 从族模板生成，请勿手改。
+    族 nav-menu：本页是同一份 Menu 实现，参数 direction=top。
+    族参数取值：direction=top, indicator=top, collapsed=false
+    重跑生成：node tools/gen-family-impl.mjs nav-menu
+  -->
+  <p>默认态（选中：全部订单）</p>
+  <div class="demo-block">
+    <nav class="aa-menu" id="menu-default" role="navigation" aria-label="主菜单"></nav>
+  </div>
+
+  <p>含徽章与禁用项</p>
+  <div class="demo-block">
+    <nav class="aa-menu" id="menu-badge" role="navigation" aria-label="带徽章的主菜单"></nav>
+  </div>
+
+  <p>下拉展开态（订单 → 子项）</p>
+  <div class="demo-block">
+    <nav class="aa-menu" id="menu-alt" role="navigation" aria-label="主菜单替代形态"></nav>
+  </div>

  <script>
-    var DATA = [
-      { label: '工作台', key: 'home' },
-      { label: '订单', key: 'order', badge: '3', children: [
-        { label: '全部订单', key: 'order-all' },
-        { label: '待发货', key: 'order-ship' },
-        { label: '退款', key: 'order-refund' }
+  (function () {
+    /* 族参数：本组件在 nav-menu 族中的取值（由生成器写入，勿手改） */
+    var FAMILY_DIRECTION = 'top';
+    var PARAMS = { direction: FAMILY_DIRECTION, collapsed: false };
+
+    var ITEMS = [
+      { key: 'home', label: '工作台', icon: '⊞' },
+      { key: 'order', label: '订单', icon: '≡', badge: '3', children: [
+        { key: 'order-all', label: '全部订单' },
+        { key: 'order-ship', label: '待发货' },
+        { key: 'order-refund', label: '退款' }
      ] },
-      { label: '商品', key: 'goods', children: [
-        { label: '商品列表', key: 'goods-list' },
-        { label: '分类管理', key: 'goods-cat' }
+      { key: 'goods', label: '商品', icon: '◇', children: [
+        { key: 'goods-list', label: '商品列表' },
+        { key: 'goods-cat', label: '分类管理' }
      ] },
-      { label: '数据', key: 'data' },
-      { label: '设置', key: 'setting' }
+      { key: 'data', label: '数据', icon: '▤' },
+      { key: 'setting', label: '设置', icon: '⚙', disabled: true }
    ];
-    var active = 'order-all';

-    function render() {
-      var root = document.getElementById('app');
-      root.innerHTML = DATA.map(function (it) {
-        var subs = (it.children || []).map(function (s) {
-          return '<a class="aa-topmenu-sub ' + (s.key === active ? 'is-active' : '') + '" role="navigation" data-key="' + s.key + '">' + s.label + '</a>';
-        }).join('');
-        var dropdown = it.children ? '<div class="aa-topmenu-dropdown" role="navigation">' + subs + '</div>' : '';
-        var badge = it.badge ? '<span class="aa-topmenu-badge">' + it.badge + '</span>' : '';
-        var caret = it.children ? '<span class="aa-topmenu-caret">▾</span>' : '';
-        var topActive = it.key === active || (it.children || []).some(function (s) { return s.key === active; });
-        return '<div class="aa-topmenu-item ' + (topActive ? 'is-active' : '') + '" role="menuitem" tabindex="0" data-key="' + it.key + '">' +
-          '<span>' + it.label + '</span>' + badge + caret + dropdown + '</div>';
-      }).join('');
+    /* 单一实现对三种 direction 通用：
+       top   -> 一级水平排布，children 走下拉面板
+       side  -> 一级纵向排布，children 内联展开（collapsed 时走悬浮浮层）
+       mixed -> 一级在顶部，二级为当前一级的 children，纵向排在侧栏 */
+    function createMenu(root, params, initial) {
+      var state = {
+        active: (initial && initial.active) || '',
+        open: (initial && initial.open) || '',
+        collapsed: params.collapsed === true || params.collapsed === 'true',
+        hoverKey: ''
+      };

-      root.querySelectorAll('[data-key]').forEach(function (el) {
-        el.addEventListener('click', function (e) {
-          e.stopPropagation();
-          active = el.dataset.key;
-          render();
+      function isTopActive(it) {
+        if (it.key === state.active) return true;
+        return (it.children || []).some(function (c) { return c.key === state.active; });
+      }
+
+      function itemHtml(it, level) {
+        var active = it.key === state.active ? ' is-active' : '';
+        var disabled = it.disabled ? ' is-disabled' : '';
+        var hasKids = !!(it.children && it.children.length);
+        var open = hasKids && it.key === state.open ? ' is-open' : '';
+        var kids = hasKids && params.direction !== 'mixed'
+          ? '<div class="aa-menu-children">' + it.children.map(function (c) { return itemHtml(c, level + 1); }).join('') + '</div>'
+          : '';
+        var icon = it.icon ? '<span class="aa-menu-icon">' + it.icon + '</span>' : '';
+        var badge = it.badge ? '<span class="aa-menu-badge">' + it.badge + '</span>' : '';
+        var arrow = hasKids && params.direction !== 'top'
+          ? '<span class="aa-menu-arrow">›</span>'
+          : '';
+        return '<div class="aa-menu-item' + active + disabled + open + '"' +
+          ' role="menuitem" tabindex="0" data-key="' + it.key + '"' +
+          (hasKids ? ' aria-expanded="' + (it.key === state.open ? 'true' : 'false') + '"' : '') +
+          '>' + icon + '<span class="aa-menu-label">' + it.label + '</span>' + badge + arrow + kids + '</div>';
+      }
+
+      function popHtml() {
+        if (params.direction !== 'side' || !state.collapsed || !state.hoverKey) return '';
+        var it = ITEMS.filter(function (x) { return x.key === state.hoverKey; })[0];
+        if (!it || !it.children) return '';
+        return '<div class="aa-menu-pop">' +
+          '<div class="aa-menu-pop-title">' + it.label + '</div>' +
+          it.children.map(function (c) { return itemHtml(c, 1); }).join('') +
+          '</div>';
+      }
+
+      function bodyHtml() {
+        if (params.direction !== 'mixed') {
+          return ITEMS.map(function (it) { return itemHtml(it, 0); }).join('');
+        }
+        var current = ITEMS.filter(function (x) { return isTopActive(x); })[0] || ITEMS[0];
+        var side = (current.children || []).map(function (c) { return itemHtml(c, 1); }).join('');
+        return '<div class="aa-menu-top">' +
+            ITEMS.map(function (it) { return itemHtml(it, 0); }).join('') +
+          '</div>' +
+          '<div class="aa-menu-side">' + side + '</div>';
+      }
+
+      function render() {
+        root.setAttribute('data-direction', params.direction);
+        if (params.direction === 'side') {
+          root.setAttribute('data-collapsed', state.collapsed ? 'true' : 'false');
+        }
+        root.innerHTML = bodyHtml() + popHtml();
+        Array.prototype.forEach.call(root.querySelectorAll('[data-key]'), function (el) {
+          el.addEventListener('click', function (e) {
+            e.stopPropagation();
+            var key = el.getAttribute('data-key');
+            var isParent = ITEMS.some(function (it) { return it.key === key && it.children; });
+            if (isParent) {
+              state.open = state.open === key ? '' : key;
+              if (params.direction === 'mixed') state.active = key;
+            } else {
+              state.active = key;
+            }
+            render();
+          });
+          el.addEventListener('mouseenter', function () {
+            state.hoverKey = el.getAttribute('data-key');
+            if (params.direction === 'side' && state.collapsed) render();
+          });
+          el.addEventListener('mouseleave', function () {
+            if (params.direction === 'side' && state.collapsed) { state.hoverKey = ''; render(); }
+          });
        });
-      });
+      }
+
+      render();
+      return { render: render, state: state };
    }
-    render();
+
+    var defaults = PARAMS;
+    createMenu(document.getElementById('menu-default'), defaults, { active: 'order-all', open: '' });
+    createMenu(document.getElementById('menu-badge'), defaults, { active: 'goods-list', open: 'goods' });
+
+    /* 第三个用例展示本 direction 的差异能力 */
+    var altParams = Object.assign({}, PARAMS, {  });
+    createMenu(document.getElementById('menu-alt'), altParams, { active: 'order-all', open: 'order' });
+  })();
  </script>
 </body>
 </html>
@@ -1,46 +1,99 @@
 import React, { useState } from 'react';
 import './TopMenu.css';

+/* Aurora Admin Menu 族 · TopMenu（React）
+ * @generated by tools/gen-family-impl.mjs
+ * 生成物 - 由 tools/gen-family-impl.mjs 从族模板生成，请勿手改。
+ * 族 nav-menu：本组件是同一份 Menu 实现，参数 direction=top。
+ * 族参数取值：direction=top, indicator=top, collapsed=false
+ * 重跑生成：node tools/gen-family-impl.mjs nav-menu
+ */
+const FAMILY_DIRECTION = 'top';
+const FAMILY_PARAMS = { direction: FAMILY_DIRECTION, collapsed: false };
+
 export default function TopMenu({ items = [], activeKey = '', onChange }) {
  const [active, setActive] = useState(activeKey);
+  const [open, setOpen] = useState('');
+  const [hoverKey, setHoverKey] = useState('');
+  const [collapsed, setCollapsed] = useState(FAMILY_PARAMS.collapsed === true);
+
+  const params = FAMILY_PARAMS;
+  const isTopActive = (it) => it.key === active || (it.children || []).some((c) => c.key === active);

-  function isActive(it) {
-    if (it.key === active) return true;
-    return (it.children || []).some(s => s.key === active);
-  }
  function select(it) {
-    if (!it.children) {
-      setActive(it.key);
-      onChange && onChange(it.key);
+    if (it.disabled) return;
+    if (it.children && it.children.length) {
+      setOpen(open === it.key ? '' : it.key);
+      if (params.direction === 'mixed') setActive(it.key);
+      return;
    }
+    setActive(it.key);
+    onChange && onChange(it.key);
+  }
+
+  function renderItem(it) {
+    const hasKids = !!(it.children && it.children.length);
+    return (
+      <div
+        key={it.key}
+        className={
+          'aa-menu-item' +
+          (it.key === active ? ' is-active' : '') +
+          (it.disabled ? ' is-disabled' : '') +
+          (hasKids && it.key === open ? ' is-open' : '')
+        }
+        role="menuitem"
+        tabIndex={0}
+        aria-expanded={hasKids ? (it.key === open ? 'true' : 'false') : undefined}
+        onClick={() => select(it)}
+        onMouseEnter={() => params.direction === 'side' && setHoverKey(it.key)}
+        onMouseLeave={() => {
+          if (params.direction === 'side') setHoverKey('');
+        }}
+      >
+        {it.icon ? <span className="aa-menu-icon">{it.icon}</span> : null}
+        <span className="aa-menu-label">{it.label}</span>
+        {it.badge ? <span className="aa-menu-badge">{it.badge}</span> : null}
+        {hasKids && params.direction !== 'top' ? <span className="aa-menu-arrow">{'\u203A'}</span> : null}
+        {hasKids && params.direction !== 'mixed' ? (
+          <div className="aa-menu-children">{it.children.map((c) => renderItem(c))}</div>
+        ) : null}
+      </div>
+    );
+  }
+
+  function renderPop() {
+    if (params.direction !== 'side' || !collapsed || !hoverKey) return null;
+    const it = items.filter((x) => x.key === hoverKey)[0];
+    if (!it || !it.children) return null;
+    return (
+      <div className="aa-menu-pop">
+        <div className="aa-menu-pop-title">{it.label}</div>
+        {it.children.map((c) => renderItem(c))}
+      </div>
+    );
+  }
+
+  function renderBody() {
+    if (params.direction !== 'mixed') return items.map((it) => renderItem(it));
+    const current = items.filter((x) => isTopActive(x))[0] || items[0] || { children: [] };
+    return (
+      <React.Fragment>
+        <div className="aa-menu-top">{items.map((it) => renderItem(it))}</div>
+        <div className="aa-menu-side">{(current.children || []).map((c) => renderItem(c))}</div>
+      </React.Fragment>
+    );
  }

  return (
-    <div className="aa-topmenu">
-      {items.map((it, i) => (
-        <div
-          key={i}
-          className={'aa-topmenu-item' + (isActive(it) ? ' is-active' : '')}
-          onClick={() => select(it)}
-        >
-          <span>{it.label}</span>
-          {it.badge ? <span className="aa-topmenu-badge">{it.badge}</span> : null}
-          {it.children ? <span className="aa-topmenu-caret">▾</span> : null}
-          {it.children ? (
-            <div className="aa-topmenu-dropdown">
-              {it.children.map((s, si) => (
-                <a
-                  key={si}
-                  className={'aa-topmenu-sub' + (s.key === active ? ' is-active' : '')}
-                  onClick={e => { e.stopPropagation(); select(s); }}
-                >
-                  {s.label}
-                </a>
-              ))}
-            </div>
-          ) : null}
-        </div>
-      ))}
-    </div>
+    <nav
+      className="aa-menu"
+      data-direction={params.direction}
+      data-collapsed={params.direction === 'side' ? (collapsed ? 'true' : 'false') : undefined}
+      aria-label="主菜单"
+    >
+      {renderBody()}
+      {renderPop()}
+    </nav>
  );
 }
@@ -1,32 +1,112 @@
 <template>
-  <div class="aa-topmenu">
-    <div class="aa-topmenu-item" v-for="(it, i) in items" :key="i"
-         :class="isActive(it) ? 'is-active' : ''" @click="select(it)">
-      <span>{{ it.label }}</span>
-      <span v-if="it.badge" class="aa-topmenu-badge">{{ it.badge }}</span>
-      <span v-if="it.children" class="aa-topmenu-caret">▾</span>
-      <div v-if="it.children" class="aa-topmenu-dropdown">
-        <a v-for="(s, si) in it.children" :key="si" class="aa-topmenu-sub"
-           :class="s.key === activeKey ? 'is-active' : ''" @click.stop="select(s)">{{ s.label }}</a>
+  <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 族 · TopMenu（Vue 2）
+ * @generated by tools/gen-family-impl.mjs
+ * 生成物 - 由 tools/gen-family-impl.mjs 从族模板生成，请勿手改。
+ * 族 nav-menu：本组件是同一份 Menu 实现，参数 direction=top。
+ * 族参数取值：direction=top, indicator=top, collapsed=false
+ * 重跑生成：node tools/gen-family-impl.mjs nav-menu
+ */
+var FAMILY_DIRECTION = 'top';
+var FAMILY_PARAMS = { direction: FAMILY_DIRECTION, collapsed: false };
+
 export default {
  name: 'AaTopMenu',
  props: {
    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;
+    }
+  },
  methods: {
-    isActive: function (it) {
-      if (it.key === this.activeKey) return true;
-      return (it.children || []).some(function (s) { return s.key === this.activeKey; }, this);
+    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.children) this.$emit('update:activeKey', it.key);
+      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);
    }
  }
@@ -1,31 +1,108 @@
 <template>
-  <div class="aa-topmenu">
-    <div class="aa-topmenu-item" v-for="(it, i) in items" :key="i"
-         :class="isActive(it) ? 'is-active' : ''" @click="select(it)">
-      <span>{{ it.label }}</span>
-      <span v-if="it.badge" class="aa-topmenu-badge">{{ it.badge }}</span>
-      <span v-if="it.children" class="aa-topmenu-caret">▾</span>
-      <div v-if="it.children" class="aa-topmenu-dropdown">
-        <a v-for="(s, si) in it.children" :key="si" class="aa-topmenu-sub"
-           :class="s.key === activeKey ? 'is-active' : ''" @click.stop="select(s)">{{ s.label }}</a>
+  <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 setup>
+/* Aurora Admin Menu 族 · TopMenu（Vue 3）
+ * @generated by tools/gen-family-impl.mjs
+ * 生成物 - 由 tools/gen-family-impl.mjs 从族模板生成，请勿手改。
+ * 族 nav-menu：本组件是同一份 Menu 实现，参数 direction=top。
+ * 族参数取值：direction=top, indicator=top, collapsed=false
+ * 重跑生成：node tools/gen-family-impl.mjs nav-menu
+ */
+import { computed, ref } from 'vue';
+
+const FAMILY_DIRECTION = 'top';
+const FAMILY_PARAMS = { direction: FAMILY_DIRECTION, collapsed: false };
+
 const props = defineProps({
  items: { type: Array, default: () => [] },
  activeKey: { type: String, default: '' }
 });
 const emit = defineEmits(['update:activeKey', 'change']);

-function isActive(it) {
-  if (it.key === props.activeKey) return true;
-  return (it.children || []).some(s => s.key === props.activeKey);
+const params = FAMILY_PARAMS;
+const active = ref(props.activeKey);
+const open = ref('');
+const collapsed = ref(params.collapsed === true);
+
+const collapsedAttr = computed(() =>
+  params.direction === 'side' ? String(collapsed.value) : undefined
+);
+
+function hasKids(it) {
+  return !!(it.children && it.children.length);
+}
+function isTopActive(it) {
+  if (it.key === active.value) return true;
+  return (it.children || []).some((c) => c.key === active.value);
+}
+const sideItems = computed(() => {
+  const current = props.items.filter((x) => isTopActive(x))[0] || props.items[0] || { children: [] };
+  return current.children || [];
+});
+const popItem = computed(() => {
+  if (params.direction !== 'side' || !collapsed.value) return null;
+  return props.items.filter((x) => x.key === open.value)[0] || null;
+});
+
+function itemClass(it) {
+  return [
+    it.key === active.value ? 'is-active' : '',
+    it.disabled ? 'is-disabled' : '',
+    hasKids(it) && it.key === open.value ? 'is-open' : ''
+  ];
 }
 function select(it) {
-  if (!it.children) emit('update:activeKey', it.key);
+  if (it.disabled) return;
+  if (hasKids(it)) {
+    open.value = open.value === it.key ? '' : it.key;
+    if (params.direction === 'mixed') active.value = it.key;
+    return;
+  }
+  active.value = it.key;
+  emit('update:activeKey', it.key);
  emit('change', it.key);
 }
 </script>