/* ============================================================
   Minerva — documentation layout
   Extends minerva.css (loaded first). Adds the docs shell:
   a sticky left nav, a readable content column, and an
   optional "on this page" rail. Same warm-amber-on-indigo
   palette and type; no new colors.
   ============================================================ */

/* ---- Docs shell: sidebar + content ---- */
.docs {
  max-width: 1280px;
  margin: 0 auto;
  padding: 0 24px;
  display: grid;
  grid-template-columns: 248px minmax(0, 1fr);
  gap: 48px;
  align-items: start;
}
@media (max-width: 900px) {
  .docs { grid-template-columns: 1fr; gap: 0; }
}

/* ---- Left navigation ---- */
.docs-nav {
  position: sticky;
  top: 60px; /* height of the site nav bar */
  align-self: start;
  max-height: calc(100vh - 60px);
  overflow-y: auto;
  padding: 32px 0 48px;
}
@media (max-width: 900px) {
  .docs-nav {
    position: static;
    max-height: none;
    border-bottom: 1px solid var(--border);
    padding-bottom: 20px;
  }
}
.docs-nav h4 {
  color: var(--text-faint);
  font-size: 0.72rem;
  letter-spacing: 0.12em;
  text-transform: uppercase;
  margin: 22px 0 8px;
  padding-left: 12px;
}
.docs-nav h4:first-child { margin-top: 0; }
.docs-nav a {
  display: block;
  color: var(--text-muted);
  font-size: 0.92rem;
  padding: 5px 12px;
  border-radius: 7px;
  border-left: 2px solid transparent;
}
.docs-nav a:hover { color: var(--text); background: var(--bg-elev); text-decoration: none; }
.docs-nav a.active {
  color: var(--accent);
  background: var(--bg-elev);
  border-left-color: var(--accent);
  font-weight: 600;
}
/* nested (sub-page) links, e.g. embedding types under Notes */
.docs-nav a.sub { padding-left: 26px; font-size: 0.88rem; }

/* ---- Content column ---- */
.docs-content { padding: 34px 0 80px; min-width: 0; }
.docs-content h1 {
  font-size: clamp(1.9rem, 3.6vw, 2.6rem);
  letter-spacing: -0.018em;
  margin: 0 0 12px;
}
.docs-content > .lede { font-size: 1.18rem; margin: 0 0 32px; }
.docs-content h2 {
  font-size: 1.5rem;
  margin: 44px 0 14px;
  padding-top: 12px;
  letter-spacing: -0.01em;
  scroll-margin-top: 76px;
}
.docs-content h3 { font-size: 1.14rem; margin: 28px 0 8px; scroll-margin-top: 76px; }
.docs-content p { color: var(--text-muted); margin: 0 0 16px; }
.docs-content p b, .docs-content li b { color: var(--text); }
.docs-content ul, .docs-content ol { color: var(--text-muted); padding-left: 22px; margin: 0 0 16px; }
.docs-content li { margin: 5px 0; }
.docs-content a { color: var(--accent); }
.docs-content img { max-width: 100%; border-radius: 10px; border: 1px solid var(--border); }

/* ---- Breadcrumb ---- */
.crumbs { font-size: 0.85rem; color: var(--text-faint); margin: 0 0 18px; }
.crumbs a { color: var(--text-muted); }
.crumbs .sep { margin: 0 8px; opacity: 0.6; }

/* ---- Inline code + code blocks ---- */
.docs-content code {
  background: var(--bg-inset);
  border: 1px solid var(--border);
  border-radius: 5px;
  padding: 1px 6px;
  font-size: 0.88em;
  color: var(--text);
  font-family: ui-monospace, "SF Mono", Menlo, Consolas, monospace;
}
.docs-content pre {
  background: var(--bg-inset);
  border: 1px solid var(--border);
  border-radius: 10px;
  padding: 16px 18px;
  overflow-x: auto;
  margin: 0 0 20px;
  font-size: 0.86rem;
  line-height: 1.55;
}
.docs-content pre code { background: none; border: none; padding: 0; color: var(--text); }

