/* docs.css — 技术文档双栏布局 + 长文排版
   左侧 sticky 目录 + 右侧 720px 正文 + 上下篇导航 */

/* ───────── 文档首页 (docs/index.html) ───────── */

.docs-index {
  padding: 72px 0 96px;
}

.docs-index__head {
  margin-bottom: 56px;
  padding-bottom: 32px;
  border-bottom: 1px solid var(--rule);
  max-width: 760px;
}
.docs-index__head h1 {
  font-size: 44px;
  margin: 12px 0 16px;
}
.docs-index__head .lead {
  font-size: 18px;
  line-height: 1.7;
  color: var(--ink-2);
  margin: 0 0 18px;
}
.docs-index__meta {
  font-family: var(--font-mono);
  font-size: 12px;
  color: var(--ink-3);
  letter-spacing: 0.04em;
}
.docs-index__meta .ver {
  background: var(--code-bg);
  border: 1px solid var(--rule-soft);
  padding: 3px 10px;
  margin-right: 14px;
  letter-spacing: 0.08em;
}

.docs-cards {
  display: grid;
  grid-template-columns: 1fr 1fr;
  gap: 24px;
}
.docs-card {
  text-decoration: none;
  border: 1px solid var(--rule);
  padding: 32px 28px;
  display: flex;
  flex-direction: column;
  gap: 12px;
  color: inherit;
  transition: background var(--dur-hover) var(--ease-out),
              border-color var(--dur-hover) var(--ease-out);
}
.docs-card:hover {
  background: var(--surface-2);
  border-color: var(--rule);
  color: inherit;
}
.docs-card__no {
  font-family: var(--font-mono);
  font-size: 11px;
  letter-spacing: 0.14em;
  text-transform: uppercase;
  color: var(--ink-3);
}
.docs-card__no::before {
  content: "§ ";
  color: var(--accent);
}
.docs-card h3 {
  font-size: 22px;
  margin: 0;
  line-height: 1.3;
}
.docs-card__desc {
  color: var(--ink-2);
  font-size: 14px;
  line-height: 1.7;
  margin: 0;
}
.docs-card__arrow {
  margin-top: auto;
  padding-top: 8px;
  font-family: var(--font-mono);
  font-size: 12px;
  letter-spacing: 0.06em;
  color: var(--ink-3);
}
.docs-card:hover .docs-card__arrow {
  color: var(--accent);
}

/* ───────── 文档正文页 (architecture.html 等) ───────── */

.docs-shell {
  padding: 56px 0 96px;
}

.docs-grid {
  display: grid;
  grid-template-columns: 220px 1fr;
  gap: 64px;
  align-items: start;
}

/* 左侧目录 */
.docs-toc {
  position: sticky;
  top: 88px;
  font-family: var(--font-mono);
}
.docs-toc__label {
  font-size: 11px;
  letter-spacing: 0.14em;
  text-transform: uppercase;
  color: var(--ink-3);
  margin-bottom: 18px;
}
.docs-toc ul {
  list-style: none;
  margin: 0;
  padding: 0;
  border-left: 1px solid var(--rule-soft);
}
.docs-toc li { margin: 0; }
.docs-toc a {
  display: block;
  padding: 8px 0 8px 18px;
  color: var(--ink-2);
  text-decoration: none;
  border-left: 2px solid transparent;
  margin-left: -1px;
  font-size: 12.5px;
  line-height: 1.5;
  letter-spacing: 0.02em;
  transition: color var(--dur-hover) var(--ease-out),
              border-color var(--dur-hover) var(--ease-out);
}
.docs-toc a:hover {
  color: var(--accent);
}

/* 正文区 */
.docs-content {
  max-width: 720px;
  min-width: 0;  /* 防止 grid 子项撑爆 */
}

.docs-breadcrumb {
  font-family: var(--font-mono);
  font-size: 11px;
  letter-spacing: 0.12em;
  text-transform: uppercase;
  color: var(--ink-3);
  margin-bottom: 24px;
}
.docs-breadcrumb a {
  color: var(--ink-3);
  text-decoration: none;
}
.docs-breadcrumb a:hover { color: var(--accent); }
.docs-breadcrumb .sep { margin: 0 10px; opacity: 0.6; }

