/* ============================================================
   tw-lvr-cli — Docs layout (extends styles.css)
   ============================================================ */

.docs-shell { max-width: var(--maxw); margin: 0 auto; padding: 0 var(--pad); }

/* ---------- docs hero ---------- */
.docs-hero { padding: 54px 0 34px; }
.docs-hero h1 {
  font-family: var(--serif);
  font-weight: 460;
  font-size: clamp(34px, 4.6vw, 50px);
  line-height: 1.06;
  letter-spacing: -0.02em;
  margin: 16px 0 0;
}
.docs-hero h1 .mono-tok {
  font-family: var(--mono);
  font-size: 0.62em;
  font-weight: 500;
  color: var(--cinnabar);
  letter-spacing: 0.02em;
  vertical-align: 0.06em;
}
.docs-hero p {
  margin-top: 16px;
  max-width: 60ch;
  color: var(--ink-soft);
  font-size: 17px;
}

/* ---------- two-column layout ---------- */
.docs-layout {
  display: grid;
  grid-template-columns: 236px minmax(0, 1fr);
  gap: 58px;
  align-items: start;
  border-top: 1px solid var(--rule);
  padding-top: 8px;
}

/* ---------- sidebar TOC ---------- */
.docs-toc {
  position: sticky;
  top: 88px;
  align-self: start;
  padding: 28px 0 40px;
  max-height: calc(100vh - 100px);
  overflow-y: auto;
}
.docs-toc .toc-label {
  font-family: var(--mono);
  font-size: 11px;
  letter-spacing: 0.16em;
  text-transform: uppercase;
  color: var(--ink-faint);
  padding: 0 0 14px 14px;
}
.toc-list { list-style: none; display: flex; flex-direction: column; }
.toc-link {
  display: flex;
  align-items: baseline;
  gap: 10px;
  padding: 7px 0 7px 14px;
  border-left: 2px solid var(--rule-soft);
  font-size: 14px;
  color: var(--ink-mute);
  transition: color 0.16s, border-color 0.16s;
}
.toc-link .toc-no {
  font-family: var(--mono);
  font-size: 11.5px;
  color: var(--ink-faint);
  transition: color 0.16s;
}
.toc-link:hover { color: var(--ink); }
.toc-link.active {
  color: var(--cinnabar);
  border-left-color: var(--cinnabar);
}
.toc-link.active .toc-no { color: var(--cinnabar); }

/* ---------- mobile TOC dropdown ---------- */
.docs-toc-mobile { display: none; }

/* ---------- content ---------- */
.docs-main { padding: 8px 0 40px; min-width: 0; }
.doc-section { padding: 40px 0 44px; border-top: 1px solid var(--rule-soft); scroll-margin-top: 84px; }
.doc-section:first-child { border-top: 0; padding-top: 24px; }
.doc-kicker {
  font-family: var(--mono);
  font-size: 11.5px;
  letter-spacing: 0.16em;
  text-transform: uppercase;
  color: var(--ink-mute);
}
.doc-section h2 {
  font-family: var(--serif);
  font-weight: 470;
  font-size: clamp(25px, 3vw, 32px);
  line-height: 1.16;
  letter-spacing: -0.01em;
  margin: 12px 0 0;
}
.doc-section h2 .en-sub, .doc-section h2 .zh-sub {
  color: var(--ink-faint);
  font-style: italic;
  font-weight: 400;
}
.doc-p { margin-top: 16px; color: var(--ink-soft); font-size: 16px; line-height: 1.62; max-width: 66ch; }
.doc-p + .doc-p { margin-top: 12px; }
.doc-p b { color: var(--ink); font-weight: 600; }
.doc-sub-h {
  font-family: var(--mono);
  font-size: 12.5px;
  letter-spacing: 0.06em;
  text-transform: uppercase;
  color: var(--ink-mute);
  margin: 26px 0 12px;
}

/* code blocks reuse .code-block from styles.css; add top spacing */
.docs-main .code-block { margin-top: 16px; }
.docs-main .code-block + .code-block { margin-top: 14px; }

/* ---------- note / callout (ledger style, no rounded accent box) ---------- */
.doc-note {
  margin-top: 20px;
  padding: 14px 0 2px;
  border-top: 1px solid var(--rule);
  display: grid;
  grid-template-columns: auto 1fr;
  gap: 14px;
  max-width: 70ch;
}
.doc-note .note-tag {
  font-family: var(--mono);
  font-size: 11px;
  letter-spacing: 0.12em;
  text-transform: uppercase;
  color: var(--cinnabar);
  padding-top: 2px;
  white-space: nowrap;
}
.doc-note p { font-size: 14.5px; color: var(--ink-soft); line-height: 1.55; }
.doc-note p b { color: var(--ink); font-weight: 600; }

