@icen.ai/ui 0.2.1 → 0.3.0

package/dist/components/menu.css

@@ -1,80 +1,190 @@
 /*
  * @icen.ai/ui — Component: menu（菜单面板，与 behaviors/dropdown、context-menu 配套）
+ *
  * 面板由 JS portal 到 document.body 并按 fixed 定位；data-side 决定进场位移方向。
  * 规格源自 opengal overlay/dropdown + overlay/context-menu。
+ *
+ * 完整契约（dropdown）：
+ *   <button class="menu-trigger pressable" data-menu-target="id" aria-haspopup="menu" aria-expanded="false">…</button>
+ *   <div class="menu" id="id" role="menu" data-side="bottom" hidden>
+ *     <div class="menu-label">组标题（可选）</div>
+ *     <button class="menu-item [.is-highlighted] [.is-disabled] [.menu-item--danger]" role="menuitem">
+ *       <span class="menu-item-icon">…svg…</span>
+ *       <span class="menu-item-label">文本</span>
+ *       <span class="menu-item-sub">副标题</span>
+ *       <span class="menu-item-shortcut">⌘S</span>
+ *     </button>
+ *     <div class="menu-separator"></div>
+ *     <button class="menu-item menu-item--checked">
+ *       <span class="menu-item-check">✓</span>
+ *       <span class="menu-item-label">已选项</span>
+ *     </button>
+ *   </div>
+ *
+ * context-menu：附加 .menu--context（更窄宽度、更高 z-index）。
+ * behavior 维护：键盘箭头导航 + .is-highlighted 跟随、Enter 触发、ESC 关闭、外部点击关闭。
  */
 
 .menu {
-  position: fixed; z-index: var(--z-popover);
-  min-width: 180px; max-height: min(70vh, 420px); overflow-y: auto;
-  margin: 0; padding: 4px;
+  position: fixed;
+  z-index: var(--z-popover);
+  min-width: 180px;
+  max-width: 320px;
+  max-height: min(70vh, 420px);
+  overflow-y: auto;
+  overscroll-behavior: contain;
+  margin: 0;
+  padding: var(--density-space-xs);
   background: color-mix(in srgb, var(--token-card-strong) 92%, transparent);
   backdrop-filter: blur(24px);
+  -webkit-backdrop-filter: blur(24px);
   border: 1px solid var(--token-outline);
   box-shadow: var(--token-shadow-overlay);
   border-radius: var(--radius-lg);
-  animation: icen-menu-in 150ms var(--ease-out);
+  animation: icen-menu-in var(--icen-tx-fast);
 }
 .menu[data-side='top'] { animation-name: icen-menu-in-top; }
+.menu[data-side='left'] { animation-name: icen-menu-in-left; }
+.menu[data-side='right'] { animation-name: icen-menu-in-right; }
 
-/* 右键菜单修正（opengal context-menu：min 218 / max 286 / z 9999 / 入场 100ms） */
+/* 右键菜单：opengal context-menu 规格沿用 */
 .menu--context {
-  min-width: 218px; max-width: 286px; z-index: 9999;
+  min-width: 218px;
+  max-width: 286px;
+  z-index: var(--z-tooltip); /* 上下文菜单高于普通 popover，与 tooltip 平齐 */
   animation-duration: 100ms;
 }
 
 /* ── 分组标签 / 头（context-menu 的 header 项） ── */
 .menu-label {
-  padding: 4px 8px; font-size: 10px; font-weight: 600;
-  text-transform: uppercase; letter-spacing: 0.08em;
+  padding: var(--density-space-xs) var(--density-space-sm);
+  font-size: var(--density-font-size-xs);
+  font-weight: 600;
+  text-transform: uppercase;
+  letter-spacing: 0.08em;
   color: var(--token-text-faint);
 }
