@zhang_jifan/fanui 2.1.0

package/src/components/_interactive.scss

@@ -0,0 +1,885 @@
+// =============================================================================
+// fanUI · 交互创新组件 (Interactive & Novel)
+// -----------------------------------------------------------------------------
+// 这些组件是本套设计系统的「新颖性」集中体现，全部以渐进增强方式实现：
+//   无 JS 时保持可用（纯 CSS 交互），有 JS 时获得更顺滑的行为。
+//
+//   .fanui-command        命令面板（⌘K / Ctrl+K）
+//   .fanui-dock           磁吸 Dock（纯 CSS :has() 实现相邻放大）
+//   .fanui-carousel       轮播（scroll-snap，支持拖拽 / 自动播放）
+//   .fanui-fab            悬浮主按钮 + 放射菜单
+//   .fanui-scroll-progress 阅读进度条
+//   .fanui-spotlight      光斑跟随卡片（鼠标位置驱动边框光效）
+//   .fanui-cursor-glow    全局光标辉光
+//   .fanui-studio         主题工作台（12 主题色 / 深浅 / 液态玻璃控制台）
+//   .fanui-sheet          移动端底部抽屉
+//   .fanui-bottom-nav     移动端底部导航
+// =============================================================================
+
+@use "sass:map";
+@use "../functions" as fn;
+@use "../variables" as v;
+@use "../mixins" as mx;
+
+// -----------------------------------------------------------------------------
+// 1. 命令面板 Command Palette
+// -----------------------------------------------------------------------------
+
+.fanui-command {
+  @include mx.fanui-fixed-fill();
+  z-index: calc(fn.fanui-var("z-modal") + 10);
+  display: flex;
+  justify-content: center;
+  align-items: flex-start;
+  padding: 12vh fn.fanui-var("space-4") fn.fanui-var("space-4");
+  opacity: 0;
+  visibility: hidden;
+  @include mx.fanui-transition((opacity, visibility), v.$fanui-duration-base);
+
+  &.is-open {
+    opacity: 1;
+    visibility: visible;
+  }
+
+  &__backdrop {
+    @include mx.fanui-absolute-fill();
+    background-color: fn.fanui-var("backdrop-bg");
+    backdrop-filter: blur(6px);
+    -webkit-backdrop-filter: blur(6px);
+  }
+
+  &__dialog {
+    position: relative;
+    width: min(640px, 100%);
+    max-height: 70vh;
+    display: flex;
+    flex-direction: column;
+    overflow: hidden;
+    border: 1px solid fn.fanui-var("color-border");
+    border-radius: fn.fanui-var("radius-2xl");
+    background-color: fn.fanui-var("color-overlay");
+    box-shadow: fn.fanui-var("shadow-2xl");
+    transform: translateY(-12px) scale(0.98);
+    @include mx.fanui-transition((transform, opacity), v.$fanui-duration-slow, v.$fanui-ease-spring);
+  }
+
+  &.is-open &__dialog { transform: translateY(0) scale(1); }
+
+  // 玻璃版：直接复用液态玻璃令牌，开关联动
+  &--glass &__dialog {
+    @include mx.fanui-glass-surface();
+    // 可读性地板：命令面板是高频「阅读面」，
+    // 半透明白玻璃直接叠在品牌色 hero 上会让 subtle 文字跌破 AA（实测 #94a3b8 vs 有效底 ≈ 1.9:1），
+    // 这里把有效不透明度抬到 ~0.85，同时保留玻璃质感与折射。
+    @include mx.fanui-glass-readable-floor(0.55);
+  }
+
+  // 玻璃浮层内的次级文字整体上调一档：subtle → muted（浮层内不允许低于 AA）
+  &--glass &__group-title,
+  &--glass &__item-desc,
+  &--glass &__item-hint,
+  &--glass &__item-icon,
+  &--glass &__foot {
+    @include mx.fanui-glass-readable-text();
+  }
+
+  &__head {
+    display: flex;
+    align-items: center;
+    gap: fn.fanui-var("space-3");
+    padding: fn.fanui-var("space-4");
+    border-bottom: 1px solid fn.fanui-var("color-border-subtle");
+  }
+
+  &__icon {
+    color: fn.fanui-var("color-text-subtle");
+    flex: 0 0 auto;
+  }
+
+  &__input {
+    flex: 1 1 auto;
+    min-width: 0;
+    border: 0;
+    background: transparent;
+    font: inherit;
+    font-size: fn.fanui-var("font-size-md");
+    color: fn.fanui-var("color-text");
+
+    &:focus { outline: none; }
+    &::placeholder { color: fn.fanui-var("color-text-subtle"); }
+  }
+
+  &__body {
+    flex: 1 1 auto;
+    min-height: 120px;
+    overflow-y: auto;
+    padding: fn.fanui-var("space-2");
+    @include mx.fanui-scrollbar(6px);
+  }
+
+  &__group-title {
+    padding: fn.fanui-var("space-3") fn.fanui-var("space-3") fn.fanui-var("space-1");
+    font-size: fn.fanui-var("font-size-xs");
+    font-weight: fn.fanui-var("font-weight-semibold");
+    letter-spacing: fn.fanui-var("tracking-wider");
+    text-transform: uppercase;
+    color: fn.fanui-var("color-text-subtle");
+  }
+
+  &__item {
+    display: flex;
+    align-items: center;
+    gap: fn.fanui-var("space-3");
+    padding: 9px fn.fanui-var("space-3");
+    border-radius: fn.fanui-var("radius-md");
+    color: fn.fanui-var("color-text");
+    cursor: pointer;
+    @include mx.fanui-transition((background-color, transform), v.$fanui-duration-fast);
+
+    &[aria-selected="true"],
+    &.is-active {
+      background-color: fn.fanui-var("primary-soft");
+      color: fn.fanui-var("primary-ink");
+    }
+
+    &:active { transform: scale(0.995); }
+    &[aria-disabled="true"] { opacity: 0.45; pointer-events: none; }
+  }
+
+  &__item-icon {
+    display: grid;
+    place-items: center;
+    width: 28px;
+    height: 28px;
+    flex: 0 0 auto;
+    border-radius: fn.fanui-var("radius-sm");
+    background-color: fn.fanui-var("color-surface-sunken");
+    color: fn.fanui-var("color-text-muted");
+    font-size: fn.fanui-var("font-size-sm");
+  }
+
+  &__item-body { flex: 1 1 auto; min-width: 0; }
+
+  &__item-title {
+    display: block;
+    font-size: fn.fanui-var("font-size-sm");
+    @include mx.fanui-truncate(1);
+  }
+
+  &__item-desc {
+    display: block;
+    font-size: fn.fanui-var("font-size-xs");
+    color: fn.fanui-var("color-text-subtle");
+    @include mx.fanui-truncate(1);
+  }
+
+  &__item-hint {
+    flex: 0 0 auto;
+    font-size: fn.fanui-var("font-size-xs");
+    color: fn.fanui-var("color-text-subtle");
+  }
+
+  &__empty {
+    display: grid;
+    place-items: center;
+    gap: fn.fanui-var("space-2");
+    padding: fn.fanui-var("space-10") fn.fanui-var("space-4");
+    text-align: center;
+    color: fn.fanui-var("color-text-subtle");
+    font-size: fn.fanui-var("font-size-sm");
+  }
+
+  &__foot {
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    gap: fn.fanui-var("space-3");
+    padding: fn.fanui-var("space-2") fn.fanui-var("space-4");
+    border-top: 1px solid fn.fanui-var("color-border-subtle");
+    font-size: fn.fanui-var("font-size-xs");
+    color: fn.fanui-var("color-text-subtle");
+  }
+
+  &__keys {
+    display: inline-flex;
+    align-items: center;
+    gap: fn.fanui-var("space-1");
+  }
+
+  // 高亮匹配片段
+  &__mark {
+    padding: 0 1px;
+    border-radius: 3px;
+    background-color: fn.fanui-var("warning-soft-2");
+    color: fn.fanui-var("warning-ink");
+  }
+}
+
+// -----------------------------------------------------------------------------
+// 2. 磁吸 Dock（纯 CSS 相邻放大，无需 JS）
+// -----------------------------------------------------------------------------
+
+.fanui-dock {
+  display: inline-flex;
+  align-items: flex-end;
+  gap: fn.fanui-var("space-2");
+  padding: fn.fanui-var("space-2") fn.fanui-var("space-3");
+  border-radius: fn.fanui-var("radius-2xl");
+
+  &__item {
+    --fanui-dock-scale: 1;
+
+    position: relative;
+    display: grid;
+    place-items: center;
+    width: 46px;
+    height: 46px;
+    flex: 0 0 auto;
+    color: fn.fanui-var("color-text");
+    text-decoration: none;
+    border-radius: fn.fanui-var("radius-lg");
+    transform: scale(var(--fanui-dock-scale)) translateY(calc((var(--fanui-dock-scale) - 1) * -8px));
+    transform-origin: bottom center;
+    @include mx.fanui-transition((transform, box-shadow), v.$fanui-duration-base, v.$fanui-ease-spring);
+
+    &:focus-visible { @include mx.fanui-focus-ring(); }
+  }
+
+  // 相邻放大：hover 项 1.42，紧邻 1.24，次邻 1.1
+  &__item:hover { --fanui-dock-scale: 1.42; }
+
+  &__item:hover + &__item,
+  &__item:has(+ &__item:hover) { --fanui-dock-scale: 1.24; }
+
+  &__item:hover + &__item + &__item,
+  &__item:has(+ &__item + &__item:hover) { --fanui-dock-scale: 1.1; }
+
+  // 悬停提示
+  &__label {
+    position: absolute;
+    bottom: calc(100% + 10px);
+    left: 50%;
+    transform: translateX(-50%) translateY(4px);
+    padding: 3px 8px;
+    font-size: fn.fanui-var("font-size-xs");
+    white-space: nowrap;
+    color: fn.fanui-var("color-text-inverse");
+    background-color: fn.fanui-var("color-text-strong");
+    border-radius: fn.fanui-var("radius-sm");
+    opacity: 0;
+    pointer-events: none;
+    @include mx.fanui-transition((opacity, transform), v.$fanui-duration-fast);
+  }
+
+  &__item:hover &__label {
+    opacity: 1;
+    transform: translateX(-50%) translateY(0);
+  }
+
+  // 运行中标示点
+  &__item.is-active::after {
+    content: "";
+    position: absolute;
+    bottom: -5px;
+    width: 4px;
+    height: 4px;
+    border-radius: fn.fanui-var("radius-full");
+    background-color: currentColor;
+  }
+
+  &--sm &__item { width: 38px; height: 38px; }
+  &--vertical {
+    flex-direction: column;
+    align-items: center;
+
+    .fanui-dock__label {
+      bottom: auto;
+      left: calc(100% + 10px);
+      top: 50%;
+      transform: translateY(-50%) translateX(-4px);
+    }
+
+    .fanui-dock__item:hover .fanui-dock__label { transform: translateY(-50%) translateX(0); }
+  }
+}
+
+// -----------------------------------------------------------------------------
+// 3. 轮播 Carousel（scroll-snap 驱动，天然支持触控滑动）
+// -----------------------------------------------------------------------------
+
+.fanui-carousel {
+  position: relative;
+
+  &__viewport {
+    display: flex;
+    gap: var(--fanui-carousel-gap, #{fn.fanui-var("space-4")});
+    overflow-x: auto;
+    scroll-snap-type: x mandatory;
+    scroll-behavior: smooth;
+    scrollbar-width: none;
+    @include mx.fanui-no-scrollbar();
+
+    > * {
+      flex: 0 0 var(--fanui-carousel-slide, 100%);
+      scroll-snap-align: start;
+    }
+  }
+
+  &--peek &__viewport > * { --fanui-carousel-slide: calc(100% - 48px); }
+  &--2 &__viewport > * { --fanui-carousel-slide: calc((100% - var(--fanui-carousel-gap, 16px)) / 2); }
+  &--3 &__viewport > * { --fanui-carousel-slide: calc((100% - var(--fanui-carousel-gap, 16px) * 2) / 3); }
+
+  &__nav {
+    position: absolute;
+    top: 50%;
+    z-index: 2;
+    display: grid;
+    place-items: center;
+    width: 38px;
+    height: 38px;
+    border: 1px solid fn.fanui-var("color-border");
+    border-radius: fn.fanui-var("radius-full");
+    background-color: fn.fanui-var("color-overlay");
+    color: fn.fanui-var("color-text");
+    box-shadow: fn.fanui-var("shadow-md");
+    cursor: pointer;
+    transform: translateY(-50%);
+    @include mx.fanui-transition((background-color, transform, opacity), v.$fanui-duration-fast);
+
+    &:hover { background-color: fn.fanui-var("color-hover"); transform: translateY(-50%) scale(1.06); }
+    &:disabled { opacity: 0.35; cursor: not-allowed; }
+
+    &--prev { inset-inline-start: -8px; }
+    &--next { inset-inline-end: -8px; }
+  }
+
+  &__dots {
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    gap: fn.fanui-var("space-2");
+    margin-top: fn.fanui-var("space-4");
+  }
+
+  &__dot {
+    width: 8px;
+    height: 8px;
+    padding: 0;
+    border: 0;
+    border-radius: fn.fanui-var("radius-full");
+    background-color: fn.fanui-var("color-border-strong");
+    cursor: pointer;
+    @include mx.fanui-transition((width, background-color), v.$fanui-duration-base, v.$fanui-ease-spring);
+
+    &.is-active {
+      width: 22px;
+      background-color: fn.fanui-var("primary");
+    }
+  }
+
+  // 进度条形式的分页器（比圆点更"新"）
+  &__progress {
+    height: 3px;
+    margin-top: fn.fanui-var("space-4");
+    border-radius: fn.fanui-var("radius-full");
+    background-color: fn.fanui-var("color-border");
+    overflow: hidden;
+  }
+
+  &__progress-bar {
+    height: 100%;
+    border-radius: inherit;
+    background-image: linear-gradient(to right, var(--fanui-primary), var(--fanui-primary-vivid));
+    transform-origin: left center;
+    transform: scaleX(var(--fanui-carousel-progress, 0));
+    @include mx.fanui-transition(transform, v.$fanui-duration-base);
+  }
+}
+
+// -----------------------------------------------------------------------------
+// 4. 悬浮主按钮 FAB（含放射菜单）
+// -----------------------------------------------------------------------------
+
+.fanui-fab {
+  position: fixed;
+  inset-block-end: fn.fanui-var("space-6");
+  inset-inline-end: fn.fanui-var("space-6");
+  z-index: fn.fanui-var("z-fixed");
+  display: flex;
+  flex-direction: column-reverse;
+  align-items: center;
+  gap: fn.fanui-var("space-3");
+
+  &__trigger {
+    display: grid;
+    place-items: center;
+    width: 54px;
+    height: 54px;
+    border: 0;
+    border-radius: fn.fanui-var("radius-full");
+    background-image: var(--fanui-brand-grad);
+    color: #fff;
+    font-size: 20px;
+    cursor: pointer;
+    box-shadow: 0 10px 24px -8px fn.fanui-var("primary-glow");
+    @include mx.fanui-transition((transform, box-shadow), v.$fanui-duration-base, v.$fanui-ease-spring);
+
+    &:hover { transform: translateY(-2px) scale(1.05); box-shadow: 0 16px 32px -10px fn.fanui-var("primary-glow"); }
+    &:active { transform: scale(0.96); }
+
+    .is-open & { transform: rotate(45deg); }
+  }
+
+  &__list {
+    display: flex;
+    flex-direction: column-reverse;
+    align-items: center;
+    gap: fn.fanui-var("space-3");
+    margin: 0;
+    padding: 0;
+    list-style: none;
+  }
+
+  &__item {
+    display: flex;
+    align-items: center;
+    gap: fn.fanui-var("space-2");
+    opacity: 0;
+    transform: translateY(10px) scale(0.9);
+    pointer-events: none;
+    @include mx.fanui-transition((opacity, transform), v.$fanui-duration-base, v.$fanui-ease-spring);
+
+    .is-open & { opacity: 1; transform: none; pointer-events: auto; }
+  }
+
+  &__action {
+    display: grid;
+    place-items: center;
+    width: 42px;
+    height: 42px;
+    border: 1px solid fn.fanui-var("color-border");
+    border-radius: fn.fanui-var("radius-full");
+    background-color: fn.fanui-var("color-overlay");
+    color: fn.fanui-var("color-text");
+    box-shadow: fn.fanui-var("shadow-md");
+    cursor: pointer;
+  }
+
+  &__text {
+    padding: 3px 8px;
+    font-size: fn.fanui-var("font-size-xs");
+    white-space: nowrap;
+    color: fn.fanui-var("color-text-inverse");
+    background-color: fn.fanui-var("color-text-strong");
+    border-radius: fn.fanui-var("radius-sm");
+  }
+
+  // 展开后逐项错峰出现
+  @for $i from 1 through 5 {
+    &__list .fanui-fab__item:nth-child(#{$i}) {
+      transition-delay: #{($i - 1) * 40}ms;
+    }
+  }
+
+  &--glass &__trigger {
+    @include mx.fanui-glass-surface($shadow: false);
+    background-image: var(--fanui-brand-grad);
+  }
+}
+
+// -----------------------------------------------------------------------------
+// 5. 阅读 / 滚动进度条
+// -----------------------------------------------------------------------------
+
+.fanui-scroll-progress {
+  position: fixed;
+  inset-block-start: 0;
+  inset-inline: 0;
+  z-index: calc(fn.fanui-var("z-fixed") + 1);
+  height: 3px;
+  background-color: transparent;
+  pointer-events: none;
+
+  &__bar {
+    height: 100%;
+    background-image: linear-gradient(to right, var(--fanui-primary), var(--fanui-accent));
+    transform-origin: left center;
+    transform: scaleX(var(--fanui-scroll-progress, 0));
+    @include mx.fanui-transition(transform, v.$fanui-duration-fast, v.$fanui-ease-linear);
+  }
+
+  &--thin { height: 2px; }
+  &--thick { height: 4px; }
+  &--glow &__bar { box-shadow: 0 0 12px fn.fanui-var("primary-glow"); }
+}
+
+// -----------------------------------------------------------------------------
+// 6. 光斑跟随卡片 Spotlight
+// -----------------------------------------------------------------------------
+// 由 JS 写入 --fanui-spot-x / --fanui-spot-y，形成"手电筒照在卡片上"的效果。
+// 纯 CSS 时默认位置也能成立（静态高光）。
+
+.fanui-spotlight {
+  position: relative;
+  isolation: isolate;
+  overflow: hidden;
+  border: 1px solid fn.fanui-var("color-border");
+  border-radius: fn.fanui-var("radius-xl");
+  background-color: fn.fanui-var("color-surface");
+  @include mx.fanui-transition((border-color, box-shadow, transform), v.$fanui-duration-base);
+
+  // 光斑层
+  &::before {
+    content: "";
+    position: absolute;
+    inset: 0;
+    z-index: 0;
+    pointer-events: none;
+    opacity: 0;
+    background: radial-gradient(
+      260px circle at var(--fanui-spot-x, 50%) var(--fanui-spot-y, 0%),
+      var(--fanui-primary-soft-2, #{fn.fanui-var("primary-soft")}),
+      transparent 68%
+    );
+    @include mx.fanui-transition(opacity, v.$fanui-duration-base);
+  }
+
+  // 边框光效：用遮罩环让描边局部点亮
+  &::after {
+    content: "";
+    position: absolute;
+    inset: 0;
+    z-index: 1;
+    pointer-events: none;
+    border-radius: inherit;
+    padding: 1px;
+    opacity: 0;
+    background: radial-gradient(
+      200px circle at var(--fanui-spot-x, 50%) var(--fanui-spot-y, 0%),
+      fn.fanui-var("primary"),
+      transparent 70%
+    );
+    -webkit-mask: linear-gradient(#000 0 0) content-box, linear-gradient(#000 0 0);
+    mask: linear-gradient(#000 0 0) content-box, linear-gradient(#000 0 0);
+    -webkit-mask-composite: xor;
+    mask-composite: exclude;
+    @include mx.fanui-transition(opacity, v.$fanui-duration-base);
+  }
+
+  &:hover::before,
+  &:hover::after { opacity: 1; }
+
+  > * { position: relative; z-index: 2; }
+
+  &:hover {
+    transform: translateY(-2px);
+    box-shadow: fn.fanui-var("shadow-lg");
+  }
+
+  &--static {
+    &::before,
+    &::after { opacity: 0.55; }
+  }
+}
+
+// -----------------------------------------------------------------------------
+// 7. 全局光标辉光（官网 / 落地页氛围）
+// -----------------------------------------------------------------------------
+
+.fanui-cursor-glow {
+  position: fixed;
+  inset: 0;
+  z-index: 0;
+  pointer-events: none;
+  background: radial-gradient(
+    520px circle at var(--fanui-cursor-x, 50%) var(--fanui-cursor-y, 30%),
+    fn.fanui-var("brand-aura-a"),
+    transparent 62%
+  );
+  opacity: 0.9;
+
+  html[data-fanui-glass="off"] & { opacity: 0.5; }
+}
+
+// -----------------------------------------------------------------------------
+// 8. 主题工作台 Theme Studio（设计系统的"驾驶舱"）
+// -----------------------------------------------------------------------------
+// 这是一个可以放进任何产品的可复用面板：12 主题色 / 深浅模式 / 液态玻璃开关与强度。
+
+.fanui-studio {
+  position: fixed;
+  inset-block-end: fn.fanui-var("space-5");
+  inset-inline-end: fn.fanui-var("space-5");
+  z-index: calc(fn.fanui-var("z-fixed") + 20);
+  display: flex;
+  flex-direction: column;
+  align-items: flex-end;
+  gap: fn.fanui-var("space-3");
+  font-size: fn.fanui-var("font-size-sm");
+
+  &__trigger {
+    display: inline-flex;
+    align-items: center;
+    gap: fn.fanui-var("space-2");
+    height: 44px;
+    padding: 0 fn.fanui-var("space-4");
+    border: 1px solid fn.fanui-var("color-border");
+    border-radius: fn.fanui-var("radius-full");
+    background-color: fn.fanui-var("color-overlay");
+    color: fn.fanui-var("color-text");
+    box-shadow: fn.fanui-var("shadow-lg");
+    cursor: pointer;
+    @include mx.fanui-glass-surface($shadow: false);
+    box-shadow: fn.fanui-var("shadow-lg");
+    @include mx.fanui-transition((transform, box-shadow), v.$fanui-duration-fast);
+
+    &:hover { transform: translateY(-2px); }
+
+    &-dot {
+      width: 14px;
+      height: 14px;
+      border-radius: fn.fanui-var("radius-full");
+      background-image: var(--fanui-brand-grad);
+      box-shadow: 0 0 0 3px fn.fanui-var("primary-ring");
+    }
+  }
+
+  &__panel {
+    width: 300px;
+    max-height: min(74vh, 620px);
+    overflow-y: auto;
+    padding: fn.fanui-var("space-5");
+    border-radius: fn.fanui-var("radius-2xl");
+    @include mx.fanui-scrollbar(6px);
+    @include mx.fanui-liquid-glass();
+    --fanui-glass-radius: #{fn.fanui-var("radius-2xl")};
+
+    opacity: 0;
+    visibility: hidden;
+    transform: translateY(12px) scale(0.97);
+    transform-origin: bottom right;
+    @include mx.fanui-transition((opacity, transform, visibility), v.$fanui-duration-slow, v.$fanui-ease-spring);
+
+    .fanui-studio.is-open & { opacity: 1; visibility: visible; transform: none; }
+  }
+
+  &__title {
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    margin-bottom: fn.fanui-var("space-4");
+    font-size: fn.fanui-var("font-size-md");
+    font-weight: fn.fanui-var("font-weight-semibold");
+    color: fn.fanui-var("color-text-strong");
+  }
+
+  &__section {
+    padding-block: fn.fanui-var("space-3");
+    border-top: 1px solid fn.fanui-var("glass-divider");
+
+    &:first-of-type { border-top: 0; padding-top: 0; }
+  }
+
+  &__label {
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    margin-bottom: fn.fanui-var("space-2");
+    font-size: fn.fanui-var("font-size-xs");
+    font-weight: fn.fanui-var("font-weight-semibold");
+    letter-spacing: fn.fanui-var("tracking-wide");
+    color: fn.fanui-var("color-text-subtle");
+    text-transform: uppercase;
+  }
+
+  &__value {
+    font-variant-numeric: tabular-nums;
+    font-weight: fn.fanui-var("font-weight-normal");
+    color: fn.fanui-var("primary-ink");
+    text-transform: none;
+    letter-spacing: 0;
+  }
+
+  // 12 主题色网格
+  &__accents {
+    display: grid;
+    grid-template-columns: repeat(6, 1fr);
+    gap: fn.fanui-var("space-2");
+  }
+
+  &__accent {
+    position: relative;
+    aspect-ratio: 1;
+    padding: 0;
+    border: 1px solid fn.fanui-alpha(#020617, 0.14);
+    border-radius: fn.fanui-var("radius-md");
+    background-image: linear-gradient(135deg, var(--fanui-studio-c1), var(--fanui-studio-c2));
+    cursor: pointer;
+    @include mx.fanui-transition((transform, box-shadow), v.$fanui-duration-fast);
+
+    &:hover { transform: translateY(-2px) scale(1.05); }
+
+    &[aria-pressed="true"] {
+      box-shadow: 0 0 0 2px fn.fanui-var("color-overlay"), 0 0 0 4px fn.fanui-var("primary");
+    }
+
+    &[aria-pressed="true"]::after {
+      content: "";
+      position: absolute;
+      inset: 0;
+      margin: auto;
+      width: 8px;
+      height: 5px;
+      border-inline-start: 2px solid #fff;
+      border-bottom: 2px solid #fff;
+      transform: rotate(-45deg) translate(1px, -1px);
+      filter: drop-shadow(0 1px 1px rgba(0, 0, 0, 0.5));
+    }
+  }
+
+  &__row {
+    display: flex;
+    align-items: center;
+    gap: fn.fanui-var("space-2");
+  }
+
+  &__hint {
+    margin-top: fn.fanui-var("space-2");
+    font-size: fn.fanui-var("font-size-xs");
+    line-height: fn.fanui-var("line-height-normal");
+    color: fn.fanui-var("color-text-subtle");
+  }
+
+  &__kbd {
+    display: inline-block;
+    padding: 0 5px;
+    font-family: fn.fanui-var("font-mono");
+    font-size: 11px;
+    line-height: 18px;
+    color: fn.fanui-var("color-text-muted");
+    background-color: fn.fanui-var("glass-divider");
+    border: 1px solid fn.fanui-var("color-border");
+    border-radius: fn.fanui-var("radius-sm");
+  }
+}
+
+// -----------------------------------------------------------------------------
+// 9. 移动端：底部抽屉 + 底部导航
+// -----------------------------------------------------------------------------
+
+.fanui-sheet {
+  @include mx.fanui-fixed-fill();
+  z-index: fn.fanui-var("z-modal");
+  display: flex;
+  align-items: flex-end;
+  justify-content: center;
+  opacity: 0;
+  visibility: hidden;
+  @include mx.fanui-transition((opacity, visibility), v.$fanui-duration-base);
+
+  &.is-open { opacity: 1; visibility: visible; }
+
+  &__backdrop {
+    @include mx.fanui-absolute-fill();
+    background-color: fn.fanui-var("backdrop-bg");
+  }
+
+  &__panel {
+    position: relative;
+    width: 100%;
+    max-width: 560px;
+    max-height: 88vh;
+    display: flex;
+    flex-direction: column;
+    padding: fn.fanui-var("space-3") fn.fanui-var("space-5") fn.fanui-var("space-6");
+    border-radius: fn.fanui-var("radius-2xl") fn.fanui-var("radius-2xl") 0 0;
+    @include mx.fanui-liquid-glass();
+    --fanui-glass-radius: #{fn.fanui-var("radius-2xl")};
+    transform: translateY(100%);
+    @include mx.fanui-transition(transform, v.$fanui-duration-slow, v.$fanui-ease-out);
+  }
+
+  &.is-open &__panel { transform: translateY(0); }
+
+  &__handle {
+    width: 40px;
+    height: 4px;
+    margin: 0 auto fn.fanui-var("space-4");
+    border-radius: fn.fanui-var("radius-full");
+    background-color: fn.fanui-var("color-border-strong");
+    flex: 0 0 auto;
+  }
+
+  &__header {
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    margin-bottom: fn.fanui-var("space-3");
+  }
+
+  &__body {
+    flex: 1 1 auto;
+    overflow-y: auto;
+    padding-bottom: env(safe-area-inset-bottom, 0);
+  }
+}
+
+.fanui-bottom-nav {
+  position: fixed;
+  inset-block-end: 0;
+  inset-inline: 0;
+  z-index: fn.fanui-var("z-fixed");
+  display: flex;
+  padding-bottom: env(safe-area-inset-bottom, 0);
+
+  &__item {
+    flex: 1 1 0;
+    display: flex;
+    flex-direction: column;
+    align-items: center;
+    gap: 3px;
+    padding: fn.fanui-var("space-2") 0;
+    border: 0;
+    background: transparent;
+    font-size: fn.fanui-var("font-size-xs");
+    color: fn.fanui-var("color-text-subtle");
+    text-decoration: none;
+    cursor: pointer;
+    @include mx.fanui-transition(color, v.$fanui-duration-fast);
+
+    &[aria-current="page"],
+    &.is-active {
+      color: fn.fanui-var("primary");
+    }
+
+    &:hover { color: fn.fanui-var("color-text"); }
+  }
+
+  &__icon {
+    display: grid;
+    place-items: center;
+    width: 24px;
+    height: 24px;
+    font-size: 18px;
+  }
+
+  &__badge {
+    position: absolute;
+    transform: translate(12px, -6px);
+  }
+}
+
+// 安全区适配（应用落地场景）
+@supports (padding: env(safe-area-inset-bottom)) {
+  .fanui-fab { inset-block-end: calc(#{fn.fanui-var("space-6")} + env(safe-area-inset-bottom, 0px)); }
+}
+
+// -----------------------------------------------------------------------------
+// 10. 动效适配
+// -----------------------------------------------------------------------------
+
+@media (prefers-reduced-motion: reduce) {
+  .fanui-dock__item { transform: none !important; }
+  .fanui-carousel__viewport { scroll-behavior: auto; }
+  .fanui-spotlight:hover { transform: none; }
+}