/* ============================================================================
   帮助文档（docs/）—— 复用官网的变量与页头页脚，只补文档专属布局与排版
   ============================================================================
   依赖 assets/style.css 里的 :root 变量（--bg / --text / --accent / --maxw …）
   本文件只负责：两栏布局、正文排版、目录页卡片、草稿/已验证标记。
   ========================================================================= */

/* ------------------------------------------------------------------ 文档页 */

.docs-layout {
  display: grid;
  grid-template-columns: 220px minmax(0, 1fr);
  gap: 56px;
  padding-top: 40px;
  padding-bottom: 80px;
}

/* 侧栏：跟随滚动，但不与页脚打架 */
.docs-side {
  position: sticky;
  top: 86px;
  align-self: start;
  max-height: calc(100vh - 110px);
  overflow-y: auto;
  padding-right: 8px;
}

.docs-side__title {
  font-size: 12px;
  font-weight: 700;
  letter-spacing: 0.08em;
  text-transform: uppercase;
  color: var(--text-faint);
  margin-bottom: 12px;
}

.docs-side nav {
  display: flex;
  flex-direction: column;
  gap: 2px;
}

.docs-side__link {
  display: flex;
  align-items: center;
  justify-content: space-between;
  gap: 8px;
  padding: 8px 10px;
  border-radius: 8px;
  color: var(--text-dim);
  font-size: 14px;
  line-height: 1.4;
  transition:
    background 0.15s,
    color 0.15s;
}

.docs-side__link:hover {
  background: var(--bg-soft);
  color: var(--text);
  text-decoration: none;
}

.docs-side__link.is-active {
  background: var(--accent-soft);
  color: var(--text-bright);
  box-shadow: inset 2px 0 0 var(--accent);
}

.docs-side__draft {
  flex: none;
  font-size: 10px;
  padding: 1px 6px;
  border-radius: 999px;
  border: 1px solid var(--border);
  color: var(--text-faint);
}

/* 正文容器 */
.docs-main {
  min-width: 0;
  max-width: 760px;
}

/* ------------------------------------------------------- 草稿 / 已验证标记 */

.docs-verified {
  display: inline-block;
  margin-bottom: 18px;
  padding: 5px 12px;
  border-radius: 999px;
  font-size: 12px;
  color: var(--accent);
  background: var(--accent-soft);
  border: 1px solid rgba(16, 185, 129, 0.35);
}

.docs-draft-banner {
  margin-bottom: 22px;
  padding: 10px 14px;
  border-radius: 10px;
  font-size: 13px;
  line-height: 1.6;
  color: #fcd34d;
  background: rgba(245, 158, 11, 0.1);
  border: 1px solid rgba(245, 158, 11, 0.3);
}

/* ---------------------------------------------------------------- 正文排版 */

.prose {
  font-size: 15.5px;
  line-height: 1.8;
  color: var(--text);
}

.prose > :first-child {
  margin-top: 0;
}

.prose h1 {
  font-size: 30px;
  line-height: 1.25;
  letter-spacing: -0.01em;
  margin: 0 0 18px;
  color: var(--text-bright);
}

.prose h2 {
  font-size: 21px;
  line-height: 1.35;
  margin: 40px 0 14px;
  padding-top: 18px;
  border-top: 1px solid var(--border-soft);
  color: var(--text-bright);
}

.prose h3 {
  font-size: 17px;
  margin: 28px 0 10px;
  color: var(--text-bright);
}

.prose p {
  margin: 0 0 14px;
}

.prose ul,
.prose ol {
  margin: 0 0 16px;
  padding-left: 22px;
}

.prose li {
  margin: 6px 0;
}

.prose li::marker {
  color: var(--text-faint);
}

.prose strong {
  color: var(--text-bright);
  font-weight: 600;
}

.prose a {
  color: var(--accent);
}

.prose code {
  font-family: var(--mono);
  font-size: 0.88em;
  padding: 2px 6px;
  border-radius: 5px;
  background: var(--bg-soft);
  border: 1px solid var(--border-soft);
  color: #a7f3d0;
}

.prose pre {
  margin: 0 0 18px;
  padding: 14px 16px;
  border-radius: 10px;
  background: #0a1120;
  border: 1px solid var(--border);
  overflow-x: auto;
}

.prose pre code {
  padding: 0;
  border: 0;
  background: none;
  color: var(--text);
  font-size: 13.5px;
  line-height: 1.7;
}

/* 图片：文档里大量使用，统一圆角 + 描边 + 说明字 */
.prose img {
  display: block;
  max-width: 100%;
  height: auto;
  margin: 6px 0 6px;
  border-radius: 10px;
  border: 1px solid var(--border);
  background: var(--bg-soft);
}

.prose table {
  width: 100%;
  margin: 0 0 18px;
  border-collapse: collapse;
  font-size: 14px;
}

.prose th,
.prose td {
  padding: 9px 12px;
  border: 1px solid var(--border-soft);
  text-align: left;
  vertical-align: top;
}

.prose th {
  background: var(--bg-soft);
  color: var(--text-bright);
  font-weight: 600;
}

.prose blockquote {
  margin: 0 0 18px;
  padding: 10px 16px;
  border-left: 3px solid var(--accent);
  background: var(--bg-soft);
  border-radius: 0 8px 8px 0;
  color: var(--text-dim);
}

.prose hr {
  margin: 32px 0;
  border: 0;
  border-top: 1px solid var(--border-soft);
}

/* -------------------------------------------------------------- 上下篇导航 */

.docs-pager {
  display: flex;
  justify-content: space-between;
  gap: 16px;
  margin-top: 48px;
  padding-top: 20px;
  border-top: 1px solid var(--border-soft);
  font-size: 14px;
}

/* ---------------------------------------------------------------- 目录页 */

.docs-index {
  padding-top: 56px;
  padding-bottom: 90px;
}

.docs-index h1 {
  font-size: 34px;
  margin: 0 0 12px;
  color: var(--text-bright);
}

.docs-index__lead {
  max-width: 640px;
  color: var(--text-dim);
  margin: 0 0 36px;
}

.docs-cards {
  display: grid;
  grid-template-columns: repeat(auto-fill, minmax(280px, 1fr));
  gap: 18px;
}

.docs-card {
  display: block;
  padding: 20px;
  border-radius: var(--radius);
  background: var(--bg-soft);
  border: 1px solid var(--border);
  transition:
    border-color 0.15s,
    transform 0.15s;
}

.docs-card:hover {
  border-color: var(--accent);
  transform: translateY(-2px);
  text-decoration: none;
}

.docs-card h3 {
  margin: 0 0 8px;
  font-size: 16px;
  color: var(--text-bright);
}

.docs-card p {
  margin: 0 0 14px;
  font-size: 13.5px;
  line-height: 1.6;
  color: var(--text-dim);
}

.docs-card__meta {
  font-size: 11.5px;
  color: var(--text-faint);
}

/* ---------------------------------------------------------------- 响应式 */

@media (max-width: 900px) {
  .docs-layout {
    grid-template-columns: 1fr;
    gap: 24px;
    padding-top: 24px;
  }

  .docs-side {
    position: static;
    max-height: none;
    padding-bottom: 16px;
    border-bottom: 1px solid var(--border-soft);
  }

  .docs-side nav {
    flex-direction: row;
    flex-wrap: wrap;
  }

  .docs-main {
    max-width: none;
  }
}