/* ─────────────────────────────────────────────
   docs.css — TerraCore documentation styles
   Requires: /css/main.css (shared design tokens, reset, typography,
   badges, callouts, tables, code blocks, tok-* syntax colours)
   ───────────────────────────────────────────── */

/* ── Scroll fade-in ──────────────────────────── */
.fade-in { opacity: 0; transform: translateY(16px); transition: opacity .55s ease-out, transform .55s ease-out; }
.fade-in.visible { opacity: 1; transform: none; }

/* ── Two-column docs layout ──────────────────── */
.docs-layout {
  display: grid;
  grid-template-columns: 220px 1fr;
  gap: 40px;
  max-width: 1100px;
  margin: 0 auto;
  padding: calc(var(--nav-height) + 40px) 40px 100px;
}

/* ── Sidebar ─────────────────────────────────── */
.docs-sidebar {
  position: sticky;
  top: calc(var(--nav-height) + 20px);
  height: fit-content;
  /* max-height prevents overflow on very long sidebars */
  max-height: calc(100vh - var(--nav-height) - 40px);
  overflow-y: auto;
}

.docs-sidebar-title {
  font-family: var(--mono);
  font-size: 0.62rem;
  letter-spacing: 0.12em;
  text-transform: uppercase;
  color: var(--text-faint);
  margin-bottom: 6px;
  margin-top: 20px;
}
.docs-sidebar-title:first-child { margin-top: 0; }

.docs-sidebar a {
  display: block;
  padding: 5px 0 5px 10px;
  font-size: 0.85rem;
  color: var(--text-dim);
  text-decoration: none;
  border-left: 2px solid transparent;
  margin-left: -10px;
  transition: color 0.15s, border-color 0.15s;
}
.docs-sidebar a:hover { color: var(--text); text-decoration: none; }
.docs-sidebar a.active { color: var(--accent); border-left-color: var(--accent); }

/* Indented sub-links (field reference subsections) */
.docs-sidebar a.nav-sub {
  padding-left: 24px;
  font-size: 0.78rem;
  opacity: 0.85;
}

/* Method pill inside sidebar links */
.docs-sidebar a .method-pill {
  font-family: var(--mono);
  font-size: 0.6rem;
  font-weight: 500;
  letter-spacing: 0.04em;
  background: rgba(79, 142, 247, 0.15);
  color: var(--accent);
  border-radius: 3px;
  padding: 1px 5px;
  margin-left: 5px;
  vertical-align: middle;
}

/* ── Docs sections ───────────────────────────── */
.docs-section {
  margin-bottom: 72px;
  /* Ensure sticky nav doesn't obscure jump targets */
  scroll-margin-top: calc(var(--nav-height) + 24px);
}

.docs-section h2 {
  margin-bottom: 16px;
  padding-bottom: 12px;
  border-bottom: 1px solid var(--border);
}

.docs-section h3 {
  font-size: 1.05rem;
  margin: 28px 0 10px;
}

/* ── Hero block (top of page) ────────────────── */
.docs-hero {
  background: var(--bg3);
  border: 1px solid var(--border);
  border-radius: 14px;
  padding: 40px 44px 48px;
  margin-bottom: 20px;
}

.docs-hero .eyebrow {
  font-family: var(--mono);
  font-size: 0.68rem;
  letter-spacing: 0.15em;
  text-transform: uppercase;
  color: var(--accent);
  margin-bottom: 16px;
  display: flex;
  align-items: center;
  gap: 10px;
}
.docs-hero .eyebrow::before {
  content: '';
  display: inline-block;
  width: 24px;
  height: 1px;
  background: var(--accent);
  flex-shrink: 0;
}

.docs-hero h1 {
  font-size: clamp(2rem, 4vw, 3rem);
  font-weight: 700;
  color: #fff;
  letter-spacing: -0.03em;
  line-height: 1.1;
  margin-bottom: 16px;
}
.docs-hero h1 em {
  font-style: normal;
  color: var(--text-dim);
  font-weight: 500;
}

