/* ════════════════════════════════════════════════════════════════════
   DOCUMENTATION DETAIL PAGE
   Wraps existing markdown-converted HTML in <article class="doc-content">
   ════════════════════════════════════════════════════════════════════ */

/* ── 3-col grid: sidebar | content | TOC ── */
.doc-grid {
  display: grid;
  grid-template-columns: 280px 1fr 220px;
  gap: 40px;
  align-items: start;
  margin-top: 24px;
}

@media (max-width: 1200px) {
  .doc-grid { grid-template-columns: 280px 1fr; }
  .doc-toc { display: none; }
}

@media (max-width: 1024px) {
  .doc-grid { grid-template-columns: 1fr; gap: 24px; }
  .docs-sidebar { position: relative; max-height: none; }
}

/* ════════════ DOC HEAD ════════════ */
.doc-page-head {
  padding-bottom: 24px;
  margin-bottom: 32px;
  border-bottom: 1px solid var(--line);
}

.doc-page-meta {
  display: flex;
  align-items: center;
  flex-wrap: wrap;
  gap: 8px;
  margin-bottom: 12px;
  font-family: var(--font-mono);
  font-size: 11px;
  text-transform: uppercase;
  letter-spacing: 0.08em;
  color: var(--ink-3);
}

.doc-page-meta-tag {
  padding: 2px 8px;
  background: var(--bg-elev);
  border: 1px solid var(--line);
  border-radius: 2px;
  color: var(--accent);
}

.doc-page-meta-tag.tag-section {
  color: var(--info);
}

/* ════════════ CONTENT AREA ════════════ */
/* Every selector here targets descendants of .doc-content so existing
   markdown-converted HTML renders correctly without modification. */

.doc-content {
  font-family: var(--font-body);
  font-size: 15px;
  line-height: 1.7;
  color: var(--ink-2);
  max-width: 760px;
  min-width: 0;
}

/* Headings */
.doc-content h1 {
  font-family: var(--font-display);
  font-size: 36px;
  font-weight: 700;
  letter-spacing: -0.025em;
  line-height: 1.15;
  color: var(--ink);
  margin: 0 0 18px;
}

.doc-content h2 {
  font-family: var(--font-display);
  font-size: 24px;
  font-weight: 700;
  letter-spacing: -0.015em;
  line-height: 1.25;
  color: var(--ink);
  margin: 48px 0 14px;
  padding-top: 8px;
  scroll-margin-top: 24px;
  position: relative;
}

.doc-content h2:first-child {
  margin-top: 0;
}

.doc-content h3 {
  font-family: var(--font-display);
  font-size: 19px;
  font-weight: 600;
  letter-spacing: -0.01em;
  line-height: 1.3;
  color: var(--ink);
  margin: 36px 0 12px;
  scroll-margin-top: 24px;
}

.doc-content h4 {
  font-family: var(--font-display);
  font-size: 16px;
  font-weight: 600;
  letter-spacing: -0.005em;
  color: var(--ink);
  margin: 28px 0 10px;
  scroll-margin-top: 24px;
}

.doc-content h5,
.doc-content h6 {
  font-family: var(--font-display);
  font-size: 14px;
  font-weight: 600;
  text-transform: uppercase;
  letter-spacing: 0.06em;
  color: var(--ink-2);
  margin: 24px 0 8px;
}

/* Paragraphs */
.doc-content p {
  margin: 0 0 16px;
  color: var(--ink-2);
}

.doc-content p:last-child {
  margin-bottom: 0;
}

.doc-content strong,
.doc-content b {
  color: var(--ink);
  font-weight: 600;
}

.doc-content em,
.doc-content i {
  font-style: italic;
}

/* Links */
.doc-content a {
  color: var(--accent);
  text-decoration: none;
  border-bottom: 1px solid var(--accent-soft);
  transition: border-color .12s ease, color .12s ease;
}

.doc-content a:hover {
  color: var(--accent-deep);
  border-bottom-color: var(--accent);
}

/* Lists */
.doc-content ul,
.doc-content ol {
  margin: 0 0 18px;
  padding-left: 22px;
  color: var(--ink-2);
}

.doc-content li {
  margin-bottom: 6px;
  line-height: 1.65;
}

.doc-content li > ul,
.doc-content li > ol {
  margin: 6px 0 0;
}

.doc-content ul li::marker {
  color: var(--accent);
}

.doc-content ol li::marker {
  color: var(--accent);
  font-family: var(--font-mono);
  font-weight: 700;
}

