/* ============================================================================
 * modcheck 官网 · guide.html 专用样式
 * 只允许出现 .guide- 前缀的类；颜色/间距/圆角/阴影一律走 tokens.css 的 var()。
 * ==========================================================================*/

/* 首屏：契约 §10.6 唯一合法光晕 ---------------------------------------- */
.guide-hero {
  position: relative;
}
.guide-hero::before {
  content: "";
  position: absolute;
  inset: 0;
  pointer-events: none;
  background-color: var(--c-accent);
  opacity: .10;
  -webkit-mask-image: radial-gradient(60% 50% at 50% 0%, black 0%, transparent 70%);
          mask-image: radial-gradient(60% 50% at 50% 0%, black 0%, transparent 70%);
}
.guide-hero__body { position: relative; }

.guide-hero__title {
  margin: 0 0 var(--sp-4);
  font-size: var(--fs-h1);
  font-weight: 640;
  line-height: 1.12;
  letter-spacing: -0.022em;
  color: var(--c-text);
  text-wrap: balance;
}
:lang(zh) .guide-hero__title { letter-spacing: -0.01em; }

.guide-hero__lead {
  max-width: var(--w-text);
  margin: 0;
  font-size: 1.0625rem;      /* 契约 §2：正文强调段 17–18px */
  line-height: 1.75;
  color: var(--c-text);
}

/* 页内锚点平滑滚动（尊重减少动效偏好） -------------------------------- */
@media (prefers-reduced-motion: no-preference) {
  html { scroll-behavior: smooth; }
}

/* 两栏骨架：移动端目录在上，≥900px 目录移到右侧并吸顶 ------------------- */
.guide-layout {
  display: grid;
  grid-template-columns: minmax(0, 1fr);
  gap: var(--sp-8);
}
.guide-main { min-width: 0; }

@media (min-width: 900px) {
  .guide-layout {
    /* 28ch 而不是 22ch：目录项形如「第 3 步 · 命名并保存」约 12–14 个全角字符，
       22ch 会把它们挤成两行（实测「第 1 步 · 找到 mods 文件夹」折行后就出现孤字，
       观感很廉价）。28ch 让绝大多数目录项单行显示，1008px 起自适应加宽。 */
    grid-template-columns: minmax(0, 1fr) clamp(24ch, 26ch, 32ch);
    grid-template-areas: "main toc";
    gap: var(--sp-12);
    align-items: start;
  }
  .guide-main { grid-area: main; }
  .guide-toc {
    grid-area: toc;
    position: sticky;
    top: calc(var(--h-header) + var(--sp-6));
  }
}

/* 目录 ---------------------------------------------------------------- */
.guide-toc {
  padding: var(--sp-5);
  border: 1px solid var(--c-line);
  border-radius: var(--r-md);
  background: var(--c-surface);
}
.guide-toc__title {
  margin: 0 0 var(--sp-3);
  color: var(--c-text-3);
  font-size: var(--fs-xs);
  letter-spacing: 0.08em;
  text-transform: uppercase;
}
.guide-toc__list {
  display: grid;
  gap: var(--sp-1);
  margin: 0;
  padding: 0;
  list-style: none;
}
@media (min-width: 640px) {
  .guide-toc__list { grid-template-columns: repeat(2, minmax(0, 1fr)); }
}
@media (min-width: 900px) {
  .guide-toc__list { grid-template-columns: minmax(0, 1fr); }
}
.guide-toc__link {
  display: block;
  padding: var(--sp-3);
  text-wrap: pretty;   /* 折行时避免孤字 */
  border-left: 2px solid var(--c-line);
  border-radius: 0 var(--r-sm) var(--r-sm) 0;
  color: var(--c-text-2);
  font-size: var(--fs-sm);
  line-height: 1.5;
  text-decoration: none;
  transition: color var(--t-fast), background-color var(--t-fast), border-color var(--t-fast);
}
.guide-toc__link:hover {
  color: var(--c-text);
  background: var(--c-surface-2);
}
.guide-toc__link[aria-current="true"] {
  border-left-color: var(--c-accent);
  background: var(--c-surface-2);
  color: var(--c-text);
  font-weight: 600;
}
.guide-toc__link:focus-visible {
  outline: 2px solid var(--c-focus);
  outline-offset: 2px;
}

/* 步骤 / 区块 --------------------------------------------------------- */
.guide-step,
.guide-block {
  scroll-margin-top: calc(var(--h-header) + var(--sp-6));
}
.guide-step + .guide-step,
.guide-block + .guide-step,
.guide-step + .guide-block,
.guide-block + .guide-block {
  margin-top: var(--sp-16);
}

.guide-step__num {
  display: inline-block;
  margin: 0 0 var(--sp-3);
  padding: var(--sp-1) var(--sp-3);
  border: 1px solid var(--c-accent-line);
  border-radius: var(--r-full);
  background: var(--c-accent-dim);
  color: var(--c-accent-hi);
  font-family: var(--f-mono);
  font-size: var(--fs-xs);
  letter-spacing: 0.04em;
}