.docs-hero .lead {
  font-size: 0.975rem;
  color: var(--text-dim);
  max-width: 560px;
  line-height: 1.75;
  margin-bottom: 28px;
}

.hero-meta {
  display: flex;
  gap: 28px;
  flex-wrap: wrap;
}
.hero-meta-item {
  display: flex;
  flex-direction: column;
  gap: 4px;
}
.hero-meta-item .label {
  font-family: var(--mono);
  font-size: 0.62rem;
  letter-spacing: 0.1em;
  text-transform: uppercase;
  color: var(--text-faint);
}
.hero-meta-item .value {
  font-family: var(--mono);
  font-size: 0.8rem;
  color: var(--text);
}

/* ── Code label (above standalone pre blocks) ── */
.code-label {
  font-family: var(--mono);
  font-size: 0.62rem;
  letter-spacing: 0.1em;
  text-transform: uppercase;
  color: var(--text-faint);
  margin-bottom: 6px;
  margin-top: 20px;
}

/* ── Field group grid ────────────────────────── */
.group-grid {
  display: grid;
  grid-template-columns: 1fr 1fr;
  gap: 12px;
  margin: 16px 0;
}

/* Full-width category dividers inside group-grid */
.group-grid .group-category-label {
  grid-column: 1 / -1;
  padding: 10px 0 4px;
  margin-top: 8px;
  border-top: 1px solid var(--border2);
  font-family: var(--mono);
  font-size: 0.8rem;
  letter-spacing: 0.12em;
  text-transform: uppercase;
  color: var(--text-faint);
}
.group-grid .group-category-label:first-child { border-top: none; margin-top: 4px; }

.group-card {
  background: var(--bg3);
  border: 1px solid var(--border);
  border-radius: var(--radius);
  padding: 16px 18px;
}
.group-card-header {
  display: flex;
  align-items: center;
  justify-content: space-between;
  margin-bottom: 8px;
}
.group-name {
  font-family: var(--mono);
  font-size: 0.82rem;
  color: #fff;
}
.group-fields {
  font-size: 0.76rem;
  color: var(--text-faint);
  line-height: 1.7;
}
.group-note {
  font-size: 0.7rem;
  color: var(--amber);
  margin-top: 6px;
}

/* ── Endpoint card ───────────────────────────── */
.endpoint-card {
  background: var(--bg2);
  border: 1px solid var(--border);
  border-radius: var(--radius-lg);
  overflow: hidden;
  margin-bottom: 40px;
  box-shadow: 0 6px 18px rgba(0, 0, 0, 0.25);
}

.endpoint-header {
  display: flex;
  align-items: center;
  gap: 14px;
  padding: 16px 22px;
  border-bottom: 1px solid var(--border);
  background: var(--bg3);
}

/* method-badge: similar to code-method in main.css but kept separate
   because endpoint-card uses its own background/padding sizing */
.method-badge {
  font-family: var(--mono);
  font-size: 0.68rem;
  font-weight: 500;
  letter-spacing: 0.05em;
  padding: 4px 10px;
  border-radius: 4px;
  background: rgba(79, 142, 247, 0.15);
  color: var(--accent);
  border: 1px solid rgba(79, 142, 247, 0.3);
  flex-shrink: 0;
}

.endpoint-path {
  font-family: var(--mono);
  font-size: 0.875rem;
  color: #fff;
  letter-spacing: 0.01em;
}
.endpoint-path .base { color: var(--text-faint); }

.endpoint-desc {
  padding: 16px 22px;
  font-size: 0.875rem;
  color: var(--text-dim);
  border-bottom: 1px solid var(--border);
  line-height: 1.7;
}

.endpoint-body { padding: 0 22px 22px; }

/* ── Response schema rows ────────────────────── */
.response-schema {
  background: var(--bg2);
  border: 1px solid var(--border);
  border-radius: var(--radius);
  overflow: hidden;
  margin: 16px 0;
}