-.menu-header { padding: 8px 10px 6px; }
+.menu-header {
+  padding: var(--density-space-sm) calc(var(--density-space-sm) + 2px) var(--density-space-xs);
+}
 .menu-header-label {
-  display: block; overflow: hidden; text-overflow: ellipsis; white-space: nowrap;
-  font-size: 11px; font-weight: 500; line-height: 16px; color: var(--token-text);
+  display: block;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+  font-size: var(--density-font-size-sm);
+  font-weight: 500;
+  line-height: 1.4;
+  color: var(--token-text);
 }
 .menu-header-desc {
-  display: block; overflow: hidden; text-overflow: ellipsis; white-space: nowrap;
-  font-size: 10px; line-height: 14px; color: var(--token-text-faint);
+  display: block;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+  font-size: var(--density-font-size-xs);
+  line-height: 1.4;
+  color: var(--token-text-faint);
 }
 
 /* ── 菜单项 ── */
 .menu-item {
-  position: relative; display: flex; align-items: center; gap: 8px;
-  width: 100%; padding: 6px 8px;
-  background: none; border: 0; font: inherit; font-size: 12px; text-align: left;
+  position: relative;
+  display: flex;
+  align-items: center;
+  gap: var(--density-space-xs);
+  width: 100%;
+  padding: 6px var(--density-space-sm);
+  background: none;
+  border: 0;
+  font: inherit;
+  font-size: var(--density-font-size-sm);
+  text-align: left;
   color: var(--token-text);
-  border-radius: var(--radius-md); cursor: pointer; user-select: none;
+  border-radius: var(--radius-sm);
+  cursor: pointer;
+  user-select: none;
+  transition:
+    background-color var(--icen-tx-fast),
+    color var(--icen-tx-fast);
 }
