/* ===================================================================
 * components.css · 组件层(所有 UI 组件类)
 * 全部用 var() 引用令牌,换肤时本文件不动
 * 组件变体/状态遵循 design-system/skins 规范
 * =================================================================== */

/* ---------- 按钮 ---------- */
.btn {
  display: inline-flex;
  align-items: center;
  justify-content: center;
  gap: 8px;
  font-family: var(--font-body);
  font-weight: var(--font-weight-medium);
  line-height: 1;
  white-space: nowrap;
  border: var(--border-width-thin) solid transparent;
  cursor: pointer;
  transition:
    background var(--motion-duration-fast) var(--motion-easing-standard),
    border-color var(--motion-duration-fast) var(--motion-easing-standard),
    transform var(--motion-duration-fast) var(--motion-easing-standard),
    box-shadow var(--motion-duration-fast) var(--motion-easing-standard);
  /* 默认 md 尺寸:满足 44px 热区 */
  padding: 12px 28px;
  border-radius: var(--radius-full);
  min-height: 44px;
}
.btn:active { transform: scale(0.97); }

.btn--lg { padding: 15px 36px; min-height: 52px; font-size: var(--font-size-lg); }
.btn--sm { padding: 9px 20px; min-height: 36px; font-size: var(--font-size-sm); }

/* primary 变体:主色实色 + 白字 */
.btn--primary {
  background: var(--color-primary);
  color: var(--color-text-inverse);
  box-shadow: var(--shadow-sm);
}
.btn--primary:hover {
  opacity: 0.9;
  box-shadow: var(--shadow-md);
}

/* outline 变体:透明 + 主色描边 */
.btn--outline {
  background: transparent;
  color: var(--color-primary);
  border-color: var(--color-primary);
}
.btn--outline:hover { background: var(--color-primary); color: var(--color-text-inverse); }

/* ghost 变体:无填充,hover 浅底 */
.btn--ghost {
  background: transparent;
  color: var(--color-text);
}
.btn--ghost:hover { background: var(--color-card); }

/* ---------- 卡片 ---------- */
.card {
  background: var(--color-card);
  border-radius: var(--radius-lg);
  padding: var(--space-card-pad);
  box-shadow: var(--shadow-md);
  transition:
    transform var(--motion-duration-normal) var(--motion-easing-standard),
    box-shadow var(--motion-duration-normal) var(--motion-easing-standard);
}
/* 可点击的卡片:hover 上浮 */
.card--clickable { cursor: pointer; display: block; }
.card--clickable:hover {
  transform: translateY(-4px);
  box-shadow: var(--shadow-lg);
}

/* 媒体优先卡片:图片置顶 */
.card--media-first { padding: 0; overflow: hidden; }
.card--media-first .card__media {
  width: 100%;
  aspect-ratio: var(--ratio-card, 4/3);
  background: var(--color-border);
  display: flex;
  align-items: center;
  justify-content: center;
  font-size: 3rem;
}
.card--media-first .card__body { padding: var(--space-card-pad); }

/* ---------- 标签 / 徽章 ---------- */
.tag {
  display: inline-flex;
  align-items: center;
  padding: 4px 12px;
  border-radius: var(--radius-full);
  font-size: var(--font-size-xs);
  font-weight: var(--font-weight-medium);
  background: var(--color-primary-soft, rgba(74, 107, 71, 0.12));
  color: var(--color-primary);
  line-height: 1.5;
}

.badge {
  display: inline-flex;
  align-items: center;
  justify-content: center;
  min-width: 20px;
  height: 20px;
  padding: 0 6px;
  border-radius: var(--radius-full);
  font-size: var(--font-size-xs);
  font-weight: var(--font-weight-semibold);
  background: var(--color-secondary);
  color: var(--color-text-inverse);
}

/* ---------- 顶部导航栏 ---------- */
.navbar {
  position: sticky;
  top: 0;
  z-index: 100;
  background: var(--color-navbar-bg, transparent);
  backdrop-filter: blur(12px);
  -webkit-backdrop-filter: blur(12px);
  border-bottom: 1px solid transparent;
  transition: border-color var(--motion-duration-normal) var(--motion-easing-standard),
              background var(--motion-duration-normal) var(--motion-easing-standard);
}
/* 滚动后转实底 */
.navbar.is-scrolled {
  background: var(--color-navbar-solid, var(--color-card));
  border-bottom-color: var(--color-border);
}
.navbar__inner {
  display: flex;
  align-items: center;
  justify-content: space-between;
  height: 56px;
}
.navbar__brand {
  font-family: var(--font-heading);
  font-weight: var(--font-weight-semibold);
  font-size: var(--font-size-lg);
  color: var(--color-text);
}
.navbar__links {
  display: flex;
  align-items: center;
  gap: 24px;
}
.navbar__links a {
  color: var(--color-text-secondary);
  font-size: var(--font-size-sm);
}
.navbar__links a:hover,
.navbar__links a.is-active { color: var(--color-primary); opacity: 1; }

