/* =========================================================
   GageLog — documentation portal (/docs/)
   Loaded alongside main.css; uses its :root variables.
   ========================================================= */

.docs-layout {
  display: grid;
  grid-template-columns: 220px minmax(0, 1fr);
  gap: 2.5rem;
  max-width: 1080px;
  margin: 0 auto;
  padding: 2rem 1.25rem 4rem;
}

/* ── Sidebar ───────────────────────────────────────────── */

.docs-rail {
  position: sticky;
  top: 1.5rem;
  align-self: start;
  font-size: .875rem;
}

.docs-rail__title {
  font-size: .75rem;
  text-transform: uppercase;
  letter-spacing: .06em;
  color: var(--muted);
  margin-bottom: .6rem;
}

.docs-rail__link {
  display: block;
  padding: .35rem .6rem;
  border-radius: 6px;
  color: var(--text);
}

.docs-rail__link:hover {
  background: var(--teal-wash);
  color: var(--brand-dark);
  text-decoration: none;
}

.docs-rail__link.is-active {
  background: var(--teal-wash);
  color: var(--brand-dark);
  font-weight: 600;
}

/* ── Article body ──────────────────────────────────────── */

.docs-prose {
  max-width: 46rem;
  font-size: .95rem;
}

.docs-prose h1 {
  font-size: 1.7rem;
  margin-bottom: .4rem;
}

.docs-prose .docs-lede {
  color: var(--muted);
  font-size: 1.02rem;
  margin-bottom: 1.6rem;
}

.docs-prose h2 {
  font-size: 1.2rem;
  margin: 2rem 0 .6rem;
  padding-top: 1rem;
  border-top: 1px solid var(--border);
}

.docs-prose h3 {
  font-size: 1rem;
  margin: 1.4rem 0 .4rem;
  color: var(--text);
}

.docs-prose p,
.docs-prose ul,
.docs-prose ol {
  margin-bottom: .9rem;
}

.docs-prose ul,
.docs-prose ol {
  padding-left: 1.4rem;
}

.docs-prose li {
  margin-bottom: .35rem;
}

.docs-prose code {
  font-family: ui-monospace, 'Cascadia Code', Consolas, monospace;
  font-size: .85em;
  background: var(--teal-wash);
  border-radius: 4px;
  padding: .1em .35em;
}

.docs-prose table {
  width: 100%;
  border-collapse: collapse;
  font-size: .875rem;
  margin-bottom: 1rem;
}

.docs-prose th,
.docs-prose td {
  text-align: left;
  padding: .45rem .6rem;
  border-bottom: 1px solid var(--border);
  vertical-align: top;
}

.docs-prose th {
  color: var(--brand-dark);
  font-weight: 600;
}

.docs-table-wrap {
  overflow-x: auto;
}

/* Callout for tips / caveats */
.docs-note {
  border-left: 3px solid var(--teal);
  background: var(--info-bg);
  border-radius: 0 6px 6px 0;
  padding: .7rem .9rem;
  margin-bottom: 1rem;
  font-size: .89rem;
}

/* ── Figures (screenshots) ─────────────────────────────── */

.docs-figure {
  margin: 1.2rem 0 1.4rem;
}

.docs-figure img {
  max-width: 100%;
  height: auto;
  border: 1px solid var(--border);
  border-radius: 8px;
  box-shadow: 0 1px 4px rgba(27, 42, 56, .08);
}

.docs-figure figcaption {
  font-size: .8rem;
  color: var(--muted);
  margin-top: .4rem;
}

/* ── Prev / next footer ────────────────────────────────── */

.docs-pager {
  display: flex;
  justify-content: space-between;
  gap: 1rem;
  margin-top: 3rem;
  padding-top: 1.2rem;
  border-top: 1px solid var(--border);
  font-size: .875rem;
}

.docs-pager__spacer {
  flex: 1;
}

/* ── Index page card grid ──────────────────────────────── */

.docs-index-grid {
  display: grid;
  grid-template-columns: repeat(auto-fill, minmax(240px, 1fr));
  gap: 1rem;
  margin-top: 1.5rem;
}

.docs-index-card {
  display: block;
  background: var(--surface);
  border: 1px solid var(--border);
  border-radius: 8px;
  padding: 1rem 1.1rem;
  color: var(--text);
}

.docs-index-card:hover {
  border-color: var(--teal);
  text-decoration: none;
}

.docs-index-card h3 {
  font-size: .95rem;
  margin-bottom: .3rem;
}

.docs-index-card p {
  font-size: .82rem;
  color: var(--muted);
  margin: 0;
}

/* ── Responsive ────────────────────────────────────────── */

@media (max-width: 860px) {
  .docs-layout {
    grid-template-columns: 1fr;
    gap: 1.25rem;
  }

  .docs-rail {
    position: static;
    display: flex;
    flex-wrap: wrap;
    gap: .25rem;
  }

  .docs-rail__title {
    width: 100%;
  }

  .docs-rail__link {
    border: 1px solid var(--border);
  }
}