-.menu-item.is-highlighted, .menu-item:focus {
-  background: var(--token-surface-hover); color: var(--token-accent); outline: none;
+.menu-item:hover:not(.is-disabled) {
+  background: var(--token-fill-1);
+}
+.menu-item.is-highlighted,
+.menu-item:focus-visible {
+  background: var(--token-surface-hover);
+  color: var(--token-accent);
+  outline: none;
 }
 .menu-item--danger { color: var(--token-error); }
-.menu-item--danger.is-highlighted, .menu-item--danger:focus {
-  background: var(--token-error-muted); color: var(--token-error);
+.menu-item--danger.is-highlighted,
+.menu-item--danger:focus-visible {
+  background: var(--token-error-muted);
+  color: var(--token-error);
+}
+.menu-item.is-disabled,
+.menu-item:disabled,
+.menu-item[aria-disabled='true'] {
+  opacity: var(--icen-disabled-opacity);
+  pointer-events: none;
 }
-.menu-item.is-disabled, .menu-item:disabled { opacity: 0.5; pointer-events: none; }
 
 .menu-item-icon {
-  display: inline-flex; align-items: center; justify-content: center;
-  width: 14px; height: 14px; flex-shrink: 0;
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  width: 14px;
+  height: 14px;
+  flex-shrink: 0;
+}
+.menu-item-icon:empty { width: 14px; height: auto; } /* 无图标时占位 */
+.menu-item-label {
+  flex: 1;
+  min-width: 0;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+.menu-item-sub {
+  display: block;
+  font-size: var(--density-font-size-xs);
+  line-height: 1.3;
+  color: var(--token-text-faint);
+  margin-top: 2px;
+}
+.menu-item-shortcut {
+  font-size: var(--density-font-size-xs);
+  color: var(--token-text-faint);
+  font-family: var(--font-mono);
+  margin-left: var(--density-space-sm);
+}
+.menu-item-chevron {
+  width: 12px;
+  height: 12px;
+  flex-shrink: 0;
+  color: var(--token-text-faint);
 }
-.menu-item-icon:empty { width: 16px; height: auto; } /* 无图标时 16px 宽占位 */
-.menu-item-label { flex: 1; min-width: 0; overflow: hidden; text-overflow: ellipsis; }
-.menu-item-sub { display: block; font-size: 10px; line-height: 1.2; color: var(--token-text-faint); }
-.menu-item-shortcut { font-size: 10px; color: var(--token-text-faint); }
 
 /* 勾选项：左勾 ✓ + 缩进 */
 .menu-item-check {
-  position: absolute; left: 8px; top: 50%; transform: translateY(-50%);
-  color: var(--token-accent); font-size: 12px; line-height: 1;
+  position: absolute;
+  left: var(--density-space-sm);
+  top: 50%;
+  transform: translateY(-50%);
+  color: var(--token-accent);
+  font-size: var(--density-font-size-md);
+  line-height: 1;
 }
 .menu-item--checked { padding-left: 28px; }
 
-.menu-separator { margin: 6px 8px; height: 1px; background: var(--token-line-soft); }
+.menu-separator {
+  margin: var(--density-space-xs) calc(var(--density-space-sm) + 2px);
+  height: 1px;
+  background: var(--token-line-soft);
+}
 
-/* ── 进场：fade + scale(.95→1)，bottom 从上方 8px 滑入、top 从下方 8px 滑入 ── */
+/* ── 进场：fade + scale(.95→1)，按侧别反向位移 8px ── */
 @keyframes icen-menu-in {
   from { opacity: 0; transform: scale(0.95) translateY(-8px); }
   to { opacity: 1; transform: scale(1) translateY(0); }
@@ -83,3 +193,20 @@
   from { opacity: 0; transform: scale(0.95) translateY(8px); }
   to { opacity: 1; transform: scale(1) translateY(0); }
 }
+@keyframes icen-menu-in-left {
+  from { opacity: 0; transform: scale(0.95) translateX(8px); }
+  to { opacity: 1; transform: scale(1) translateX(0); }
+}
+@keyframes icen-menu-in-right {
+  from { opacity: 0; transform: scale(0.95) translateX(-8px); }
+  to { opacity: 1; transform: scale(1) translateX(0); }
+}
+
+@media (prefers-reduced-motion: reduce) {
+  .menu, .menu--context { animation: none; }
+}
+
+/* 触屏：hover 永久开启（替代 hover 设备的悬停反馈） */
+@media (hover: none) {
+  .menu-item:hover:not(.is-disabled) { background: transparent; }
+}

package/dist/components/modal.css

@@ -1,86 +1,188 @@
 /*
  * @icen.ai/ui — Component: modal（对话框 + 贴边 Sheet，与 behaviors/modal 配套）
- * 契约：<div class="modal-backdrop" data-modal="id" hidden> > .modal[role=dialog]
- * 规格源自 opengal overlay/dialog：backdrop fadeIn 150ms、面板 dialogScaleIn
- * 200ms cubic-bezier(.16,1,.3,1)、Sheet 四向 slideIn 200ms 位移 40px。
+ *
+ * 完整契约：
+ *   <div class="modal-backdrop" data-modal="id" hidden>
+ *     <div class="modal [--sm|--lg|--xl|--full] [role=dialog] aria-modal="true" aria-labelledby="title-id">
+ *       <div class="modal-header">
+ *         <div>
+ *           <h2 class="modal-title" id="title-id">标题</h2>
+ *           <p class="modal-description">副标题（可选）</p>
+         </div>
+ *         <button class="modal-close" aria-label="关闭">…</button>
+ *       </div>
+ *       <div class="modal-body">…</div>
+ *       <div class="modal-footer [modal-footer--between|modal-footer--start|modal-footer--column]">
+ *         <button class="btn">取消</button>
+ *         <button class="btn btn-primary">确认</button>
+ *       </div>
+ *     </div>
+ *   </div>
+ *
+ * Sheet 变体：modal--sheet-left/right/top/bottom（+ sm/lg 尺寸）
+ * behavior 维护：focus trap、ESC 关闭、点击 backdrop 关闭、scroll lock。
  */
 
 .modal-backdrop {
-  position: fixed; inset: 0; z-index: var(--z-dialog);
-  display: flex; align-items: center; justify-content: center; padding: 16px;
-  background: rgba(0, 0, 0, 0.45); backdrop-filter: blur(4px);
-  animation: icen-modal-fade-in 150ms ease-out;
+  position: fixed;
+  inset: 0;
+  z-index: var(--z-dialog);
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  padding: var(--density-space-md);
+  background: color-mix(in srgb, var(--token-text) 45%, transparent);
+  backdrop-filter: blur(4px);
+  -webkit-backdrop-filter: blur(4px);
+  animation: icen-modal-fade-in var(--icen-tx-normal);
 }
 .modal-backdrop[hidden] { display: none; }
 
 .modal {
-  display: flex; flex-direction: column; overflow: hidden;
-  width: 100%; max-width: 480px; max-height: calc(100vh - 32px);
-  background: var(--token-card-strong); color: var(--token-text);
+  display: flex;
+  flex-direction: column;
+  overflow: hidden;
+  width: 100%;
+  max-width: 480px;
+  max-height: calc(100vh - 32px);
+  background: var(--token-card-strong);
+  color: var(--token-text);
   border: 1px solid var(--token-outline);
   box-shadow: var(--token-shadow-overlay);
   border-radius: var(--radius-xl);
-  animation: icen-modal-scale-in 200ms cubic-bezier(0.16, 1, 0.3, 1);
+  animation: icen-modal-scale-in var(--icen-tx-slow);
 }
 .modal:focus { outline: none; }
+.modal:focus-visible {
+  box-shadow: var(--token-shadow-overlay), var(--icen-ring-soft);
+}
 
 /* ── 尺寸档 ── */
 .modal--sm { max-width: 360px; }
 .modal--lg { max-width: 640px; }
 .modal--xl { max-width: 800px; }
-.modal--full { width: calc(100vw - 32px); max-width: none; height: calc(100vh - 32px); max-height: none; }
+.modal--full {
+  width: calc(100vw - 32px);
+  max-width: none;
+  height: calc(100vh - 32px);
+  max-height: none;
+  border-radius: var(--radius-lg);
+}
 
 /* ── 头部 / 主体 / 底栏 ── */
 .modal-header {
-  display: flex; align-items: flex-start; justify-content: space-between;
-  gap: 16px; padding: 20px 24px 12px;
+  display: flex;
+  align-items: flex-start;
+  justify-content: space-between;
+  gap: var(--density-space-md);
+  padding: var(--density-space-lg) var(--density-space-lg) var(--density-space-sm);
+}
+.modal-title {
+  margin: 0;
+  font-size: var(--density-font-size-lg);
+  font-weight: 600;
+  line-height: 1.3;
+  font-family: var(--font-heading);
+}
+.modal-description {
+  margin: 2px 0 0;
+  font-size: var(--density-font-size-sm);
+  color: var(--token-text-muted);
+  line-height: 1.5;
 }
-.modal-title { margin: 0; font-size: 15px; font-weight: 600; }
-.modal-description { margin: 2px 0 0; font-size: 12px; color: var(--token-text-muted); }
 .modal-close {
-  display: inline-flex; align-items: center; justify-content: center;
-  width: 28px; height: 28px; padding: 0; flex-shrink: 0;
-  background: none; border: 0; cursor: pointer;
-  color: var(--token-text-faint); font-size: 16px; line-height: 1;
-  border-radius: var(--radius-md);
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  width: 28px;
+  height: 28px;
+  padding: 0;
+  flex-shrink: 0;
+  background: none;
+  border: 0;
+  cursor: pointer;
+  color: var(--token-text-faint);
+  font-size: 16px;
+  line-height: 1;
+  border-radius: var(--radius-sm);
+  transition:
+    background-color var(--icen-tx-fast),
+    color var(--icen-tx-fast);
+}
+.modal-close:hover {
+  background: var(--token-surface-hover);
+  color: var(--token-text);
+}
+.modal-close:focus-visible {
+  outline: none;
+  box-shadow: var(--icen-ring);
+}
+
+.modal-body {
+  flex: 1;
+  overflow-y: auto;
+  overscroll-behavior: contain;
+  padding: 0 var(--density-space-lg) var(--density-space-md);
+  font-size: var(--density-font-size-md);
+  line-height: 1.6;
 }
-.modal-close:hover { background: var(--token-surface-hover); color: var(--token-text); }
 
-.modal-body { flex: 1; overflow-y: auto; padding: 0 24px 20px; }
 .modal-footer {
-  display: flex; justify-content: flex-end; gap: 8px; padding: 16px 24px;
+  display: flex;
+  justify-content: flex-end;
+  gap: var(--density-space-sm);
+  padding: var(--density-space-md) var(--density-space-lg);
   border-top: 1px solid color-mix(in srgb, var(--token-line-soft) 40%, transparent);
 }
+.modal-footer--start { justify-content: flex-start; }
+.modal-footer--between { justify-content: space-between; }
+.modal-footer--column { flex-direction: column; }
+.modal-footer--column > * { width: 100%; }
 
 /* ── Sheet 变体：面板 fixed 贴边，radius 只保留非贴边侧 ── */
-.modal--sheet-left, .modal--sheet-right, .modal--sheet-top, .modal--sheet-bottom {
-  position: fixed; max-width: none; max-height: none; border-radius: 0;
+.modal--sheet-left,
+.modal--sheet-right,
+.modal--sheet-top,
+.modal--sheet-bottom {
+  position: fixed;
+  max-width: none;
+  max-height: none;
+  border-radius: 0;
 }
 .modal--sheet-left {
-  left: 0; top: 0; bottom: 0; width: 360px; height: 100%;
+  left: 0; top: 0; bottom: 0;
+  width: 360px;
+  height: 100%;
   border-radius: 0 var(--radius-xl) var(--radius-xl) 0;
   animation-name: icen-modal-slide-left;
 }
 .modal--sheet-right {
-  right: 0; top: 0; bottom: 0; width: 360px; height: 100%;
+  right: 0; top: 0; bottom: 0;
+  width: 360px;
+  height: 100%;
   border-radius: var(--radius-xl) 0 0 var(--radius-xl);
   animation-name: icen-modal-slide-right;
 }
 .modal--sheet-top {
-  top: 0; left: 0; right: 0; width: 100%; height: 300px;
+  top: 0; left: 0; right: 0;
+  width: 100%;
+  height: 300px;
   border-radius: 0 0 var(--radius-xl) var(--radius-xl);
   animation-name: icen-modal-slide-top;
 }
 .modal--sheet-bottom {
-  bottom: 0; left: 0; right: 0; width: 100%; height: 300px;
+  bottom: 0; left: 0; right: 0;
+  width: 100%;
+  height: 300px;
   border-radius: var(--radius-xl) var(--radius-xl) 0 0;
   animation-name: icen-modal-slide-bottom;
 }
-.modal--sheet-left.modal--sheet-sm, .modal--sheet-right.modal--sheet-sm { width: 280px; }
-.modal--sheet-left.modal--sheet-lg, .modal--sheet-right.modal--sheet-lg { width: 480px; }
-.modal--sheet-top.modal--sheet-lg, .modal--sheet-bottom.modal--sheet-lg { height: 50vh; }
+.modal--sheet-left.modal--sm, .modal--sheet-right.modal--sm { width: 280px; }
+.modal--sheet-left.modal--lg, .modal--sheet-right.modal--lg { width: 480px; }
+.modal--sheet-top.modal--sm, .modal--sheet-bottom.modal--sm { height: 200px; }
+.modal--sheet-top.modal--lg, .modal--sheet-bottom.modal--lg { height: 50vh; }
 
-/* ── 进场动画（与 opengal src/index.css 同参数） ── */
+/* ── 进场动画 ── */
 @keyframes icen-modal-fade-in {
   from { opacity: 0; }
   to { opacity: 1; }
@@ -105,3 +207,7 @@
   from { opacity: 0; transform: translateY(40px); }
   to { opacity: 1; transform: translateY(0); }
 }
+
+@media (prefers-reduced-motion: reduce) {
+  .modal-backdrop, .modal { animation: none; }
+}

package/dist/components/modal.mjs

@@ -0,0 +1,3 @@
+// @icen.ai/ui — kit: modal（CSS + behavior 一行入口；构建产物，勿手改）
+import './modal.css';
+export * from '../behaviors/modal.mjs';

package/dist/components/nav.css

@@ -1,29 +1,50 @@
 /*
  * @icen.ai/ui — Component: nav（玻璃顶栏，scroll 收缩配套 behaviors/nav）
- * 用法：<nav class="nav nav--sticky" data-scroll-reactive>
- *         <div class="nav-left">…</div><div class="nav-center">…</div><div class="nav-right">…</div>
- *       </nav>
- * 三段：.nav-left / .nav-center（flex:1 居中）/ .nav-right，整行补充用 .nav-bottom。
- * 按钮：.nav-btn（HTML 组合 .motion .pressable 基元），.is-active / .is-disabled / .nav-btn--icon。
- * 契约：sticky/fixed 挂 --z-chrome 层；data-scroll-reactive 时 behaviors/nav 依 scrollY>12 切
- * .is-scrolled——未滚动更透且无边线，滚动后底色更实 + blur 16px。
+ *
+ * 完整契约：
+ *   <nav class="nav [nav--sticky|nav--fixed] [.is-scrolled]" data-scroll-reactive>
+ *     <div class="nav-left">…品牌/返回</div>
+ *     <div class="nav-center">…中间菜单</div>
+ *     <div class="nav-right">…操作</div>
+ *     <div class="nav-bottom">…整行补充（可选，会换行）</div>
+ *   </nav>
+ *
+ * 按钮：<button class="nav-btn motion pressable [.is-active] [.is-disabled] [.nav-btn--icon]">
+ * 三段布局：left/right flex-shrink:0；center flex:1 居中。
+ * behavior 维护：scrollY > 12 时挂 .is-scrolled；prefers-reduced-motion 下不监听。
  */
 
 .nav {
-  display: flex; align-items: center; flex-wrap: wrap; gap: 12px;
-  height: 56px; padding: 0 16px;
+  display: flex;
+  align-items: center;
+  flex-wrap: wrap;
+  gap: var(--density-space-sm);
+  height: 56px;
+  padding: 0 var(--density-space-md);
   background: var(--token-surface-glass);
   backdrop-filter: blur(12px) saturate(1.1);
   -webkit-backdrop-filter: blur(12px) saturate(1.1);
   border-bottom: 1px solid var(--token-outline-soft);
-  transition: all var(--duration-slow) var(--ease-out);
+  transition: all var(--icen-tx-slow);
+}
+.nav:has(.nav-bottom) {
+  height: auto;
+  min-height: 56px;
+}
+.nav--sticky {
+  position: sticky;
+  top: 0;
+  z-index: var(--z-chrome);
+}
+.nav--fixed {
+  position: fixed;
+  top: 0;
+  left: 0;
+  right: 0;
+  z-index: var(--z-chrome);
 }
-/* 带整行 bottom 时放开固定高度，第一行仍保持 56px */
-.nav:has(.nav-bottom) { height: auto; min-height: 56px; }
-.nav--sticky { position: sticky; top: 0; z-index: var(--z-chrome); }
-.nav--fixed { position: fixed; top: 0; left: 0; right: 0; z-index: var(--z-chrome); }
 
-/* scroll-reactive：未滚动更透、底边线透明（滚动后由 .is-scrolled 接管） */
+/* scroll-reactive：未滚动更透、底边线透明；滚动后底色更实 + blur 加倍 */
 .nav[data-scroll-reactive]:not(.is-scrolled) {
   background: color-mix(in srgb, var(--token-surface-glass) 70%, transparent);
   backdrop-filter: blur(8px);
@@ -34,26 +55,107 @@
   background: color-mix(in srgb, var(--token-surface-glass) 92%, transparent);
   backdrop-filter: blur(16px) saturate(1.2);
   -webkit-backdrop-filter: blur(16px) saturate(1.2);
+  box-shadow: var(--token-shadow-elevated);
 }
 
-.nav-left, .nav-right { display: flex; align-items: center; gap: 4px; flex-shrink: 0; }
-.nav-center { flex: 1; display: flex; align-items: center; justify-content: center; gap: 4px; }
-.nav-bottom { width: 100%; }
+/* hide-on-scroll 模式：向下滚隐藏，向上滚恢复。仅 sticky/fixed 生效。 */
+.nav.nav--sticky.is-nav-hidden,
+.nav.nav--fixed.is-nav-hidden {
+  transform: translateY(-100%);
+  box-shadow: none;
+}
+
+.nav-left,
+.nav-right {
+  display: flex;
+  align-items: center;
+  gap: var(--density-space-xs);
+  flex-shrink: 0;
+}
+.nav-center {
+  flex: 1;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  gap: var(--density-space-xs);
+}
+.nav-bottom { width: 100%; padding-top: var(--density-space-xs); }
 
 .nav-btn {
-  display: inline-flex; align-items: center; gap: 6px;
-  border-radius: var(--radius-full); padding: 6px 12px;
-  font-size: 13px; color: var(--token-text-muted);
-  background: none; border: 0; cursor: pointer;
-}
-.nav-btn > svg { width: 14px; height: 14px; flex-shrink: 0; }
-.nav-btn:not(.is-active):hover { color: var(--token-text); background: var(--token-control-hover); }
-.nav-btn.is-active {
-  background: var(--token-accent); color: var(--token-on-accent);
-  font-weight: 500; box-shadow: 0 1px 2px rgba(0, 0, 0, .05);
-}
-.nav-btn.is-disabled, .nav-btn:disabled { opacity: .4; pointer-events: none; }
+  display: inline-flex;
+  align-items: center;
+  gap: var(--density-space-xs);
+  border-radius: var(--radius-full);
+  padding: 6px var(--density-space-sm);
+  font-size: var(--density-font-size-md);
+  color: var(--token-text-muted);
+  background: none;
+  border: 0;
+  cursor: pointer;
+  -webkit-tap-highlight-color: transparent;
+  transition:
+    background-color var(--icen-tx-fast),
+    color var(--icen-tx-fast);
+}
+.nav-btn > svg {
+  width: 14px;
+  height: 14px;
+  flex-shrink: 0;
+}
+.nav-btn:not(.is-active):hover {
+  color: var(--token-text);
+  background: var(--token-control-hover);
+}
+.nav-btn:focus-visible {
+  outline: none;
+  box-shadow: var(--icen-ring);
+}
+.nav-btn.is-active,
+.nav-btn[aria-current='page'] {
+  background: var(--token-accent);
+  color: var(--token-on-accent, #fff);
+  font-weight: 500;
+  box-shadow: var(--token-shadow-elevated);
+}
+.nav-btn.is-disabled,
+.nav-btn:disabled,
+.nav-btn[aria-disabled='true'] {
+  opacity: var(--icen-disabled-opacity);
+  pointer-events: none;
+}
 .nav-btn--icon { padding: 6px 10px; }
-.nav-btn--icon > svg { width: 15px; height: 15px; }
+.nav-btn--icon > svg { width: 16px; height: 16px; }
+
+.nav-divider {
+  width: 1px;
+  height: 20px;
+  margin: 0 2px;
+  background: var(--token-outline-soft);
+}
+
+/* 品牌徽标位 */
+.nav-brand {
+  display: inline-flex;
+  align-items: center;
+  gap: var(--density-space-xs);
+  font-family: var(--font-heading);
+  font-size: var(--density-font-size-md);
+  font-weight: 600;
+  color: var(--token-text);
+  text-decoration: none;
+}
+.nav-brand:hover { text-decoration: none; }
+.nav-brand > svg, .nav-brand > img {
+  width: 24px;
+  height: 24px;
+}
 
-.nav-divider { width: 1px; height: 20px; margin: 0 2px; background: var(--token-outline-soft); }
+/* 移动端：缩短高度、收紧间距 */
+@media (max-width: 640px) {
+  .nav { height: 48px; min-height: 48px; padding: 0 var(--density-space-sm); }
+  .nav-btn { padding: 4px var(--density-space-xs); }
+}
+
+@media (prefers-reduced-motion: reduce) {
+  .nav, .nav-btn { transition: none; }
+}

package/dist/components/nav.mjs

@@ -0,0 +1,3 @@
+// @icen.ai/ui — kit: nav（CSS + behavior 一行入口；构建产物，勿手改）
+import './nav.css';
+export * from '../behaviors/nav.mjs';