/* 独立页面的正文排版层。
 *
 * 这一层的存在理由：独立页不经过 VitePress，拿不到 .vp-doc 的排版规则，
 * 于是历史上每个页面都用 Tailwind 工具类现搭一套标题和卡片，各搭各的，
 * 最终 4 个页面用出 8–13 个色相、79 处渐变、每个标题一个彩色图标块。
 *
 * 解法不是「少用点颜色」，而是把知识库的排版语法固化成类，让页面作者
 * 没有现搭的必要。规则与 docs/.vitepress/theme/styles/ 下的
 * knowledge-content.css、doc-enhance.css 逐条对齐，改动需两边同步。
 *
 * 核心语法（照搬 knowledge-content.css 的决定，不要在此重新发明）：
 *   h1  底部细线 + 左端 3rem 栏目色短线
 *   h2  底部细线，线色 = 栏目色与分隔线 32% 混合
 *   h3  不加任何线，只靠字号与上下间距区分
 *       —— 长文里两道线会互相干扰，这是原设计明确写下的理由
 */

/* ===== 正文容器 ===== */

/* 选择器必须带上 body.page-shell > main.page-prose。
   page-shell.css 有 `body.page-shell > main { width: 100% }`，特指度
   (0,1,2) 压过单类名的 (0,1,0)；正文容器通常就挂在 <main> 上，只写
   .page-prose 的话栏宽会被冲掉，正文铺满整个视口。 */
body.page-shell > main.page-prose,
.page-prose {
  width: min(100% - 2rem, var(--page-prose-max));
  margin-inline: auto;
  font-size: var(--page-text-base);
  line-height: 1.8;
}

/* 长文页面在 body 上加 .page-shell--article：把面包屑和 hero 收窄到与
   正文同宽。否则 80rem 的 hero 压在 44rem 的正文上，两条左边界对不齐，
   页面看起来像两个模板拼的。 */
.page-shell--article .page-breadcrumb,
.page-shell--article .page-hero {
  width: min(100% - 2rem, var(--page-prose-max));
}

@media (max-width: 640px) {
  .page-shell--article .page-breadcrumb,
  .page-shell--article .page-hero {
    width: min(100% - 1.25rem, var(--page-prose-max));
  }
}

/* 需要放宽表格或图示时，单独给那一块用 .page-prose__wide 顶出去，
   而不是把整篇正文拉宽——行长一超标，中文回扫就开始串行。 */
.page-prose__wide {
  width: min(100vw - 2rem, var(--page-prose-wide-max));
  margin-inline: calc(50% - min(50vw - 1rem, var(--page-prose-wide-max) / 2));
}

/* ===== 标题 ===== */

.page-prose h2 {
  margin: 3rem 0 1.25rem;
  padding-bottom: 0.5rem;
  border-bottom: 1px solid
    color-mix(in srgb, var(--page-accent) 32%, var(--page-border));
  color: rgb(var(--c-slate-900));
  font-size: var(--page-text-xl);
  font-weight: 700;
  letter-spacing: -0.02em;
  line-height: 1.4;
}

.page-prose h3 {
  margin: 2rem 0 0.75rem;
  color: rgb(var(--c-slate-900));
  font-size: var(--page-text-lg);
  font-weight: 700;
  line-height: 1.5;
}

.page-prose h4 {
  margin: 1.5rem 0 0.5rem;
  color: rgb(var(--c-slate-800));
  font-size: var(--page-text-base);
  font-weight: 700;
}

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

/* ===== 块级元素 ===== */

.page-prose p {
  margin: 0 0 1.25rem;
}

/* list-style 必须显式写出来。
   tailwind.css 的 preflight 有 `ol, ul, menu { list-style: none }`，
   而本文件只声明 margin/padding 的话，list-style 这一条无人覆盖，
   preflight 的取值就是最终值——符号和编号全部消失，列表密集的正文
   会塌成一堆没有层级的段落。这与 <link> 顺序无关：本文件的选择器
   带类名（0,1,1），本就压得过 preflight 的元素选择器（0,0,1），
   但**没写的属性压不过任何东西**。

   同理下面的 a 必须显式声明 text-decoration，preflight 是 inherit。 */

