/* ==========================================================================
   VNPen Project — documentation layout
   ========================================================================== */

.docs-shell{
  display:grid;
  grid-template-columns:232px minmax(0,1fr) 196px;
  gap:48px;
  align-items:start;
  max-width:1280px;margin-inline:auto;
  padding:40px var(--gutter) 96px;
}
.docs-shell.no-toc{grid-template-columns:232px minmax(0,860px);justify-content:center}

/* ---------- sidebar ---------- */
.docs-side{
  position:sticky;top:calc(var(--header-h) + 28px);
  max-height:calc(100dvh - var(--header-h) - 56px);
  overflow-y:auto;
  padding-right:8px;
  scrollbar-width:thin;
}
.docs-side::-webkit-scrollbar{width:6px}
.docs-side::-webkit-scrollbar-thumb{background:var(--line-2);border-radius:3px}

.docs-search{
  display:flex;align-items:center;gap:8px;
  width:100%;margin-bottom:22px;padding:8px 11px;
  border:1px solid var(--line);border-radius:var(--r-sm);
  background:var(--surface);color:var(--fg-mute);font-size:13px;
  transition:border-color var(--fast) var(--ease)}
.docs-search:focus-within{border-color:var(--line-3)}
.docs-search svg{width:14px;height:14px;flex:none}
.docs-search input{
  flex:1;min-width:0;border:0;background:none;outline:none;
  color:var(--fg);font:inherit;font-size:13px;
}
.docs-search input::placeholder{color:var(--fg-mute)}

.docs-nav-group{margin-bottom:24px}
.docs-nav-group h4{
  margin:0 0 8px;padding-left:10px;
  font-size:11.5px;font-weight:500;letter-spacing:.08em;text-transform:uppercase;color:var(--fg-mute);
}
.docs-nav-group ul{list-style:none;margin:0;padding:0;display:grid;gap:1px}
.docs-nav-group a{
  display:block;padding:6px 10px;border-radius:6px;
  font-size:13.5px;color:var(--fg-mute);
  transition:color var(--fast) var(--ease),background var(--fast) var(--ease);
}
.docs-nav-group a:hover{color:var(--fg-dim);background:var(--hover-wash)}
.docs-nav-group a[aria-current="page"]{color:var(--fg);background:var(--accent-wash);font-weight:500}
.docs-nav-group li.hide{display:none}
.docs-nav-empty{padding:6px 10px;font-size:13px;color:var(--fg-mute);display:none}
.docs-nav-empty.show{display:block}

/* ---------- main column ---------- */
.docs-main{min-width:0}
.breadcrumb{
  display:flex;align-items:center;gap:7px;flex-wrap:wrap;
  margin:0 0 14px;font-size:12.5px;color:var(--fg-mute);
}
.breadcrumb a{transition:color var(--fast) var(--ease)}
.breadcrumb a:hover{color:var(--fg-dim)}
.breadcrumb .sep{opacity:.5}
.breadcrumb .cur{color:var(--fg-dim)}

.prose{max-width:none}
.prose h1{
  margin:0 0 10px;font-size:clamp(28px,4vw,38px);font-weight:700;letter-spacing:-.02em;line-height:1.25;
}
.prose .page-lead{
  margin:0 0 36px;font-size:16px;line-height:1.75;color:var(--fg-mute);
  padding-bottom:28px;border-bottom:1px solid var(--line);
}
.prose h2{
  margin:48px 0 14px;font-size:21px;font-weight:700;letter-spacing:-.01em;scroll-margin-top:calc(var(--header-h) + 24px);
}
.prose h3{
  margin:32px 0 10px;font-size:16.5px;font-weight:700;scroll-margin-top:calc(var(--header-h) + 24px);
}
.prose p{margin:0 0 14px;color:var(--fg-dim);line-height:1.85}
.prose ul,.prose ol{margin:0 0 16px;padding-left:22px;color:var(--fg-dim);line-height:1.85}
.prose li{margin-bottom:6px}
.prose li::marker{color:var(--fg-mute)}
.prose strong{color:var(--fg);font-weight:500}
.prose a:not(.btn):not(.card){
  color:var(--accent-soft);text-decoration:underline;text-underline-offset:3px;
  text-decoration-color:color-mix(in srgb,var(--accent-soft) 40%,transparent);
  transition:text-decoration-color var(--fast) var(--ease);
}
.prose a:not(.btn):not(.card):hover{text-decoration-color:var(--accent-soft)}
.prose hr{border:0;border-top:1px solid var(--line);margin:40px 0}

.prose code{
  font-family:ui-monospace,SFMono-Regular,"SF Mono",Menlo,Consolas,monospace;
  font-size:.875em;padding:.15em .4em;border-radius:5px;
  background:var(--surface-2);color:var(--accent-soft);
  border:1px solid var(--line);
}
.prose pre{
  margin:0 0 18px;padding:16px 18px;overflow-x:auto;
  background:var(--surface);border:1px solid var(--line);border-radius:var(--r);
  font-size:13px;line-height:1.7;
}
.prose pre code{background:none;border:0;padding:0;color:var(--fg-dim);font-size:13px}