/* Code — inline */
.doc-content code {
  font-family: var(--font-mono);
  font-size: 0.88em;
  padding: 2px 6px;
  background: var(--bg-elev-2);
  border: 1px solid var(--line);
  border-radius: 3px;
  color: var(--accent);
}

/* Code — fenced (pre > code) */
.doc-content pre {
  margin: 0 0 18px;
  padding: 16px 18px;
  background: var(--bg-inset);
  border: 1px solid var(--line);
  border-radius: 4px;
  overflow-x: auto;
  font-family: var(--font-mono);
  font-size: 13px;
  line-height: 1.6;

  /* Custom scrollbar matches docs sidebar */
  scrollbar-width: thin;
  scrollbar-color: var(--line-strong) transparent;
}

.doc-content pre::-webkit-scrollbar {
  height: 8px;
}

.doc-content pre::-webkit-scrollbar-track {
  background: transparent;
}

.doc-content pre::-webkit-scrollbar-thumb {
  background-color: var(--line-strong);
  border-radius: 4px;
  border: 2px solid transparent;
  background-clip: padding-box;
}

.doc-content pre code {
  background: transparent;
  border: none;
  padding: 0;
  color: var(--ink);
  font-size: 13px;
}

/* Blockquote */
.doc-content blockquote {
  margin: 18px 0;
  padding: 14px 18px;
  background: var(--accent-soft);
  border-left: 3px solid var(--accent);
  border-radius: 0 4px 4px 0;
  color: var(--ink);
  font-style: normal;
}

.doc-content blockquote p {
  margin: 0;
  color: var(--ink);
}

.doc-content blockquote p + p {
  margin-top: 8px;
}

/* Tables */
.doc-content table {
  width: 100%;
  margin: 18px 0;
  border-collapse: collapse;
  background: var(--bg-elev);
  border: 1px solid var(--line);
  border-radius: 4px;
  overflow: hidden;
  font-size: 13.5px;
}

.doc-content thead {
  background: var(--bg-elev-2);
}

.doc-content th,
.doc-content td {
  padding: 10px 14px;
  text-align: left;
  border-bottom: 1px solid var(--line);
  vertical-align: top;
}

.doc-content th {
  font-family: var(--font-display);
  font-size: 12px;
  font-weight: 700;
  text-transform: uppercase;
  letter-spacing: 0.06em;
  color: var(--ink);
}

.doc-content td {
  color: var(--ink-2);
}

.doc-content tr:last-child td {
  border-bottom: none;
}

.doc-content tr:hover td {
  background: var(--bg-elev-2);
}

/* Wrap tables for horizontal scroll on mobile */
.doc-content .table-wrap,
.doc-content figure.table {
  overflow-x: auto;
  margin: 18px 0;
}

.doc-content .table-wrap table,
.doc-content figure.table table {
  margin: 0;
}

/* Horizontal rule */
.doc-content hr {
  margin: 36px 0;
  border: none;
  height: 1px;
  background: var(--line);
}

/* Images */
.doc-content img {
  max-width: 100%;
  height: auto;
  border-radius: 4px;
  border: 1px solid var(--line);
  margin: 12px 0;
  display: block;
}

.doc-content figure {
  margin: 18px 0;
}

.doc-content figcaption {
  margin-top: 8px;
  font-size: 12.5px;
  color: var(--ink-3);
  text-align: center;
  font-style: italic;
}

/* Keyboard / kbd */
.doc-content kbd {
  font-family: var(--font-mono);
  font-size: 11.5px;
  padding: 2px 6px;
  background: var(--bg-elev-2);
  border: 1px solid var(--line-strong);
  border-bottom-width: 2px;
  border-radius: 3px;
  color: var(--ink);
}

/* Definition lists */
.doc-content dl {
  margin: 18px 0;
}

.doc-content dt {
  font-family: var(--font-display);
  font-weight: 600;
  color: var(--ink);
  margin-top: 14px;
}

.doc-content dd {
  margin: 4px 0 0 18px;
  color: var(--ink-2);
}

/* Note-style callouts if docs use class="note"/"warn"/"tip" */
.doc-content .note,
.doc-content .info {
  margin: 18px 0;
  padding: 14px 18px;
  background: var(--info-soft);
  border-left: 3px solid var(--info);
  border-radius: 0 4px 4px 0;
  color: var(--ink);
}

.doc-content .warn,
.doc-content .warning {
  margin: 18px 0;
  padding: 14px 18px;
  background: var(--warn-soft);
  border-left: 3px solid var(--warn);
  border-radius: 0 4px 4px 0;
  color: var(--ink);
}

