/* Docs area — three-column shell + self-contained article typography.
   Built on site.css design tokens so it matches the rest of keld.co. */

/* Docs pages use a plain background for readability — suppress the site-wide
   ambient mesh field that site.js injects as .page-wash on every page. */
.page-wash { display: none; }

.docs-wrap { padding: 96px 24px 80px; }
.docs-shell {
  display: grid;
  grid-template-columns: 240px minmax(0, 1fr) 220px;
  gap: 48px;
  max-width: 1280px;
  margin: 0 auto;
  align-items: start;
}

/* Sidebar */
.docs-side { position: sticky; top: 96px; align-self: start; font-family: var(--ff-sans); }
.docs-side-group { margin-bottom: 22px; }
.docs-side-group > h4 {
  font-family: var(--ff-mono); font-size: 11px; letter-spacing: .06em;
  text-transform: uppercase; color: var(--g-600); margin: 0 0 8px;
}
.docs-side a {
  display: block; padding: 5px 10px; border-radius: 8px;
  font-size: 14px; color: var(--text-secondary); text-decoration: none; line-height: 1.35;
}
.docs-side a:hover { background: var(--bg-1); color: var(--text-primary); }
.docs-side a.is-current { background: var(--accent-light); color: var(--g-700); font-weight: 600; }

/* Main column */
.docs-main { min-width: 0; }
.docs-breadcrumb { font-family: var(--ff-mono); font-size: 12px; color: var(--text-secondary); margin-bottom: 14px; }
.docs-breadcrumb a { color: var(--accent); text-decoration: none; }
.docs-title { font-family: var(--ff-display); font-weight: 600; font-size: clamp(30px, 4vw, 44px); letter-spacing: -.02em; line-height: 1.08; margin: 0 0 10px; }
.docs-meta { display: flex; flex-wrap: wrap; align-items: center; gap: 8px; font-family: var(--ff-mono); font-size: 13px; color: var(--text-secondary); padding-bottom: 22px; margin-bottom: 26px; border-bottom: 1px solid var(--border-md); }
.docs-byline { display: inline-flex; align-items: center; gap: 8px; }
.docs-avatar { width: 26px; height: 26px; border-radius: 50%; flex: none; overflow: hidden; display: inline-flex; align-items: center; justify-content: center; position: relative; }
.docs-avatar img { position: absolute; inset: 0; width: 100%; height: 100%; object-fit: cover; display: block; }
.docs-avatar--mono { background: var(--accent-light); color: var(--accent); border: 1px solid var(--accent-bdr); font-size: 10px; font-weight: 600; letter-spacing: .02em; }
.docs-meta-sep { color: var(--text-tertiary); }

/* Article typography */
.docs-article { font-family: var(--ff-sans); }
.docs-article p, .docs-article li { font-size: 16px; line-height: 1.7; color: rgba(10,28,14,.86); }
.docs-article p { margin: 0 0 16px; }
.docs-article h2 { font-family: var(--ff-display); font-weight: 600; font-size: 26px; letter-spacing: -.015em; margin: 40px 0 12px; scroll-margin-top: 96px; }
.docs-article h3 { font-family: var(--ff-display); font-weight: 600; font-size: 19px; margin: 26px 0 8px; scroll-margin-top: 96px; }
.docs-article h4 { font-family: var(--ff-display); font-weight: 600; font-size: 16px; margin: 20px 0 6px; scroll-margin-top: 96px; }
.docs-article blockquote { margin: 0 0 18px; padding: 8px 0 8px 16px; border-left: 3px solid var(--accent-bdr); color: var(--text-secondary); font-style: italic; }
.docs-article blockquote p { margin: 0; }
.docs-article ul, .docs-article ol { margin: 0 0 16px; padding-left: 22px; }
.docs-article ul { list-style: disc; }
.docs-article ol { list-style: decimal; }
.docs-article li { margin: 4px 0; }
.docs-article a { color: var(--g-600); text-decoration: none; border-bottom: 1px solid var(--accent-bdr); }
.docs-article a:hover { border-bottom-color: var(--accent); }
.docs-article strong { color: var(--text-primary); font-weight: 700; }
.docs-article hr { border: 0; border-top: 1px solid var(--border-md); margin: 34px 0; }
.docs-article img { max-width: 100%; height: auto; border-radius: var(--r-lg); border: 1px solid var(--border-md); margin: 12px 0; }