.docs-content > h1 {
  font-size: 40px;
  line-height: 1.2;
  margin: 0 0 16px;
}

.docs-content__lead {
  font-size: 18px;
  line-height: 1.7;
  color: var(--ink-2);
  margin: 0 0 40px;
  padding-bottom: 28px;
  border-bottom: 1px solid var(--rule);
}

.docs-content > h2 {
  font-size: 26px;
  margin: 64px 0 16px;
  scroll-margin-top: 88px;
}

.docs-content > h3 {
  font-size: 17px;
  margin: 36px 0 10px;
  font-weight: 500;
  letter-spacing: 0.01em;
}

.docs-content p {
  font-size: 15.5px;
  line-height: 1.85;
  margin: 0 0 1em;
}

.docs-content ul,
.docs-content ol {
  font-size: 15.5px;
  line-height: 1.85;
  color: var(--ink-2);
  padding-left: 22px;
  margin: 0 0 1em;
}
.docs-content li {
  margin: 4px 0;
}

.docs-content pre {
  font-size: 13px;
  line-height: 1.6;
}

.docs-content table {
  margin: 20px 0 24px;
  font-size: 14px;
}
.docs-content table th,
.docs-content table td {
  padding: 12px 14px;
  line-height: 1.55;
}
/* 第一列加 min-width，避免 5 字短标签被挤成三行 */
.docs-content table th:first-child,
.docs-content table td:first-child {
  min-width: 120px;
}

.docs-content blockquote {
  font-size: 16px;
  line-height: 1.6;
}

/* 上一篇 / 下一篇 */
.docs-prevnext {
  margin-top: 80px;
  padding-top: 32px;
  border-top: 1px solid var(--rule);
  display: grid;
  grid-template-columns: 1fr 1fr;
  gap: 20px;
}
.docs-prevnext a {
  text-decoration: none;
  border: 1px solid var(--rule-soft);
  padding: 22px 24px;
  display: block;
  color: inherit;
  transition: background var(--dur-hover) var(--ease-out),
              border-color var(--dur-hover) var(--ease-out);
}
.docs-prevnext a:hover {
  background: var(--surface-2);
  border-color: var(--rule);
  color: inherit;
}
.docs-prevnext .label {
  font-family: var(--font-mono);
  font-size: 11px;
  letter-spacing: 0.12em;
  text-transform: uppercase;
  color: var(--ink-3);
  margin-bottom: 8px;
}
.docs-prevnext .title {
  font-size: 15px;
  color: var(--ink);
  font-weight: 500;
}
.docs-prevnext .next {
  text-align: right;
}

/* ───────── 简化版 footer (docs 子页用) ───────── */

.docs-footer {
  border-top: 1px solid var(--rule);
  padding: 40px 0;
  font-family: var(--font-mono);
  font-size: 12px;
  color: var(--ink-3);
  letter-spacing: 0.04em;
}
.docs-footer__row {
  display: flex;
  justify-content: space-between;
  align-items: baseline;
  flex-wrap: wrap;
  gap: 12px;
}
.docs-footer a {
  color: var(--ink-3);
  text-decoration: none;
}
.docs-footer a:hover { color: var(--accent); }

/* ───────── 响应式 ───────── */

@media (max-width: 980px) {
  .docs-grid {
    grid-template-columns: 1fr;
    gap: 32px;
  }
  .docs-toc {
    position: static;
    border-bottom: 1px solid var(--rule-soft);
    padding-bottom: 24px;
  }
  .docs-toc ul {
    border-left: 0;
    display: flex;
    flex-wrap: wrap;
    gap: 8px 20px;
  }
  .docs-toc a {
    padding: 0;
    border-left: 0;
  }
  .docs-cards {
    grid-template-columns: 1fr;
  }
  .docs-prevnext {
    grid-template-columns: 1fr;
  }
  .docs-prevnext .next {
    text-align: left;
  }
}

@media (max-width: 640px) {
  .docs-index__head h1,
  .docs-content > h1 {
    font-size: 30px;
  }
  .docs-content > h2 {
    font-size: 22px;
    margin-top: 48px;
  }
  .docs-shell {
    padding: 40px 0 64px;
  }
}