/* ---------- 列表项 ---------- */
.list-item {
  display: flex;
  align-items: center;
  gap: 16px;
  padding: 16px var(--space-page-x);
  border-bottom: 1px solid var(--color-border);
}
.list-item__icon {
  width: 44px;
  height: 44px;
  flex-shrink: 0;
  border-radius: var(--radius-md);
  background: var(--color-primary-soft, rgba(74, 107, 71, 0.12));
  display: flex;
  align-items: center;
  justify-content: center;
  font-size: 1.4rem;
}
.list-item__main { flex: 1; min-width: 0; }
.list-item__title { font-weight: var(--font-weight-medium); }
.list-item__sub { font-size: var(--font-size-sm); color: var(--color-text-muted); }

/* ---------- 区块标题 ---------- */
.section-head { margin-bottom: 32px; }
.section-head__eyebrow {
  display: inline-block;
  font-size: var(--font-size-sm);
  color: var(--color-primary);
  letter-spacing: var(--letter-spacing-wide);
  margin-bottom: 8px;
}
.section-head__title {
  font-size: var(--font-size-2xl);
  margin-bottom: 8px;
}
.section-head__desc { color: var(--color-text-secondary); max-width: 42ch; }

/* ---------- 返回门户条(demo 页顶部) ---------- */
.demo-bar {
  background: var(--color-text);
  color: var(--color-text-inverse);
  font-size: var(--font-size-sm);
}
.demo-bar__inner {
  display: flex;
  align-items: center;
  justify-content: space-between;
  height: 40px;
}
.demo-bar a { color: var(--color-text-inverse); }
.demo-bar__tag {
  padding: 2px 10px;
  border-radius: var(--radius-full);
  background: var(--color-primary);
  font-size: var(--font-size-xs);
}

/* ---------- 文档/指南页专用 ---------- */
.doc-layout {
  display: grid;
  grid-template-columns: 240px 1fr;
  gap: 48px;
  max-width: var(--container-max);
  margin-inline: auto;
  padding: 48px var(--space-page-x);
}
.doc-toc {
  position: sticky;
  top: 80px;
  align-self: start;
  font-size: var(--font-size-sm);
}
.doc-toc h4 {
  font-size: var(--font-size-xs);
  color: var(--color-text-muted);
  letter-spacing: var(--letter-spacing-wide);
  text-transform: uppercase;
  margin-bottom: 12px;
}
.doc-toc ul { display: flex; flex-direction: column; gap: 8px; }
.doc-toc a { color: var(--color-text-secondary); }
.doc-toc a:hover { color: var(--color-primary); }

.doc-content { max-width: 72ch; }
.doc-content section { margin-bottom: 56px; }
.doc-content h2 { margin-bottom: 16px; padding-bottom: 12px; border-bottom: 1px solid var(--color-border); }
.doc-content h3 { margin: 32px 0 12px; }
.doc-content p { margin-bottom: 16px; color: var(--color-text-secondary); }
.doc-content ul, .doc-content ol { margin: 0 0 16px 20px; color: var(--color-text-secondary); }
.doc-content li { margin-bottom: 8px; }
.doc-content ul li { list-style: disc; }
.doc-content ol li { list-style: decimal; }
.doc-content strong { color: var(--color-text); }
.doc-content code {
  background: var(--color-card);
  padding: 2px 6px;
  border-radius: var(--radius-sm);
  font-size: 0.9em;
  border: 1px solid var(--color-border);
}

/* 代码块 */
.code-block {
  background: var(--color-code-bg, #1f2419);
  color: var(--color-code-text, #e8ebe3);
  padding: 20px 24px;
  border-radius: var(--radius-md);
  overflow-x: auto;
  font-family: var(--font-mono);
  font-size: var(--font-size-sm);
  line-height: 1.7;
  margin: 16px 0 24px;
}
.code-block code { background: none; border: none; padding: 0; color: inherit; }

/* 响应式:平板及以下文档布局折叠 */
@media (max-width: 900px) {
  .doc-layout { grid-template-columns: 1fr; gap: 24px; padding-top: 24px; }
  .doc-toc { position: static; display: none; }
}

/* ---------- 通知条 ---------- */
.callout {
  background: var(--color-primary-soft, rgba(74, 107, 71, 0.08));
  border-left: 3px solid var(--color-primary);
  padding: 16px 20px;
  border-radius: var(--radius-sm);
  margin: 16px 0 24px;
}
.callout p:last-child { margin-bottom: 0; }
.callout strong { color: var(--color-primary); }