.rs-row {
  display: grid;
  grid-template-columns: 220px 110px 1fr;
  gap: 0;
  border-bottom: 1px solid var(--border);
  padding: 10px 18px;
  align-items: start;
  font-size: 0.875rem;
}
.rs-row:last-child { border-bottom: none; }
.rs-row:hover { background: rgba(255, 255, 255, 0.02); }

.rs-key { font-family: var(--mono); font-size: 0.8rem; color: #7ec8e3; }
.rs-key.indent  { padding-left: 18px; color: #a8d8a8; }
.rs-key.indent2 { padding-left: 36px; color: var(--text-dim); }
.rs-type { font-family: var(--mono); font-size: 0.68rem; color: var(--text-faint); padding-top: 2px; }
.rs-desc { font-size: 0.82rem; color: var(--text-dim); line-height: 1.6; }

/* ── Tabs (code examples) ────────────────────── */
.tabs { margin: 20px 0 0; }

.tab-list {
  display: flex;
  gap: 2px;
  border-bottom: 1px solid var(--border);
}

.tab-btn {
  font-family: var(--mono);
  font-size: 0.68rem;
  letter-spacing: 0.05em;
  padding: 8px 16px;
  background: none;
  border: none;
  color: var(--text-faint);
  cursor: pointer;
  border-bottom: 2px solid transparent;
  margin-bottom: -1px;
  transition: color 0.15s;
}
.tab-btn:hover { color: var(--text); }
.tab-btn.active { color: var(--accent); border-bottom-color: var(--accent); }

.tab-panel { display: none; }
.tab-panel.active { display: block; }
/* Seamless join between tab list and code block */
.tab-panel pre {
  border-top: none;
  border-radius: 0 0 var(--radius) var(--radius);
  margin-top: 0;
}

/* ── Field section headers (Reference page) ─── */
.field-section-header {
  font-family: var(--mono);
  font-size: 0.8rem;
  font-weight: 500;
  letter-spacing: 0.12em;
  text-transform: uppercase;
  color: var(--accent);
  padding-bottom: 8px;
  border-bottom: 1px solid var(--border2);
  margin-top: 48px;
  margin-bottom: 24px;
}

/* ── Table utility classes (docs-specific) ───── */
/* .table-wrap, table, thead th, tbody td already in main.css.
   The following are additional overrides for docs tables only. */
.td-dim { color: var(--text-dim); }
.td-req { color: var(--red);        font-family: var(--mono); font-size: 0.68rem; }
.td-opt { color: var(--text-faint); font-family: var(--mono); font-size: 0.68rem; }
td code  { font-size: 0.75rem; }

/* Error table: red code cells */
.error-row td:first-child code { color: var(--red); }

/* ── Extra syntax token colours ──────────────── */
/* tok-key, tok-str, tok-num, tok-cmnt, tok-url already in main.css */
.tok-bool { color: var(--purple); }
.tok-null { color: var(--text-dim); }
.tok-meth { color: var(--amber); font-weight: 500; }
.tok-hdr  { color: var(--text-dim); }

/* ── Tier badges (display none while hidden) ─── */
/* Badge styling is in main.css; tier class is a
   docs-specific override to hide tier labels */
.tier { display: none !important; }

/* ── Responsive ──────────────────────────────── */
@media (max-width: 960px) {
  .docs-layout { grid-template-columns: 1fr; padding-left: 24px; padding-right: 24px; }
  .docs-sidebar { display: none; }
  .group-grid { grid-template-columns: 1fr; }
  .rs-row { grid-template-columns: 160px 80px 1fr; }
}

@media (max-width: 640px) {
  .docs-layout { padding-left: 16px; padding-right: 16px; }
  .docs-hero { padding: 28px 24px 32px; }
  .rs-row { grid-template-columns: 1fr; gap: 4px; }
  .rs-type { padding-top: 0; }
}