/* /docs: article pages, the index and the reference (docs/build_docs.py). Extends site.css: same tokens, masthead,
   theme toggle. Article text is 17 px for reading; the reference stays at the site's denser 15 px. */

:root { --mono: ui-monospace, 'SFMono-Regular', 'JetBrains Mono', Menlo, Consolas, monospace; --code-bg: var(--sunk); }
:root[data-theme="dark"] { --code-bg: #0b0e12; }
@media (prefers-color-scheme: dark) { :root:not([data-theme="light"]) { --code-bg: #0b0e12; } }

.docs-nav { flex: 1; display: flex; gap: 4px; }
.docs-nav a { font-size: 13.5px; font-weight: 500; color: var(--ink-2); padding: 6px 10px; border-radius: 999px; }
.docs-nav a:hover, .docs-nav a[aria-current] { background: var(--sunk); color: var(--ink); }
.subscribe { font-size: 13px; font-weight: 650; padding: 7px 12px; border-radius: 8px; background: var(--accent); color: #fff; white-space: nowrap; }
.subscribe:hover { color: #fff; opacity: .9; }

/* ---- article grid: text 680 / wide breakouts / rail on the right ------------------------------------ */
.article-grid { display: grid; grid-template-columns: [full-start] minmax(16px, 1fr) [text-start] min(680px, calc(100% - 32px)) [text-end] minmax(16px, 1fr) [full-end];
    padding: 40px 0 24px; }
.article-head, .prose { grid-column: text; }
.article-rail { display: none; }
.kicker { font-size: 12px; font-weight: 700; letter-spacing: .08em; text-transform: uppercase; color: var(--accent-ink); margin: 0 0 12px; }
.kicker code { font: 600 12px var(--mono); text-transform: none; letter-spacing: 0; }
.article-head h1 { font-size: 40px; line-height: 1.1; letter-spacing: -0.03em; font-weight: 750; margin-bottom: 14px; text-wrap: balance; }
.dek { font-size: 19px; line-height: 1.5; color: var(--ink-2); margin-bottom: 20px; }
.hero-actions { display: flex; flex-wrap: wrap; gap: 10px; margin: 6px 0 20px; }
.button { display: inline-flex; align-items: center; padding: 9px 14px; border-radius: 8px; border: 1px solid var(--line-2); font-weight: 600; font-size: 14px; color: var(--ink); }
.button.primary { background: var(--ink); color: var(--bg); border-color: var(--ink); }
.button.primary:hover { color: var(--bg); opacity: .9; }
.toc-inline { border: 1px solid var(--line); border-radius: var(--radius); padding: 8px 12px; margin-bottom: 8px; font-size: 14px; }
.toc-inline summary { cursor: pointer; font-weight: 600; color: var(--ink-2); }
.toc-inline ol, .toc-inline ul { margin: 8px 0 4px; padding-left: 18px; }

.prose { font-size: 17px; line-height: 1.7; }
.prose > * + * { margin-top: 1em; }
.prose h2 { font-size: 24px; line-height: 1.25; font-weight: 700; letter-spacing: -0.015em; margin-top: 2.2em; scroll-margin-top: 72px; }
.prose h3 { font-size: 18px; font-weight: 650; margin-top: 1.6em; scroll-margin-top: 72px; }
.prose a { color: var(--accent-ink); text-decoration: underline; text-decoration-thickness: 1px; text-underline-offset: 3px; }
.prose ul, .prose ol { padding-left: 1.3em; }
.prose li + li { margin-top: .35em; }
.prose code { font: .88em var(--mono); background: var(--code-bg); padding: 2px 5px; border-radius: 4px; }
.prose table { width: 100%; border-collapse: collapse; font-size: 15px; line-height: 1.45; display: block; overflow-x: auto; }
.prose th, .prose td { text-align: left; padding: 8px 10px; border-bottom: 1px solid var(--line); vertical-align: top; }
.prose th { font-size: 12.5px; text-transform: uppercase; letter-spacing: .05em; color: var(--ink-3); }

@media (min-width: 900px) {
    .prose .code, .prose .output { margin-left: -40px; margin-right: -40px; }
    .prose figure.chart { margin-left: -100px; margin-right: -100px; }
}

/* ---- code ----------------------------------------------------------------------------------------- */
.code, .output { border: 1px solid var(--line); border-radius: var(--radius); background: var(--code-bg); overflow: hidden; margin-top: 1.4em !important; }
.output { background: var(--surface); }
.code-head { display: flex; align-items: center; justify-content: space-between; gap: 8px; height: 36px; padding: 0 6px 0 12px; border-bottom: 1px solid var(--line); }
.code-label { font-size: 11.5px; font-weight: 700; letter-spacing: .06em; text-transform: uppercase; color: var(--ink-3); }
.tablist { display: flex; gap: 2px; }
.tablist button { border: 0; background: none; font: 600 12.5px var(--font); color: var(--ink-3); padding: 9px 9px 7px; cursor: pointer; border-bottom: 2px solid transparent; }
.tablist button[aria-selected="true"] { color: var(--ink); border-bottom-color: var(--accent); }
.copy { border: 1px solid var(--line-2); background: var(--surface); color: var(--ink-2); font: 600 12px var(--font); border-radius: 6px; padding: 4px 9px; cursor: pointer; }
.copy.done { color: var(--accent-ink); border-color: var(--accent); }
.code pre, .output pre { margin: 0; padding: 14px 16px; overflow-x: auto; font: 13.5px/1.6 var(--mono); }
.code pre code, .output pre code { font: inherit; background: none; padding: 0; white-space: pre; }
.output pre code { white-space: pre-wrap; overflow-wrap: anywhere; }   /* long URLs in captured JSON wrap */
.tabs .panel[hidden] { display: none; }
.output.collapsed pre { max-height: 320px; overflow: hidden; -webkit-mask-image: linear-gradient(#000 75%, transparent); mask-image: linear-gradient(#000 75%, transparent); }
.expand-output { display: block; width: 100%; border: 0; border-top: 1px solid var(--line); background: var(--surface); color: var(--accent-ink); font: 600 13px var(--font); padding: 8px; cursor: pointer; }

/* syntax (pygments short classes) on site tokens; orange stays reserved for bearish and pitfalls */
.code .s, .code .s1, .code .s2, .code .sa, .code .sb, .code .sd, .code .si, .output .s2, .output .s1 { color: var(--accent-ink); }
.code .mi, .code .mf, .code .m, .code .kc, .output .mi, .output .mf, .output .kc { color: var(--bull); }
.code .c, .code .c1, .code .cm, .code .p, .output .p { color: var(--ink-3); }
.code .k, .code .kn, .code .ow, .code .nb, .code .fm { color: var(--mix); }
.code .nt, .output .nt { color: var(--ink); font-weight: 600; }

/* ---- callouts -------------------------------------------------------------------------------------- */
.callout { border-radius: var(--radius); padding: 14px 18px; font-size: 15.5px; line-height: 1.6; margin-top: 1.6em !important; }
.callout > * + * { margin-top: .6em; }
.callout-label { font-size: 12px; font-weight: 700; letter-spacing: .08em; text-transform: uppercase; }
.callout.note { background: var(--accent-soft); }
.callout.note .callout-label { color: var(--accent-ink); }
.callout.pitfall { background: var(--bear-soft); border-left: 3px solid var(--bear); }
.callout.pitfall .callout-label { color: var(--bear); }
.callout.legacy { background: var(--sunk); }
.callout table { font-size: 14px; }

/* ---- figures ------------------------------------------------------------------------------------- */
figure.chart { margin: 1.8em 0 0 !important; }
.chart-svg { border: 1px solid var(--line); border-radius: var(--radius); background: var(--surface); padding: 10px 6px 0; }
.chart-svg svg { display: block; width: 100%; height: auto; }
figcaption { display: grid; gap: 2px; font-size: 14px; line-height: 1.5; margin-top: 10px; }
figcaption span { color: var(--ink-3); font-size: 13px; }
.data-table { font-size: 13px; margin-top: 6px; }
.data-table summary { cursor: pointer; color: var(--ink-3); }
.data-table table { font-variant-numeric: tabular-nums; }
svg .grid { stroke: var(--line); }
svg .zero { stroke: var(--line-2); stroke-dasharray: 3 3; }
svg .tick, svg .legend text { fill: var(--ink-3); font: 11px var(--font); }
svg .bar.bullish { fill: var(--bull); } svg .bar.bearish { fill: var(--bear); } svg .bar.neutral { fill: var(--spark); opacity: .55; }
svg .bar.accent { fill: var(--accent); opacity: .8; }
svg .score { fill: none; stroke: var(--ink); stroke-width: 1.8; }
svg .cumulative { fill: none; stroke: var(--accent); stroke-width: 2.2; }

/* ---- index: guide cards --------------------------------------------------------------------------- */
.guide-grid { display: grid; grid-template-columns: repeat(auto-fill, minmax(260px, 1fr)); gap: 16px; margin-top: 1em; }
.guide-card { display: flex; flex-direction: column; background: var(--surface); border: 1px solid var(--line); border-radius: var(--radius);
    box-shadow: var(--shadow); overflow: hidden; text-decoration: none !important; color: var(--ink) !important; transition: transform .15s; }
.guide-card:hover { transform: translateY(-2px); }
.guide-figure { aspect-ratio: 16 / 8; background: var(--sunk); border-bottom: 1px solid var(--line); }
.guide-figure svg { width: 100%; height: 100%; display: block; }
.guide-text { padding: 14px 16px 16px; display: grid; gap: 6px; font-size: 14.5px; line-height: 1.5; }
.guide-text .kicker { margin: 0; }
.guide-text h3 { font-size: 17px; line-height: 1.3; margin: 0; }
.guide-text p { color: var(--ink-2); margin: 0; }
.guide-text .read { font-size: 13px; font-weight: 600; color: var(--accent-ink); }

.run-yourself { margin-top: 2.4em !important; padding-top: 1.2em; border-top: 1px solid var(--line); font-size: 15px; color: var(--ink-2); }
.article-pager { display: grid; grid-template-columns: 1fr 1fr; gap: 12px; margin-top: 1.2em !important; }
.article-pager a { display: grid; gap: 2px; border: 1px solid var(--line); border-radius: var(--radius); padding: 12px 14px; text-decoration: none !important; color: var(--ink) !important; font-size: 15px; font-weight: 600; line-height: 1.35; }
.article-pager a span { font-size: 12px; font-weight: 600; color: var(--ink-3); text-transform: uppercase; letter-spacing: .06em; }
.article-pager .next { text-align: right; }

@media (min-width: 1180px) {
    .article-grid { grid-template-columns: [full-start] 1fr [text-start] 680px [text-end] 64px 240px 1fr [full-end]; }
    .article-rail { display: block; grid-column: 4; grid-row: 1 / span 2; position: sticky; top: 80px; align-self: start; font-size: 13px; padding-top: 6px; }
    .toc-inline { display: none; }
    .article-rail ol, .article-rail ul { list-style: none; padding: 0; margin: 0 0 22px; display: grid; gap: 6px; }
    .article-rail li.sub { padding-left: 12px; }
    .article-rail a { color: var(--ink-3); }
    .article-rail a:hover, .article-rail a.active { color: var(--accent-ink); }
    .rail-title { font-size: 11.5px; font-weight: 700; letter-spacing: .08em; text-transform: uppercase; color: var(--ink-2); margin-bottom: 8px; }
    .endpoint-chips code { font: 12px var(--mono); }
}

/* ---- reference ------------------------------------------------------------------------------------ */
.reference { display: grid; grid-template-columns: 1fr; max-width: 1440px; margin: 0 auto; padding: 0 16px; }
.ref-nav { display: none; }
.ref-head { padding: 36px 0 8px; max-width: 720px; }
.ref-head h1 { font-size: 36px; letter-spacing: -0.025em; margin-bottom: 10px; }
.ref-head .dek { font-size: 16px; }
.ref-head code, .endpoint code { font-family: var(--mono); font-size: .9em; }
.ref-main h2 { font-size: 13px; font-weight: 700; letter-spacing: .08em; text-transform: uppercase; color: var(--ink-3); margin: 40px 0 0; padding-top: 12px; border-top: 2px solid var(--ink); scroll-margin-top: 72px; }
.endpoint { display: grid; grid-template-columns: minmax(0, 1fr); gap: 16px 40px; padding: 28px 0; border-bottom: 1px solid var(--line); scroll-margin-top: 72px; }
.endpoint h3 { display: flex; flex-wrap: wrap; align-items: center; gap: 8px; font-size: 15px; }
.endpoint .anchor { color: var(--ink-3); font-weight: 400; width: 12px; opacity: 0; }
.endpoint:hover .anchor { opacity: 1; }
.method { font: 700 11px var(--mono); padding: 3px 6px; border-radius: 5px; background: var(--sunk); color: var(--ink-2); }
.path { font: 600 15px var(--mono) !important; }
.pill { font-size: 11px; font-weight: 700; padding: 2px 8px; border-radius: 999px; }
.pill.v2 { background: var(--accent-soft); color: var(--accent-ink); }
.pill.legacy { background: var(--sunk); color: var(--ink-3); }
.summary { font-weight: 600; margin: 8px 0 4px; }
.endpoint-doc > p { font-size: 15px; line-height: 1.6; color: var(--ink-2); }
.fields-label { font-size: 12px !important; font-weight: 700; letter-spacing: .06em; text-transform: uppercase; color: var(--ink-3) !important; margin-top: 16px; }
.params { list-style: none; margin: 6px 0 0; padding: 0; }
.params li { padding: 8px 0; border-top: 1px solid var(--line); font-size: 14px; line-height: 1.5; }
.param-head { display: flex; flex-wrap: wrap; gap: 4px 10px; align-items: baseline; }
.params .name { font-weight: 650; color: var(--ink); }
.params .type, .muted { color: var(--ink-3); font-size: 13px; }
.params p { margin: 2px 0 0; color: var(--ink-2); }
.req { color: var(--bear); font-weight: 600; }
.endpoint-code .code { margin-top: 0 !important; }
.endpoint-code .output { margin-top: 12px !important; }

@media (min-width: 1180px) {
    .reference { grid-template-columns: 230px minmax(0, 1fr); gap: 40px; padding: 0 24px; }
    .ref-nav { display: block; position: sticky; top: 72px; align-self: start; max-height: calc(100vh - 88px); overflow: auto; padding: 32px 0; font-size: 13.5px; }
    .ref-nav ul { list-style: none; margin: 0 0 14px; padding: 0; display: grid; gap: 4px; }
    .ref-nav a { color: var(--ink-2); display: block; padding: 3px 8px; border-radius: 6px; }
    .ref-nav a:hover, .ref-nav a.active { background: var(--accent-soft); color: var(--accent-ink); }
    .ref-title { font-weight: 700; margin-bottom: 14px; }
    .nav-group { font-size: 11.5px; font-weight: 700; letter-spacing: .08em; text-transform: uppercase; color: var(--ink-3); margin: 10px 0 6px; cursor: pointer; }
    .ref-head .toc-inline { display: none; }
    .endpoint { grid-template-columns: minmax(0, 1fr) minmax(0, 520px); }
    .endpoint-code { position: sticky; top: 72px; align-self: start; max-height: calc(100vh - 90px); overflow: auto; }
}

@media (max-width: 640px) {
    .docs-nav a:not(:last-child) { display: none; }
    .article-head h1 { font-size: 28px; }
    .dek { font-size: 17px; }
    .prose { font-size: 16.5px; }
    .prose .code, .prose .output { margin-left: -16px; margin-right: -16px; border-radius: 0; border-left: 0; border-right: 0; }
    .code pre code, .output pre code { white-space: pre-wrap; overflow-wrap: anywhere; }
    .article-pager { grid-template-columns: 1fr; }
    .subscribe { padding: 6px 10px; }
}