/*
 * 文档页：Markdown 正文排版、代码块与语法高亮、页内目录。
 *
 * 正文来自源码仓库的 docs/design/，结构不受本站控制 —— 所以这里的样式要能接住
 * 规范文档里真实出现的元素：多级标题、GFM 表格、围栏代码块、ASCII 流程图、
 * 行内代码、嵌套列表、引用块。
 */

/* ── 文档页布局 ──────────────────────────────────────────────────────── */

/*
 * 正文列用 px 定宽而不是 ch。
 * ch 是「0」字形的宽度，中文正文按 ch 算会严重偏窄 —— 中文一个字占的宽度
 * 接近 1em，而 ch 只有 0.5em 上下，同样的 ch 数在中文里只能是半行。
 * 这里按内容列（约 800px，中文一行四十来字）定宽，整组居中。
 */
.doc-layout {
  display: grid;
  grid-template-columns: minmax(0, 800px) 220px;
  gap: 64px;
  justify-content: center;
  align-items: start;
}

/* 页内目录吸顶，跟随滚动。长文档里它比返回顶部按钮有用 */
.doc-toc {
  position: sticky;
  top: 104px;
  font-size: var(--text-body);
}

.doc-toc__title {
  font-size: var(--text-caption);
  letter-spacing: 0.08em;
  text-transform: uppercase;
  color: var(--text-secondary);
  margin-bottom: 12px;
}

.doc-toc__list {
  list-style: none;
  margin: 0;
  padding: 0;
  border-inline-start: 1px solid var(--hairline);
}

.doc-toc__link {
  display: block;
  padding: 5px 0 5px 14px;
  color: var(--text-secondary);
  border-inline-start: 2px solid transparent;
  margin-inline-start: -1px;
  transition: color var(--duration-instant) var(--ease-standard),
              border-color var(--duration-instant) var(--ease-standard);
}

.doc-toc__link:hover {
  color: var(--text-primary);
  border-inline-start-color: var(--accent);
}

/* 三级标题缩进一级，层级一眼看得出 */
.doc-toc__link--3 {
  padding-inline-start: 26px;
}

/* ── Markdown 正文 ───────────────────────────────────────────────────── */

.prose {
  /* 列宽已由 .doc-layout 定好，这里不再二次限宽 */
  max-width: 100%;
  font-size: var(--text-body-web);
  line-height: 1.72;
}

.prose > * + * {
  margin-top: 18px;
}

.prose h1,
.prose h2,
.prose h3,
.prose h4,
.prose h5,
.prose h6 {
  /* 锚点跳转时标题不要贴到顶部玻璃导航下面 */
  scroll-margin-top: 96px;
}

.prose h1 {
  font-size: clamp(26px, 2vw + 18px, 34px);
  margin-top: 0;
}

.prose h2 {
  font-size: var(--text-h3);
  margin-top: 48px;
  padding-top: 24px;
  border-top: 1px solid var(--hairline);
}

.prose h3 {
  font-size: var(--text-headline);
  margin-top: 36px;
}

.prose h4 {
  font-size: var(--text-title);
  margin-top: 28px;
  color: var(--text-secondary);
}

.prose strong {
  color: var(--text-primary);
  font-weight: var(--weight-semibold);
}

.prose a {
  color: var(--accent);
  text-decoration: underline;
  text-underline-offset: 3px;
  text-decoration-thickness: 1px;
  text-decoration-color: color-mix(in srgb, var(--accent) 44%, transparent);
}

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

.prose ul,
.prose ol {
  padding-inline-start: 1.4em;
}

.prose li + li {
  margin-top: 6px;
}

.prose li > ul,
.prose li > ol {
  margin-top: 6px;
}

/* 中文标点的列表项里，项目符号跟正文的距离比西文更明显，微调一下 */
.prose li::marker {
  color: var(--text-secondary);
}

.prose blockquote {
  margin-inline: 0;
  padding: 2px 0 2px 18px;
  border-inline-start: 2px solid color-mix(in srgb, var(--accent) 46%, var(--hairline));
  color: var(--text-secondary);
}

.prose hr {
  margin-top: 40px;
  border-top: 1px solid var(--hairline);
}

.prose img {
  border-radius: var(--radius-window);
  border: 1px solid var(--hairline);
}