/* ---------- architecture steps ---------- */
.arch-steps { margin-top: 24px; display: flex; flex-direction: column; }
.arch-step {
  display: grid;
  grid-template-columns: 132px 1fr;
  gap: 22px;
  align-items: baseline;
  padding: 18px 0;
  border-bottom: 1px solid var(--rule-soft);
}
.arch-step:last-child { border-bottom: 0; }
.arch-step .step-name {
  font-family: var(--mono);
  font-size: 14px;
  color: var(--cinnabar);
  letter-spacing: 0.02em;
  display: flex;
  align-items: baseline;
  gap: 9px;
}
.arch-step .step-no { color: var(--ink-faint); font-size: 12px; }
.arch-step .step-desc { color: var(--ink-soft); font-size: 15px; line-height: 1.5; }
.arch-step .step-desc .opt { font-family: var(--mono); font-size: 12.5px; color: var(--ink-faint); }

/* ---------- docs tables (reuse table.cmp baseline, mono cells) ---------- */
.doc-table-scroll { margin-top: 20px; overflow-x: auto; border: 1px solid var(--rule); border-radius: 12px; }
table.doc-tbl { width: 100%; border-collapse: collapse; min-width: 540px; background: var(--paper); }
table.doc-tbl thead th {
  text-align: left;
  font-family: var(--mono);
  font-size: 11.5px;
  letter-spacing: 0.08em;
  text-transform: uppercase;
  color: var(--ink-mute);
  padding: 14px 20px;
  border-bottom: 1px solid var(--rule);
  font-weight: 500;
}
table.doc-tbl tbody td {
  padding: 13px 20px;
  border-bottom: 1px solid var(--rule-soft);
  font-size: 14.5px;
  vertical-align: top;
  color: var(--ink-soft);
}
table.doc-tbl tbody tr:last-child td { border-bottom: 0; }
table.doc-tbl td.mono, table.doc-tbl td .mono {
  font-family: var(--mono);
  color: var(--ink);
  font-variant-numeric: tabular-nums;
}
table.doc-tbl td.code-cell {
  font-family: var(--mono);
  color: var(--cinnabar-dk);
  white-space: nowrap;
}
table.doc-tbl td.zh-cell { color: var(--ink); }
.exit-num {
  font-family: var(--mono);
  font-weight: 600;
  color: var(--cinnabar);
  font-variant-numeric: tabular-nums;
}

/* inline links inside docs prose */
.doc-link { color: var(--cinnabar); border-bottom: 1px solid var(--cinnabar-tint); transition: border-color 0.16s; }
.doc-link:hover { border-bottom-color: var(--cinnabar); }
.doc-p code, .doc-note code { white-space: normal; }

/* ---------- responsive ---------- */
@media (max-width: 920px) {
  .docs-layout { grid-template-columns: 200px minmax(0,1fr); gap: 40px; }
}
@media (max-width: 720px) {
  .docs-layout { grid-template-columns: 1fr; gap: 0; border-top: 0; }
  .docs-toc { display: none; }
  .docs-toc-mobile {
    display: block;
    position: sticky;
    top: 66px;
    z-index: 30;
    margin: 0 calc(-1 * var(--pad));
    padding: 12px var(--pad);
    background: color-mix(in srgb, var(--paper) 92%, transparent);
    backdrop-filter: blur(10px);
    border-top: 1px solid var(--rule);
    border-bottom: 1px solid var(--rule);
  }
  .docs-toc-mobile .m-label {
    font-family: var(--mono);
    font-size: 10.5px;
    letter-spacing: 0.14em;
    text-transform: uppercase;
    color: var(--ink-faint);
    display: block;
    margin-bottom: 6px;
  }
  .docs-toc-mobile select {
    width: 100%;
    font-family: var(--sans);
    font-size: 15px;
    color: var(--ink);
    background: var(--paper);
    border: 1px solid var(--rule);
    border-radius: 9px;
    padding: 11px 14px;
    -webkit-appearance: none;
    appearance: none;
    background-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='16' height='16' viewBox='0 0 24 24' fill='none'%3E%3Cpath d='M6 9l6 6 6-6' stroke='%23BC3B26' stroke-width='2' stroke-linecap='round' stroke-linejoin='round'/%3E%3C/svg%3E");
    background-repeat: no-repeat;
    background-position: right 14px center;
  }
  .docs-hero { padding: 38px 0 24px; }
  .doc-section { padding: 34px 0 36px; }
  .arch-step { grid-template-columns: 1fr; gap: 6px; }
}