.doc-content .tip,
.doc-content .success {
  margin: 18px 0;
  padding: 14px 18px;
  background: var(--accent-soft);
  border-left: 3px solid var(--accent);
  border-radius: 0 4px 4px 0;
  color: var(--ink);
}

.doc-content .danger,
.doc-content .alert {
  margin: 18px 0;
  padding: 14px 18px;
  background: var(--danger-soft);
  border-left: 3px solid var(--danger);
  border-radius: 0 4px 4px 0;
  color: var(--ink);
}

/* ════════════ TOC (RIGHT RAIL) ════════════ */
.doc-toc {
  position: sticky;
  top: 24px;
  max-height: calc(100vh - 48px);
  overflow-y: auto;
  padding-right: 6px;
  scrollbar-width: thin;
  scrollbar-color: var(--line-strong) transparent;
}

.doc-toc::-webkit-scrollbar { width: 6px; }
.doc-toc::-webkit-scrollbar-track { background: transparent; }
.doc-toc::-webkit-scrollbar-thumb {
  background-color: var(--line-strong);
  border-radius: 3px;
}

.doc-toc-head {
  font-family: var(--font-mono);
  font-size: 10.5px;
  font-weight: 700;
  text-transform: uppercase;
  letter-spacing: 0.08em;
  color: var(--ink-4);
  margin-bottom: 12px;
  padding-bottom: 10px;
  border-bottom: 1px solid var(--line);
}

.doc-toc-nav {
  display: flex;
  flex-direction: column;
}

.doc-toc-link {
  padding: 5px 0 5px 12px;
  font-size: 12.5px;
  line-height: 1.4;
  color: var(--ink-3);
  text-decoration: none;
  border-left: 1px solid var(--line);
  transition: all .12s ease;
}

.doc-toc-link:hover {
  color: var(--ink);
  border-left-color: var(--ink-3);
}

.doc-toc-link.active {
  color: var(--accent);
  border-left-color: var(--accent);
  font-weight: 600;
}

.doc-toc-link.toc-h3 {
  padding-left: 22px;
  font-size: 12px;
  color: var(--ink-3);
}

.doc-toc-foot {
  margin-top: 16px;
  padding-top: 12px;
  border-top: 1px solid var(--line);
}

.doc-toc-foot a {
  display: flex;
  align-items: center;
  gap: 6px;
  font-family: var(--font-mono);
  font-size: 11px;
  text-transform: uppercase;
  letter-spacing: 0.06em;
  color: var(--ink-3);
  text-decoration: none;
  padding: 6px 0;
  transition: color .12s ease;
}

.doc-toc-foot a:hover {
  color: var(--accent);
}

/* ════════════ PREV/NEXT NAV ════════════ */
.doc-pager {
  display: grid;
  grid-template-columns: 1fr 1fr;
  gap: 12px;
  margin-top: 48px;
  padding-top: 32px;
  border-top: 1px solid var(--line);
}

@media (max-width: 640px) {
  .doc-pager { grid-template-columns: 1fr; }
}

.doc-pager-link {
  display: block;
  padding: 16px 18px;
  background: var(--bg-elev);
  border: 1px solid var(--line);
  border-radius: 4px;
  text-decoration: none;
  transition: all .15s ease;
}

.doc-pager-link:hover {
  border-color: var(--accent);
  background: var(--bg-elev-2);
}

.doc-pager-link.next {
  text-align: right;
}

.doc-pager-label {
  display: block;
  font-family: var(--font-mono);
  font-size: 10.5px;
  font-weight: 700;
  text-transform: uppercase;
  letter-spacing: 0.08em;
  color: var(--ink-3);
  margin-bottom: 4px;
}

.doc-pager-title {
  display: block;
  font-family: var(--font-display);
  font-size: 14.5px;
  font-weight: 600;
  color: var(--ink);
  letter-spacing: -0.005em;
}

.doc-pager-link:hover .doc-pager-title {
  color: var(--accent);
}

/* ════════════ FOOTER STRIP ════════════ */
.doc-footer-strip {
  display: flex;
  align-items: center;
  justify-content: space-between;
  gap: 16px;
  margin-top: 24px;
  padding: 14px 18px;
  background: var(--bg-elev);
  border: 1px solid var(--line);
  border-radius: 4px;
  font-size: 13px;
  color: var(--ink-3);
}

.doc-footer-strip .ls-meta {
  display: flex;
  align-items: center;
  gap: 12px;
  flex-wrap: wrap;
}

.doc-footer-strip a {
  color: var(--ink-2);
  text-decoration: none;
  transition: color .12s ease;
}

.doc-footer-strip a:hover {
  color: var(--accent);
}