/* developers.php — the docs. Same rules as the rest of the site: plates one step
   lighter than their ground, no outlines, red only for what wants you. Method
   tags and syntax colours are the one place hues carry meaning, and each is a
   status hue at low tint so none of them shouts. */

.docs-layout { width: min(var(--wrap), 100% - 2 * var(--gut)); margin-inline: auto; display: grid; grid-template-columns: 240px minmax(0, 1fr); gap: clamp(32px, 4vw, 64px); padding: 40px 0 clamp(72px, 9vw, 120px); }
.docs-content { min-width: 0; max-width: 880px; --accent: var(--t-hi); --mono: "JetBrains Mono", ui-monospace, "Cascadia Code", Menlo, Consolas, monospace; }

/* ── Sidebar ───────────────────────────────────────────────────────────── */
.docs-sidebar { position: sticky; top: 84px; align-self: start; max-height: calc(100vh - 100px); overflow-y: auto; padding: 4px 8px 24px 0; scrollbar-width: thin; scrollbar-color: var(--plate-hi) transparent; }
.sidebar-section + .sidebar-section { margin-top: 22px; }
.sidebar-section h4 { margin: 0 0 6px; padding-left: 10px; font: 600 12px/16px var(--font); letter-spacing: .085em; text-transform: uppercase; color: var(--t-mut); }
.sidebar-link { display: flex; align-items: center; min-height: 32px; padding: 5px 10px; border-radius: var(--r-ctl); font: var(--w-row) 14px/20px var(--font); color: var(--t-mut); transition: background-color .1s, color .1s; }
.sidebar-link:hover { background: var(--hover); color: var(--t-hi); }
.sidebar-link.active { background: var(--plate); color: var(--t-hi); }

@media (max-width: 1024px) {
  .docs-layout { grid-template-columns: 1fr; gap: 0; padding-top: 0; }
  /* One sticky row of every section under the header, swiped sideways. */
  .docs-sidebar { top: 68px; z-index: 10; max-height: none; display: flex; gap: 4px; margin: 0 calc(-1 * var(--gut)); padding: 8px var(--gut); overflow-x: auto; overflow-y: hidden; background: var(--rail); scrollbar-width: none; }
  .docs-sidebar::-webkit-scrollbar { display: none; }
  .sidebar-section { display: contents; }
  .sidebar-section h4 { display: none; }
  .sidebar-link { flex: none; min-height: 32px; background: var(--plate); white-space: nowrap; }
  .sidebar-link.active { background: var(--plate-hi); }
}

/* ── Hero ──────────────────────────────────────────────────────────────── */
.docs-hero { padding: clamp(32px, 5vw, 56px) 0 0; }
.docs-hero-eyebrow { display: block; margin-bottom: 18px; font: 600 12px/16px var(--font); letter-spacing: .085em; text-transform: uppercase; color: var(--t-mut); }
.docs-hero h1 { font: 600 clamp(38px, 5vw, 64px)/1.04 var(--display); letter-spacing: -.045em; color: var(--t-hi); }
.docs-hero h1 span { color: var(--accent-text); }
.docs-hero p { margin-top: 20px; max-width: 60ch; font: var(--w-body) clamp(17px, 1.5vw, 19px)/1.6 var(--font); color: var(--t-mut); }

/* ── Sections ──────────────────────────────────────────────────────────── */
.docs-section { padding-top: clamp(48px, 6vw, 72px); scroll-margin-top: 84px; }
@media (max-width: 1024px) { .docs-section { scroll-margin-top: 124px; } }
.docs-section h2 { margin-bottom: 18px; font: 600 clamp(26px, 2.8vw, 34px)/1.12 var(--display); letter-spacing: -.04em; color: var(--t-hi); }
.docs-section h3 { margin: 40px 0 12px; font: var(--w-strong) 19px/26px var(--font); letter-spacing: -.012em; color: var(--t-hi); }
.docs-section h4 { margin: 24px 0 8px; font: var(--w-strong) 16px/22px var(--font); color: var(--t-hi); }
.docs-section p, .docs-section li { font: var(--w-body) 16px/26px var(--font); color: var(--t); }
.docs-section p + p { margin-top: 12px; }
.docs-section > p, .docs-section > ul, .docs-section > ol { margin-bottom: 16px; }
.docs-section ul, .docs-section ol { padding-left: 22px; }
.docs-section li + li { margin-top: 4px; }
.docs-section li::marker { color: var(--t-faint); }
.docs-section strong { color: var(--t-hi); font-weight: 600; }
.docs-content a { color: var(--t-hi); text-decoration: underline; text-decoration-color: var(--t-faint); text-decoration-thickness: 1px; text-underline-offset: 3px; }
.docs-content a:hover { text-decoration-color: var(--t-hi); }