/* Inline + block code */
.docs-article code { font-family: var(--ff-mono); font-size: .88em; background: var(--bg-1); padding: 1px 5px; border-radius: 5px; }
.docs-article pre.hljs { font-family: var(--ff-mono); font-size: 13.5px; line-height: 1.6; background: var(--g-900); color: #e8f0ea; padding: 16px 18px; border-radius: var(--r-lg); overflow-x: auto; margin: 0 0 18px; }
.docs-article pre.hljs code { background: none; padding: 0; font-size: inherit; color: inherit; }

/* highlight.js token theme (readable on the dark-green code background) */
.docs-article .hljs-comment, .docs-article .hljs-quote { color: #7f9c8b; font-style: italic; }
.docs-article .hljs-keyword, .docs-article .hljs-selector-tag, .docs-article .hljs-literal, .docs-article .hljs-section, .docs-article .hljs-link { color: #9fd3b8; }
.docs-article .hljs-string, .docs-article .hljs-attr, .docs-article .hljs-template-tag, .docs-article .hljs-addition { color: #cbe8a0; }
.docs-article .hljs-number, .docs-article .hljs-built_in, .docs-article .hljs-type, .docs-article .hljs-symbol, .docs-article .hljs-bullet { color: #e5c98a; }
.docs-article .hljs-title, .docs-article .hljs-name { color: #bfe3ff; }
.docs-article .hljs-attribute, .docs-article .hljs-variable, .docs-article .hljs-tag { color: #d7e5dc; }
.docs-article .hljs-emphasis { font-style: italic; }
.docs-article .hljs-strong { font-weight: 700; }

/* Tables (raw HTML from Notion, header row promoted to <th>) */
.docs-article table { width: 100%; border-collapse: collapse; margin: 0 0 20px; font-size: 14.5px; display: block; overflow-x: auto; }
.docs-article th, .docs-article td { text-align: left; padding: 9px 12px; border: 1px solid var(--border-md); vertical-align: top; }
.docs-article th { background: var(--bg-1); font-weight: 600; color: var(--text-primary); }

/* Callouts (custom handler / raw HTML) */
.docs-article .callout { display: flex; gap: 10px; background: var(--accent-light); border: 1px solid var(--accent-bdr); border-radius: var(--r-lg); padding: 14px 16px; margin: 0 0 18px; font-size: 15px; }
.docs-article details { border: 1px solid var(--border-md); border-radius: var(--r-lg); padding: 10px 14px; margin: 0 0 18px; }
.docs-article summary { cursor: pointer; font-weight: 600; }

/* TOC */
.docs-toc { position: sticky; top: 96px; align-self: start; font-family: var(--ff-sans); }
.docs-toc h4 { font-family: var(--ff-mono); font-size: 11px; letter-spacing: .06em; text-transform: uppercase; color: var(--g-600); margin: 0 0 8px; }
.docs-toc ul { list-style: none; margin: 0; padding: 0; border-left: 1px solid var(--border-md); }
.docs-toc li { margin: 0; }
.docs-toc a { display: block; padding: 4px 12px; font-size: 13px; color: var(--text-secondary); text-decoration: none; line-height: 1.35; }
.docs-toc a:hover { color: var(--text-primary); }
.docs-toc .toc-l3 a { padding-left: 24px; font-size: 12.5px; }
.docs-toc .toc-l4 a { padding-left: 36px; font-size: 12px; }

/* Responsive */
@media (max-width: 1080px) {
  .docs-shell { grid-template-columns: 220px minmax(0, 1fr); }
  .docs-toc { display: none; }
}
@media (max-width: 760px) {
  .docs-wrap { padding: 80px 18px 64px; }
  .docs-shell { grid-template-columns: 1fr; gap: 20px; }
  .docs-side { position: static; border-bottom: 1px solid var(--border-md); padding-bottom: 16px; }
}