/* 文档里以「- 文档版本：1.0」开头的元信息段，排成紧凑的一行 */
.prose > ul:first-of-type {
  color: var(--text-secondary);
}

/* ── 文档里的表格 ────────────────────────────────────────────────────── */

.prose table {
  width: 100%;
  border-collapse: collapse;
  font-size: var(--text-body);
  /* 表格在窄屏上横向滚动，而不是把列挤成一团 */
  display: block;
  overflow-x: auto;
  border: 1px solid var(--hairline);
  border-radius: var(--radius-window);
  white-space: normal;
}

.prose thead th {
  background: var(--page-raised);
  font-size: var(--text-caption);
  letter-spacing: 0.05em;
  text-transform: uppercase;
  color: var(--text-primary);
  white-space: nowrap;
}

.prose th,
.prose td {
  padding: 10px 14px;
  text-align: start;
  vertical-align: top;
  border-bottom: 1px solid var(--hairline);
  border-inline-end: 1px solid var(--hairline);
}

.prose tr:last-child td {
  border-bottom: 0;
}

.prose th:last-child,
.prose td:last-child {
  border-inline-end: 0;
}

.prose tbody td {
  color: var(--text-secondary);
}

/* ── 代码块 ──────────────────────────────────────────────────────────── */

.code-block {
  margin: 22px 0;
  border-radius: var(--radius-window);
  border: 1px solid var(--hairline);
  background: var(--page-sunken);
  overflow: hidden;
}

/* 语言标签：贴在右上角，不占用正文高度 */
.code-block {
  position: relative;
}

.code-block[data-lang]:not([data-lang=""])::before {
  content: attr(data-lang);
  position: absolute;
  top: 0;
  right: 0;
  padding: 4px 12px;
  border-inline-start: 1px solid var(--hairline);
  border-block-end: 1px solid var(--hairline);
  border-end-start-radius: var(--radius-menu);
  font-family: var(--font-mono);
  font-size: 11px;
  letter-spacing: 0.04em;
  color: var(--text-secondary);
  background: var(--page-raised);
}

.code-block__pre {
  margin: 0;
  padding: 18px 16px;
  overflow-x: auto;
  /* 长行横向滚动，不折行 —— 折行的代码和日志会读不出结构 */
  white-space: pre;
  tab-size: 4;
}

.code-block__code {
  font-family: var(--font-mono);
  font-size: 12.5px;
  line-height: 1.72;
  font-variant-ligatures: none;
  color: var(--text-primary);
}

/* ── 语法高亮配色 ────────────────────────────────────────────────────── */

/* 注释与文档串：压暗、不抢视线 */
.code-block__code .c,
.code-block__code .c1,
.code-block__code .cm,
.code-block__code .cs,
.code-block__code .cp,
.code-block__code .cd {
  color: #66708a;
  font-style: italic;
}

/* 关键字 */
.code-block__code .k,
.code-block__code .kd,
.code-block__code .kn,
.code-block__code .kp,
.code-block__code .kr,
.code-block__code .kt,
.code-block__code .kc {
  color: #b79cff;
}

/* 字符串 */
.code-block__code .s,
.code-block__code .s1,
.code-block__code .s2,
.code-block__code .sb,
.code-block__code .sc,
.code-block__code .sd,
.code-block__code .se,
.code-block__code .sh,
.code-block__code .si,
.code-block__code .sx,
.code-block__code .sr,
.code-block__code .ss,
.code-block__code .sa,
.code-block__code .dl {
  color: #8fd6a8;
}

/* 数字与常量 */
.code-block__code .m,
.code-block__code .mf,
.code-block__code .mi,
.code-block__code .mh,
.code-block__code .mo,
.code-block__code .mb,
.code-block__code .mx,
.code-block__code .no {
  color: #f0b25c;
}

/* 函数与方法名 */
.code-block__code .nf,
.code-block__code .fm,
.code-block__code .nd {
  color: #8ab4ff;
}

/* 类型、类名、内建 */
.code-block__code .nc,
.code-block__code .nn,
.code-block__code .nb,
.code-block__code .bp,
.code-block__code .nt {
  color: #7fd8d8;
}

/* 变量、属性、标签 */
.code-block__code .nv,
.code-block__code .vc,
.code-block__code .vg,
.code-block__code .vi,
.code-block__code .na,
.code-block__code .py,
.code-block__code .nl {
  color: #e6e9f0;
}