.page-prose ul {
  margin: 0 0 1.25rem;
  padding-left: 1.35rem;
  list-style: disc;
}

.page-prose ol {
  margin: 0 0 1.25rem;
  padding-left: 1.35rem;
  list-style: decimal;
}

.page-prose ul ul {
  list-style: circle;
}

.page-prose li::marker {
  color: var(--page-muted);
}

.page-prose li {
  margin-bottom: 0.5rem;
}

.page-prose li > :is(ul, ol) {
  margin-top: 0.5rem;
}

.page-prose a {
  color: var(--page-accent-strong);
  text-decoration: underline;
  text-decoration-thickness: 1px;
  text-underline-offset: 3px;
}

.page-prose strong {
  font-weight: 700;
}

.page-prose blockquote {
  margin: 1.5rem 0;
  padding: 0.25rem 0 0.25rem 1rem;
  border-left: 3px solid var(--page-accent);
  color: var(--page-muted);
}

.page-prose code {
  padding: 0.15em 0.4em;
  border-radius: 4px;
  background: rgb(var(--c-slate-100));
  font-family: var(--page-font-mono);
  font-size: 0.9em;
}

.page-prose pre {
  margin: 1.5rem 0;
  padding: 1rem 1.25rem;
  overflow-x: auto;
  border: 1px solid var(--page-border);
  border-radius: var(--page-radius-sm);
  background: rgb(var(--c-slate-50));
  font-size: var(--page-text-md);
  line-height: 1.6;
}

.page-prose pre code {
  padding: 0;
  background: none;
  font-size: inherit;
}

/* ===== 表格 =====
   表格是扫读的密集信息，用 15px 与线性阅读的正文区分；这与知识库
   doc-enhance.css 对 .vp-doc table 的处理一致。 */

.page-prose table {
  width: 100%;
  margin: 1.5rem 0;
  border-collapse: collapse;
  font-size: var(--page-text-md);
}

.page-prose :is(th, td) {
  padding: 0.6rem 0.75rem;
  border-bottom: 1px solid var(--page-border);
  text-align: left;
  vertical-align: top;
}

.page-prose th {
  border-bottom-width: 2px;
  color: rgb(var(--c-slate-900));
  font-weight: 700;
  white-space: nowrap;
}

/* 窄屏下让表格自己横向滚动，页面本体不许出现横向滚动条。 */
.page-table-scroll {
  margin: 1.5rem 0;
  overflow-x: auto;
}

.page-table-scroll > table {
  margin: 0;
}

/* ===== 受控组件 =====
   只有这几个。需要新组件时先问：知识库里有没有对应物？没有的话，
   它多半是装饰而不是信息，不要加。

   注意：下面四个 __title 都是 <p class="...">，单类名特指度 (0,1,0)
   压不过基础规则 .page-prose p 的 (0,1,1)。它们的紧凑边距必须靠
   .page-prose 前缀拿回来，见本节末尾那条合并规则——新增组件里的
   p / ul / a 一律有同样的问题，照此处理。 */

/* 提示块。对应知识库的 custom-block，同样只用左侧色条，不填色不加阴影。 */
.page-note {
  margin: 1.5rem 0;
  padding: 1rem 1.25rem;
  border: 1px solid var(--page-border);
  border-left: 3px solid var(--page-accent);
  border-radius: 0 var(--page-radius-sm) var(--page-radius-sm) 0;
  background: var(--page-accent-soft);
  font-size: var(--page-text-md);
}

/* 带 .page-prose 前缀是为了压过上面的 .page-prose ul / .page-prose p，
   否则块内最后一段仍会留下 1.25rem 的下边距。 */
.page-note > :last-child,
.page-prose .page-note > :last-child {
  margin-bottom: 0;
}