/* ---- Keyboard shortcut chips ---- */
kbd {
  display: inline-block;
  background: var(--bg-elev-2);
  border: 1px solid var(--border-strong);
  border-bottom-width: 2px;
  border-radius: 6px;
  padding: 1px 7px;
  font-size: 0.8em;
  font-family: ui-monospace, "SF Mono", Menlo, Consolas, monospace;
  color: var(--text);
  white-space: nowrap;
}

/* ---- Note / tip / callout boxes ---- */
.box {
  background: var(--bg-elev);
  border: 1px solid var(--border);
  border-left: 3px solid var(--accent);
  border-radius: 10px;
  padding: 16px 20px;
  margin: 0 0 20px;
}
.box p { margin: 0; color: var(--text); font-size: 0.95rem; }
.box .label {
  display: block;
  color: var(--accent-dim);
  font-size: 0.72rem;
  letter-spacing: 0.1em;
  text-transform: uppercase;
  font-weight: 700;
  margin-bottom: 6px;
}

/* ---- Definition rows (syntax / feature tables) ---- */
.deflist { display: grid; gap: 0; margin: 0 0 24px; border: 1px solid var(--border); border-radius: 12px; overflow: hidden; }
.deflist .row { display: grid; grid-template-columns: 200px 1fr; gap: 20px; padding: 14px 18px; border-top: 1px solid var(--border); }
.deflist .row:first-child { border-top: none; }
.deflist .row .k { color: var(--text); font-weight: 600; font-size: 0.92rem; }
.deflist .row .k code { font-size: 0.86em; }
.deflist .row .v { color: var(--text-muted); font-size: 0.92rem; }
@media (max-width: 620px) { .deflist .row { grid-template-columns: 1fr; gap: 4px; } }

/* ---- Card grid for landing / index of sections ---- */
.doc-cards { display: grid; grid-template-columns: repeat(2, 1fr); gap: 18px; margin: 28px 0; }
@media (max-width: 720px) { .doc-cards { grid-template-columns: 1fr; } }
.doc-card {
  display: block;
  background: var(--bg-elev);
  border: 1px solid var(--border);
  border-radius: 14px;
  padding: 20px 22px;
  color: var(--text);
}
.doc-card:hover { border-color: var(--border-strong); background: var(--bg-elev-2); text-decoration: none; }
.doc-card .em { font-size: 1.4rem; display: block; margin-bottom: 8px; }
.doc-card h3 { margin: 0 0 5px; font-size: 1.05rem; color: var(--text); }
.doc-card p { margin: 0; color: var(--text-muted); font-size: 0.9rem; }

/* ---- Screenshot placeholders reuse .shot from minerva.css ---- */

/* Real captured screenshots: a framed image with a caption below. */
figure.shot-img { margin: 18px 0; text-align: center; }
figure.shot-img img {
  display: inline-block; max-width: 100%; height: auto;
  border: 1px solid var(--border-strong); border-radius: 12px; background: var(--bg-inset);
}
/* Narrow UI crops (sidebars, panels, context menus) are captured at 2× and are
   tall-and-thin — never stretch them to the column width. Show near natural size,
   centered. */
figure.shot-img.panel img { width: 260px; }
figure.shot-img figcaption {
  margin-top: 8px; font-size: 0.86rem; color: var(--text-muted); text-align: center;
}

/* ---- Prev / next pager ---- */
.pager { display: flex; justify-content: space-between; gap: 16px; margin-top: 56px; padding-top: 24px; border-top: 1px solid var(--border); }
.pager a { display: flex; flex-direction: column; gap: 2px; color: var(--text); max-width: 48%; }
.pager a:hover { text-decoration: none; color: var(--accent); }
.pager a.next { text-align: right; margin-left: auto; }
.pager .dir { font-size: 0.75rem; letter-spacing: 0.08em; text-transform: uppercase; color: var(--text-faint); }
.pager .ttl { font-size: 0.98rem; font-weight: 600; }