/* 运算符与标点 */
.code-block__code .o,
.code-block__code .ow,
.code-block__code .p {
  color: #a8afbd;
}

/* 泛型强调、插入、删除 */
.code-block__code .gd {
  color: #ff9d9d;
}

.code-block__code .gi {
  color: #8fd6a8;
}

.code-block__code .gh {
  color: var(--accent);
  font-weight: var(--weight-semibold);
}

.code-block__code .gu {
  color: #b79cff;
  font-weight: var(--weight-semibold);
}

.code-block__code .err {
  color: #ff8a8a;
}

/* 浅色档换一套对应配色 —— 深色档那几个高饱和色在浅底上对比度不够 */
[data-theme="light"] .code-block__code .c,
[data-theme="light"] .code-block__code .c1,
[data-theme="light"] .code-block__code .cm,
[data-theme="light"] .code-block__code .cs,
[data-theme="light"] .code-block__code .cp,
[data-theme="light"] .code-block__code .cd {
  color: #7b8397;
}

[data-theme="light"] .code-block__code .k,
[data-theme="light"] .code-block__code .kd,
[data-theme="light"] .code-block__code .kn,
[data-theme="light"] .code-block__code .kp,
[data-theme="light"] .code-block__code .kr,
[data-theme="light"] .code-block__code .kt,
[data-theme="light"] .code-block__code .kc {
  color: #6b3fd4;
}

[data-theme="light"] .code-block__code .s,
[data-theme="light"] .code-block__code .s1,
[data-theme="light"] .code-block__code .s2,
[data-theme="light"] .code-block__code .sb,
[data-theme="light"] .code-block__code .sc,
[data-theme="light"] .code-block__code .sd,
[data-theme="light"] .code-block__code .se,
[data-theme="light"] .code-block__code .sh,
[data-theme="light"] .code-block__code .si,
[data-theme="light"] .code-block__code .sx,
[data-theme="light"] .code-block__code .sr,
[data-theme="light"] .code-block__code .ss,
[data-theme="light"] .code-block__code .sa,
[data-theme="light"] .code-block__code .dl {
  color: #1f7a45;
}

[data-theme="light"] .code-block__code .m,
[data-theme="light"] .code-block__code .mf,
[data-theme="light"] .code-block__code .mi,
[data-theme="light"] .code-block__code .mh,
[data-theme="light"] .code-block__code .mo,
[data-theme="light"] .code-block__code .mb,
[data-theme="light"] .code-block__code .mx,
[data-theme="light"] .code-block__code .no {
  color: #a35a00;
}

[data-theme="light"] .code-block__code .nf,
[data-theme="light"] .code-block__code .fm,
[data-theme="light"] .code-block__code .nd {
  color: #1f5fbf;
}

[data-theme="light"] .code-block__code .nc,
[data-theme="light"] .code-block__code .nn,
[data-theme="light"] .code-block__code .nb,
[data-theme="light"] .code-block__code .bp,
[data-theme="light"] .code-block__code .nt {
  color: #0d6f75;
}

[data-theme="light"] .code-block__code .nv,
[data-theme="light"] .code-block__code .vc,
[data-theme="light"] .code-block__code .vg,
[data-theme="light"] .code-block__code .vi,
[data-theme="light"] .code-block__code .na,
[data-theme="light"] .code-block__code .py,
[data-theme="light"] .code-block__code .nl {
  color: #171a20;
}

/* ── 文档索引卡片 ────────────────────────────────────────────────────── */

.doc-card {
  display: flex;
  flex-direction: column;
  height: 100%;
}

.doc-card__version {
  font-family: var(--font-mono);
  font-size: var(--text-caption);
  color: var(--text-secondary);
}

/* ── 小屏：目录收到正文上方 ──────────────────────────────────────────── */

@media (max-width: 1080px) {
  .doc-layout {
    grid-template-columns: minmax(0, 1fr);
    gap: 36px;
  }

  .doc-toc {
    position: static;
    order: -1;
    padding: 18px 20px;
    border: 1px solid var(--hairline);
    border-radius: var(--radius-window);
    background: var(--page-raised);
  }

  .doc-toc__list {
    border-inline-start: 0;
    columns: 2;
    column-gap: 24px;
  }

  .doc-toc__link {
    border-inline-start: 0;
    padding-inline-start: 0;
  }
}