.prose table{
  width:100%;border-collapse:collapse;margin:0 0 20px;font-size:13.5px;
  border:1px solid var(--line);border-radius:var(--r);overflow:hidden;
}
.prose th,.prose td{padding:10px 14px;text-align:left;border-bottom:1px solid var(--line)}
.prose th{background:var(--surface);font-weight:500;color:var(--fg);font-size:13px}
.prose td{color:var(--fg-dim)}
.prose tr:last-child td{border-bottom:0}

.callout{
  display:flex;gap:12px;margin:0 0 20px;padding:14px 16px;
  border:1px solid var(--line);border-left:2px solid var(--accent);
  border-radius:var(--r);background:var(--accent-wash);
}
.callout svg{width:16px;height:16px;flex:none;margin-top:4px;color:var(--accent-soft)}
.callout p{margin:0;font-size:13.5px;color:var(--fg-dim)}
.callout.warn{border-left-color:#d9a441;background:rgba(217,164,65,.07)}
.callout.warn svg{color:#e0b256}

.doc-cards{display:grid;grid-template-columns:repeat(auto-fit,minmax(220px,1fr));gap:12px;margin:0 0 24px}

.doc-pager{
  display:grid;grid-template-columns:1fr 1fr;gap:12px;
  margin-top:64px;padding-top:28px;border-top:1px solid var(--line);
}
.doc-pager a{
  display:block;padding:14px 18px;border:1px solid var(--line);border-radius:var(--r);
  background:var(--surface);
  transition:border-color var(--fast) var(--ease),transform var(--fast) var(--ease),background var(--fast) var(--ease);
}
.doc-pager a:hover{border-color:var(--line-2);transform:translateY(-1px);background:var(--surface-2)}
.doc-pager span{display:block;font-size:11.5px;letter-spacing:.06em;text-transform:uppercase;color:var(--fg-mute)}
.doc-pager b{display:block;margin-top:3px;font-size:14.5px;font-weight:500;color:var(--fg)}
.doc-pager .next{text-align:right;grid-column:2}

/* ---------- on-page TOC ---------- */
.docs-toc{
  position:sticky;top:calc(var(--header-h) + 28px);
  max-height:calc(100dvh - var(--header-h) - 56px);overflow-y:auto;
}
.docs-toc h4{
  margin:0 0 10px;font-size:11.5px;font-weight:500;letter-spacing:.08em;text-transform:uppercase;color:var(--fg-mute);
}
.docs-toc ul{list-style:none;margin:0;padding:0;display:grid;gap:2px;border-left:1px solid var(--line)}
.docs-toc a{
  display:block;padding:4px 0 4px 12px;margin-left:-1px;
  border-left:1px solid transparent;
  font-size:12.5px;line-height:1.55;color:var(--fg-mute);
  transition:color var(--fast) var(--ease),border-color var(--fast) var(--ease);
}
.docs-toc a:hover{color:var(--fg-dim)}
.docs-toc a.active{color:var(--accent-soft);border-left-color:var(--accent)}
.docs-toc li.lvl3 a{padding-left:24px;font-size:12px}

/* ---------- mobile ---------- */
.docs-side-toggle{
  display:none;align-items:center;gap:8px;
  margin:0 0 20px;padding:9px 14px;width:100%;
  border:1px solid var(--line);border-radius:var(--r-sm);background:var(--surface);
  font-size:13.5px;font-weight:500;color:var(--fg-dim);
}
.docs-side-toggle svg{width:15px;height:15px;transform:rotate(-90deg);transition:transform var(--mid) var(--ease)}
.docs-side-toggle[aria-expanded="true"] svg{transform:none}

@media (max-width:1180px){
  .docs-shell,.docs-shell.no-toc{grid-template-columns:220px minmax(0,1fr);gap:40px;justify-content:initial}
  .docs-toc{display:none}
}
@media (max-width:860px){
  .docs-shell,.docs-shell.no-toc{grid-template-columns:1fr;gap:0;padding-top:26px}
  .docs-side-toggle{display:flex}
  .docs-side{
    position:static;max-height:none;overflow:visible;
    margin-bottom:28px;padding:0 0 24px;border-bottom:1px solid var(--line);
  }
  .docs-side[hidden]{display:none}
  .doc-pager{grid-template-columns:1fr}
  .doc-pager .next{grid-column:1;text-align:left}
}

/* ---------- empty state (文档待补充) ---------- */
.doc-empty{
  display:grid;justify-items:center;text-align:center;
  padding:56px 28px 60px;
  border:1px dashed var(--line-2);border-radius:var(--r-lg);
  background:
    radial-gradient(90% 120% at 50% 0%,var(--accent-wash),transparent 70%),
    var(--surface);
}
.doc-empty-icon{
  display:grid;place-items:center;width:40px;height:40px;margin-bottom:16px;
  border:1px solid var(--line-2);border-radius:12px;color:var(--fg-mute);
  background:var(--surface-2);
}
.doc-empty-icon svg{width:17px;height:17px}
.prose .doc-empty h2{margin:0 0 8px;font-size:17px;font-weight:700;color:var(--fg)}
.prose .doc-empty p{margin:0;max-width:44ch;font-size:13.5px;color:var(--fg-mute)}