.page-note__title {
  margin: 0 0 0.4rem;
  color: var(--page-accent-strong);
  font-size: var(--page-text-sm);
  font-weight: 700;
  letter-spacing: 0.04em;
}

/* 有序步骤。编号用计数器生成，不要在 HTML 里手写 1/2/3 的圆圈 div。
   选择器带上 .page-prose 是为了压过上面的 .page-prose ol，否则计数器
   编号会和 ol 自带的 decimal 标记叠成两套号。 */
.page-steps,
.page-prose .page-steps {
  margin: 1.5rem 0;
  padding: 0;
  list-style: none;
  counter-reset: page-step;
}

.page-steps > li {
  position: relative;
  margin-bottom: 1.25rem;
  padding-left: 2.5rem;
  counter-increment: page-step;
}

.page-steps > li::before {
  position: absolute;
  top: 0.1rem;
  left: 0;
  width: 1.75rem;
  height: 1.75rem;
  display: grid;
  place-items: center;
  border-radius: 999px;
  background: var(--page-accent-soft);
  color: var(--page-accent-strong);
  font-size: var(--page-text-sm);
  font-weight: 700;
  font-variant-numeric: tabular-nums;
  content: counter(page-step);
}

.page-steps__title {
  margin: 0 0 0.25rem;
  font-weight: 700;
}

/* 图示/图表容器。图表是内容的一部分，给它标题和说明，不要裸放一个 div。 */
.page-figure {
  margin: 2rem 0;
}

.page-figure > figcaption {
  margin-top: 0.65rem;
  color: var(--page-muted);
  font-size: var(--page-text-sm);
  line-height: 1.6;
}

/* 页内目录。长文才需要，短页不要加。 */
.page-toc {
  margin: 2rem 0;
  padding: 1rem 1.25rem;
  border: 1px solid var(--page-border);
  border-radius: var(--page-radius-sm);
  background: var(--page-surface);
  font-size: var(--page-text-md);
}

.page-toc ol {
  margin: 0;
  padding-left: 1.25rem;
}

.page-toc li {
  margin-bottom: 0.35rem;
}

.page-toc a {
  color: inherit;
  text-decoration: none;
}

.page-toc a:hover {
  color: var(--page-accent-strong);
  text-decoration: underline;
}

.page-toc__title {
  margin: 0 0 0.6rem;
  color: var(--page-muted);
  font-size: var(--page-text-sm);
  font-weight: 700;
  letter-spacing: 0.04em;
}

/* 来源说明。每页必有，位置固定在正文末尾。 */
.page-source {
  margin: 3rem 0 0;
  padding-top: 1.25rem;
  border-top: 1px solid var(--page-border);
  color: var(--page-muted);
  font-size: var(--page-text-sm);
  line-height: 1.7;
}

.page-prose .page-source > :last-child,
.page-prose .page-figure > :last-child,
.page-prose blockquote > :last-child {
  margin-bottom: 0;
}

.page-source__title {
  margin: 0 0 0.4rem;
  color: rgb(var(--c-slate-700));
  font-size: var(--page-text-sm);
  font-weight: 700;
}

/* 把上面四个 __title 的边距从 .page-prose p 手里拿回来。
   属性只重复 margin 一项：颜色、字号、字重没有竞争规则，各自的
   单类名声明已经生效。 */
.page-prose .page-note__title {
  margin: 0 0 0.4rem;
}

.page-prose .page-steps__title {
  margin: 0 0 0.25rem;
}

.page-prose .page-toc__title {
  margin: 0 0 0.6rem;
}

.page-prose .page-source__title {
  margin: 0 0 0.4rem;
}

@media (max-width: 640px) {
  body.page-shell > main.page-prose,
  .page-prose {
    width: min(100% - 1.25rem, var(--page-prose-max));
  }

  .page-prose__wide {
    width: 100%;
    margin-inline: 0;
  }

  .page-prose h2 {
    margin-top: 2.25rem;
  }
}