/* Inferior docs — per-surface reference pages.
   Additive to main.css; inherits tokens (--bg, --text, --accent, --serif, etc.). */

:root {
  --docs-rail-width: 260px;
  --docs-max: 1120px;
  --code-bg: #f6f8fa;
  --code-bg-dark: #0d1117;
  --code-fg-dark: #e6edf3;
  --red: #cf222e;
  --amber: #9a6700;
  --dim: #6b6b6b;
}

body.docs-body {
  font-family: var(--sans);
  font-size: 15px;
  line-height: 1.6;
  color: var(--text);
}

/* Layout — left rail + content */
.docs-shell {
  max-width: var(--docs-max);
  margin: 0 auto;
  padding: 24px;
  display: grid;
  grid-template-columns: var(--docs-rail-width) minmax(0, 1fr);
  gap: 40px;
}

@media (max-width: 900px) {
  .docs-shell { grid-template-columns: 1fr; }
  .docs-rail { position: static; max-height: none; overflow: visible; }
}

.docs-rail {
  position: sticky;
  top: 24px;
  align-self: start;
  max-height: calc(100vh - 48px);
  overflow-y: auto;
  padding-right: 12px;
  border-right: 1px solid var(--border);
  font-size: 14px;
}

.docs-rail .rail-group {
  margin-bottom: 20px;
}
.docs-rail .rail-group-title {
  font-family: var(--mono);
  font-size: 11px;
  text-transform: uppercase;
  letter-spacing: 0.08em;
  color: var(--dim);
  margin-bottom: 8px;
}
.docs-rail a {
  display: block;
  padding: 4px 10px;
  color: var(--text);
  text-decoration: none;
  border-radius: 4px;
  margin-bottom: 2px;
}
.docs-rail a:hover { background: #f0f0f0; color: var(--accent); }
.docs-rail a.active { background: var(--accent-bg); color: var(--accent); font-weight: 600; }

/* Content */
.docs-content {
  min-width: 0;
}
.docs-content h1 {
  font-family: var(--sans);
  font-size: 32px;
  font-weight: 700;
  color: var(--heading);
  margin-bottom: 8px;
  letter-spacing: -0.02em;
}
.docs-content h1 .pill {
  display: inline-block;
  vertical-align: middle;
  margin-left: 10px;
  padding: 3px 9px;
  font-size: 11px;
  font-family: var(--mono);
  font-weight: 500;
  background: var(--accent-bg);
  color: var(--accent);
  border-radius: 10px;
  letter-spacing: 0.04em;
}
.docs-content h1 .pill.pending {
  background: #fff6e3;
  color: var(--amber);
}
.docs-content .docs-lead {
  font-family: var(--serif);
  font-size: 19px;
  line-height: 1.55;
  color: var(--text-muted);
  margin-bottom: 32px;
  max-width: 680px;
}

.docs-content h2 {
  font-size: 22px;
  font-weight: 700;
  color: var(--heading);
  margin: 40px 0 14px;
  padding-bottom: 6px;
  border-bottom: 1px solid var(--border);
  letter-spacing: -0.01em;
}
.docs-content h3 {
  font-size: 16px;
  font-weight: 700;
  color: var(--heading);
  margin: 24px 0 10px;
  font-family: var(--mono);
}

.docs-content p, .docs-content li {
  margin-bottom: 12px;
}

.docs-content code {
  font-family: var(--mono);
  font-size: 13px;
  background: var(--code-bg);
  padding: 1px 6px;
  border-radius: 3px;
  color: var(--code-text);
}
.docs-content pre {
  background: var(--code-bg-dark);
  color: var(--code-fg-dark);
  font-family: var(--mono);
  font-size: 13px;
  line-height: 1.55;
  padding: 16px 20px;
  border-radius: 8px;
  overflow-x: auto;
  margin: 8px 0 20px;
}
.docs-content pre code {
  background: transparent;
  color: inherit;
  padding: 0;
  font-size: inherit;
}

.docs-content table {
  border-collapse: collapse;
  width: 100%;
  font-size: 14px;
  margin-bottom: 20px;
}
.docs-content th, .docs-content td {
  border: 1px solid var(--border);
  padding: 8px 12px;
  text-align: left;
  vertical-align: top;
}
.docs-content th {
  background: #fafafa;
  font-weight: 600;
  font-family: var(--sans);
}
.docs-content td code {
  font-size: 12px;
  white-space: nowrap;
}

.method-sig {
  font-family: var(--mono);
  font-size: 13px;
  background: var(--code-bg);
  padding: 6px 12px;
  border-radius: 4px;
  border-left: 3px solid var(--accent);
  display: inline-block;
  color: var(--code-text);
}

.callout {
  background: var(--accent-bg);
  border-left: 3px solid var(--accent);
  padding: 14px 18px;
  border-radius: 0 6px 6px 0;
  margin: 16px 0;
  font-size: 14px;
}
.callout.warn {
  background: #fff6e3;
  border-left-color: var(--amber);
}
.callout.error {
  background: #ffeef0;
  border-left-color: var(--red);
}

/* Landing grid (index.html) */
.docs-hero {
  max-width: var(--docs-max);
  margin: 0 auto;
  padding: 48px 24px 32px;
}
.docs-hero h1 {
  font-family: var(--sans);
  font-size: 40px;
  font-weight: 700;
  color: var(--heading);
  letter-spacing: -0.02em;
  margin-bottom: 10px;
}
.docs-hero p {
  font-family: var(--serif);
  font-size: 19px;
  line-height: 1.55;
  color: var(--text-muted);
  max-width: 720px;
}

.category {
  max-width: var(--docs-max);
  margin: 0 auto;
  padding: 16px 24px 40px;
}
.category h2 {
  font-size: 18px;
  font-weight: 700;
  color: var(--heading);
  margin: 28px 0 14px;
  font-family: var(--sans);
  letter-spacing: -0.01em;
  padding-bottom: 4px;
  border-bottom: 1px solid var(--border);
}

.surface-grid {
  display: grid;
  grid-template-columns: repeat(auto-fill, minmax(320px, 1fr));
  gap: 16px;
}
.surface-card {
  border: 1px solid var(--border);
  border-radius: 8px;
  padding: 18px 20px;
  background: #fff;
  transition: border-color .15s, box-shadow .15s;
  text-decoration: none;
  color: inherit;
  display: block;
}
.surface-card:hover {
  border-color: var(--accent);
  box-shadow: 0 2px 8px rgba(26,137,23,0.06);
}
.surface-card h3 {
  font-family: var(--sans);
  font-size: 16px;
  font-weight: 700;
  color: var(--heading);
  margin: 0 0 6px;
  display: flex;
  align-items: center;
  gap: 8px;
}
.surface-card .pending-badge {
  font-size: 10px;
  font-family: var(--mono);
  background: #fff6e3;
  color: var(--amber);
  padding: 2px 6px;
  border-radius: 8px;
  letter-spacing: 0.04em;
  font-weight: 500;
}
.surface-card p {
  font-size: 14px;
  color: var(--text-muted);
  line-height: 1.5;
  margin: 0 0 10px;
}
.surface-card .install {
  font-family: var(--mono);
  font-size: 12px;
  background: var(--code-bg);
  padding: 6px 10px;
  border-radius: 4px;
  color: var(--code-text);
  display: block;
  overflow-x: auto;
  white-space: nowrap;
}

/* Top bar inherits from main.css */
.top-bar-inner .active { color: var(--accent); font-weight: 600; }