.guide-step__title,
.guide-block__title {
  margin: 0 0 var(--sp-4);
  color: var(--c-text);
  font-size: var(--fs-h3);
  font-weight: 640;
  line-height: 1.25;
}
.guide-block__lede {
  max-width: var(--w-text);
  margin: 0 0 var(--sp-6);
  color: var(--c-text-2);
}

/* 「→ 你会看到」叫出预期结果 ------------------------------------------ */
.guide-expect {
  margin: var(--sp-4) 0 0;
  padding: var(--sp-4) var(--sp-5);
  border: 1px solid var(--c-line);
  border-left: 2px solid var(--c-accent);
  border-radius: var(--r-md);
  background: var(--c-surface);
  color: var(--c-text-2);
  font-size: var(--fs-sm);
  line-height: 1.7;
}
.guide-expect__mark {
  margin-right: var(--sp-2);
  color: var(--c-accent-hi);
  font-family: var(--f-mono);
}

/* 排错折叠面板 -------------------------------------------------------- */
.guide-faq {
  display: grid;
  gap: var(--sp-3);
}
.guide-faq__item {
  border: 1px solid var(--c-line);
  border-radius: var(--r-md);
  background: var(--c-surface);
}
.guide-faq__q {
  padding: var(--sp-4) var(--sp-5);
  color: var(--c-text);
  font-size: var(--fs-sm);
  font-weight: 600;
  line-height: 1.5;
  cursor: pointer;
}
.guide-faq__q:focus-visible {
  outline: 2px solid var(--c-focus);
  outline-offset: 2px;
}
.guide-faq__a {
  padding: 0 var(--sp-5) var(--sp-5);
  color: var(--c-text-2);
  font-size: var(--fs-sm);
  line-height: 1.7;
}
.guide-faq__a p { margin: 0 0 var(--sp-3); }
.guide-faq__a p:last-child { margin-bottom: 0; }

/* 行内数字 / 版本号 ---------------------------------------------------- */
.guide-num {
  font-family: var(--f-mono);
  font-variant-numeric: tabular-nums;
  color: var(--c-text);
}

/* 表格 ---------------------------------------------------------------- */
.guide-tablewrap {
  /* 宽度必须被父级约束住：只有 overflow-x:auto 是不够的 ——
     容器会被宽表格撑到内容宽度（实测 375px 视口下到 466px），
     于是把整个文档推宽 1px，页面出现横向滚动。 */
  max-width: 100%;
  min-width: 0;
  overflow-x: auto;
  border: 1px solid var(--c-line);
  border-radius: var(--r-md);
  background: var(--c-surface);
}
.guide-table {
  width: 100%;
  border-collapse: collapse;
  font-size: var(--fs-sm);
}
.guide-table caption {
  padding: var(--sp-4) var(--sp-5) 0;
  text-align: left;
  color: var(--c-text-3);
  font-size: var(--fs-xs);
}
.guide-table th,
.guide-table td {
  padding: var(--sp-3) var(--sp-5);
  text-align: left;
  vertical-align: top;
  border-top: 1px solid var(--c-line-soft);
}
.guide-table thead th {
  border-top: 0;
  border-bottom: 1px solid var(--c-line);
  color: var(--c-text);
  font-weight: 600;
}
.guide-table tbody th {
  color: var(--c-text);
  font-weight: 600;
}
.guide-table tbody td { color: var(--c-text-2); }

/* 六态：圆点形状 + 文字双重表意 —— 组合容器用公共类 .state，本页不重复实现 */

/* 术语表 -------------------------------------------------------------- */
.guide-terms {
  display: grid;
  gap: var(--sp-4);
  margin: 0;
}
.guide-terms__item {
  padding: var(--sp-4) var(--sp-5);
  border: 1px solid var(--c-line);
  border-radius: var(--r-md);
  background: var(--c-surface);
}
.guide-terms__term {
  color: var(--c-text);
  font-weight: 600;
}
.guide-terms__desc {
  margin: var(--sp-1) 0 0;
  color: var(--c-text-2);
  font-size: var(--fs-sm);
  line-height: 1.7;
}

/* 底部跳转 ------------------------------------------------------------ */
.guide-next {
  margin-top: var(--sp-16);
  padding: var(--sp-6);
  border: 1px solid var(--c-line);
  border-radius: var(--r-lg);
  background: var(--c-surface);
}
.guide-next__title {
  margin: 0 0 var(--sp-3);
  color: var(--c-text);
  font-size: var(--fs-h3);
  font-weight: 640;
}
.guide-next__actions {
  display: flex;
  flex-direction: column;
  gap: var(--sp-3);
  margin-top: var(--sp-5);
}
@media (min-width: 640px) {
  .guide-next__actions { flex-direction: row; flex-wrap: wrap; }
}