/* Inline code: an ink chip, never a colour. */
.docs-content code { padding: 2px 6px; border-radius: 5px; background: var(--plate-hi); font: 500 .86em/1.4 var(--mono); color: var(--t-hi); overflow-wrap: anywhere; }

/* ── Endpoint cards ────────────────────────────────────────────────────── */
.endpoint { margin: 0 0 12px; border-radius: 16px; background: var(--stage); overflow: hidden; }
.endpoint-header { display: flex; flex-wrap: wrap; align-items: center; gap: 10px 12px; padding: 14px 18px; background: var(--panel); }
.method { flex: none; display: inline-flex; align-items: center; height: 22px; padding: 0 7px; border-radius: 5px; font: 700 11.5px/22px var(--mono); letter-spacing: .04em; }
.method-get { background: color-mix(in srgb, var(--online) 16%, transparent); color: #7fdcaa; }
.method-post { background: var(--info-tint); color: var(--info); }
.method-put, .method-patch { background: color-mix(in srgb, var(--idle) 16%, transparent); color: #ecc67c; }
.method-delete { background: var(--accent-tint-hi); color: var(--accent-text); }
.endpoint-path { min-width: 0; font: 500 14px/20px var(--mono); color: var(--t-hi); overflow-wrap: anywhere; }
.endpoint-desc { padding: 16px 18px 0; font: var(--w-body) 15px/24px var(--font); color: var(--t); }
.endpoint-desc + .endpoint-body, .endpoint-body { padding: 8px 18px 18px; }
.endpoint-body > p, .endpoint-body li { font-size: 15px; line-height: 24px; }
.endpoint > .code-block:last-child { margin: 12px 18px 18px; }

/* ── Code blocks ───────────────────────────────────────────────────────── */
.code-block { margin: 14px 0; border-radius: 12px; background: var(--panel); overflow: hidden; }
.endpoint .code-block { background: var(--panel); }
.code-block-header { display: flex; align-items: center; justify-content: space-between; gap: 12px; padding: 10px 14px 0; font: 600 11px/16px var(--font); letter-spacing: .085em; text-transform: uppercase; color: var(--t-faint); }
.code-block pre { margin: 0; padding: 10px 14px 14px; overflow-x: auto; font: 400 13px/21px var(--mono); color: var(--t); tab-size: 2; scrollbar-width: thin; scrollbar-color: var(--plate-hi) transparent; }
.code-block pre .key { color: var(--info); }
.code-block pre .str { color: #8fd5a6; }
.code-block pre .num { color: #e5c07b; }
.code-block pre .bool { color: var(--accent-text); }
.code-block pre .comment { color: var(--t-faint); font-style: italic; }
.docs-content pre code { padding: 0; background: none; font: inherit; color: inherit; }

/* ── Callouts: a plate with a 3px rule — info in the neutral ink, warnings in the idle hue ── */
.docs-content .callout { display: flex; gap: 14px; margin: 18px 0; padding: 16px 18px 16px 21px; border-radius: 14px; background: var(--plate); font: var(--w-body) 15px/24px var(--font); color: var(--t); }
.docs-content .callout::before { top: 12px; bottom: 12px; }
.docs-content .callout svg { width: 18px; height: 18px; flex: none; margin-top: 3px; fill: var(--t-mut); }
.docs-content .callout-info::before { background: var(--info); }
.docs-content .callout-warn::before { background: var(--idle); }
.docs-content .callout-warn svg { fill: var(--idle); }

/* ── Tables ────────────────────────────────────────────────────────────── */
.docs-table { width: 100%; margin: 14px 0; border-collapse: separate; border-spacing: 0; border-radius: 14px; background: var(--plate); overflow: hidden; font: var(--w-body) 14.5px/22px var(--font); }
.docs-table th { padding: 12px 14px 8px; text-align: left; background: none !important; font: 600 11.5px/16px var(--font) !important; letter-spacing: .085em !important; text-transform: uppercase; color: var(--t-mut) !important; white-space: nowrap; }
.docs-table td { padding: 10px 14px; vertical-align: top; color: var(--t); border-top: 1px solid var(--edge); }
.docs-table td:first-child { color: var(--t-hi); }
@media (max-width: 768px) { .docs-table { display: block; overflow-x: auto; } }