/*
 * Documentation site (docs.clearexchange.ai and /docs/ on the main site). Pages are
 * rendered from docs/*.md by src/docs/site.ts. Values come only from tokens.css, so the
 * docs follow a rebrand automatically. Editorial layout: a left contents column, a
 * reading column at a comfortable measure, an "On this page" column on wide screens;
 * serif headings, hairline and heavy rules, no shadows.
 */
.docs {
  --docs-serif: var(--font-serif);
  --docs-rule: var(--rule-strong);
  --docs-nav-width: 15rem;
  --docs-toc-width: 13rem;
  font-size: var(--text-base);
  line-height: var(--leading-relaxed);
  background: var(--background);
}

/* ---- header ---- */
.docs-header { position: sticky; top: 0; z-index: 20; background: var(--header); border-bottom: 1px solid var(--border); }
.docs-header-inner { max-width: var(--container-app); margin: 0 auto; height: var(--header-height); padding: 0 var(--space-6); display: flex; align-items: center; gap: var(--space-4); }
.docs-header-link { margin-left: auto; font-size: var(--text-sm); font-weight: var(--weight-medium); color: var(--foreground); text-decoration: none; white-space: nowrap; }
.docs-header-link:hover { text-decoration: underline; }

/* ---- search ---- */
.docs-search { position: relative; margin-left: auto; width: min(22rem, 40vw); }
.docs-search + .docs-header-link { margin-left: 0; }
.docs-search input {
  width: 100%; height: 34px; padding: 0 var(--space-8) 0 var(--space-3);
  font: inherit; font-size: var(--text-sm); color: var(--foreground);
  background: var(--card); border: 1px solid var(--input); border-radius: var(--radius-md);
}
.docs-search input::placeholder { color: var(--subtle-foreground); }
.docs-search input:focus-visible { box-shadow: var(--focus-ring); }
.docs-search-key { position: absolute; right: var(--space-2); top: 50%; transform: translateY(-50%); font-size: var(--text-2xs); color: var(--muted-foreground); border: 1px solid var(--border-strong); border-radius: var(--radius-sm); padding: 0 5px; line-height: 1.5; pointer-events: none; }
.docs-results {
  position: absolute; top: calc(100% + var(--space-1)); left: 0; right: 0; margin: 0; padding: var(--space-1) 0; list-style: none;
  max-height: min(70vh, 32rem); overflow-y: auto;
  background: var(--card); border: 1px solid var(--border-strong); border-top: 2px solid var(--docs-rule); border-radius: var(--radius-md);
}
.docs-results a { display: block; padding: var(--space-2) var(--space-3); color: var(--foreground); text-decoration: none; font-size: var(--text-sm); line-height: var(--leading-snug); }
.docs-results a[aria-selected="true"], .docs-results a:hover { background: var(--muted); }
.docs-results .r-where { display: block; font-size: var(--text-xs); color: var(--muted-foreground); }
.docs-results .r-title { display: block; font-weight: var(--weight-medium); }
.docs-results .r-snippet { display: block; margin-top: 2px; font-size: var(--text-xs); color: var(--muted-foreground); }
.docs-results .r-empty { padding: var(--space-2) var(--space-3); font-size: var(--text-sm); color: var(--muted-foreground); }

/* ---- layout ---- */
.docs-layout {
  max-width: var(--container-app); margin: 0 auto; padding: 0 var(--space-6);
  display: grid; grid-template-columns: var(--docs-nav-width) minmax(0, 1fr) var(--docs-toc-width); gap: var(--space-10);
  align-items: start;
}
.docs-nav, .docs-toc { position: sticky; top: var(--header-height); max-height: calc(100vh - var(--header-height)); overflow-y: auto; padding: var(--space-8) 0; font-size: var(--text-sm); }
.docs-nav ul, .docs-toc ul { list-style: none; margin: 0; padding: 0; }
.docs-nav-group + .docs-nav-group { margin-top: var(--space-6); }
.docs-nav-label { margin: 0 0 var(--space-2); font-size: var(--text-2xs); font-weight: var(--weight-semibold); letter-spacing: var(--tracking-wide); text-transform: uppercase; color: var(--muted-foreground); }
.docs-nav a { display: block; padding: 3px 0 3px var(--space-3); border-left: 1px solid var(--border); color: var(--muted-foreground); text-decoration: none; line-height: var(--leading-snug); }
.docs-nav a:hover { color: var(--foreground); border-left-color: var(--border-strong); }
.docs-nav a[aria-current="page"] { color: var(--foreground); font-weight: var(--weight-medium); border-left: 2px solid var(--brand); padding-left: calc(var(--space-3) - 1px); }
.docs-toc a { display: block; padding: 3px 0; color: var(--muted-foreground); text-decoration: none; line-height: var(--leading-snug); }
.docs-toc a:hover { color: var(--foreground); }
.docs-main { min-width: 0; padding: var(--space-10) 0 var(--space-16); }

/* ---- prose ---- */
.prose { max-width: 46rem; color: var(--foreground); }
.prose > :first-child { margin-top: 0; }
.prose h1, .prose h2, .prose h3, .prose h4 { font-family: var(--docs-serif); font-weight: var(--weight-medium); letter-spacing: var(--tracking-tight); line-height: var(--leading-tight); scroll-margin-top: calc(var(--header-height) + var(--space-4)); }
.prose h1 { font-size: var(--text-5xl); letter-spacing: var(--tracking-tighter); margin: 0 0 var(--space-8); padding-bottom: var(--space-6); border-bottom: 2px solid var(--docs-rule); }
.prose h2 { font-size: var(--text-3xl); margin: var(--space-16) 0 var(--space-4); padding-top: var(--space-4); border-top: 1px solid var(--docs-rule); }
.prose h3 { font-size: var(--text-xl); margin: var(--space-10) 0 var(--space-3); }
.prose h4, .prose h5, .prose h6 { font-size: var(--text-base); margin: var(--space-8) 0 var(--space-2); }
.prose h3 code, .prose h2 code { font-size: 0.8em; }
.heading-anchor { margin-left: var(--space-2); color: var(--subtle-foreground); text-decoration: none; font-family: var(--font-sans); font-weight: var(--weight-normal); opacity: 0; }
.prose :is(h2, h3, h4):hover .heading-anchor { opacity: 1; }
.prose p, .prose ul, .prose ol, .prose blockquote, .prose pre, .prose .table-wrap { margin: 0 0 var(--space-5); }
.prose ul, .prose ol { padding-left: var(--space-6); }
.prose li { margin: var(--space-1) 0; }
.prose li > p { margin: 0 0 var(--space-2); }
.prose li::marker { color: var(--muted-foreground); }
.prose a { color: var(--brand); text-decoration: underline; text-decoration-color: var(--brand-border); text-underline-offset: 3px; }
.prose a:hover { color: var(--brand-hover); text-decoration-color: currentColor; }
.prose strong { font-weight: var(--weight-semibold); }
.prose hr { border: 0; border-top: 1px solid var(--border); margin: var(--space-10) 0; }
.prose blockquote { padding: 0 0 0 var(--space-4); border-left: 2px solid var(--brand); color: var(--muted-foreground); }
.prose :not(pre) > code { font-size: 0.875em; padding: 1px 4px; background: var(--muted); color: var(--foreground); border: 1px solid var(--border); border-radius: var(--radius-sm); overflow-wrap: anywhere; }
.prose a code { color: inherit; }

/* ---- code blocks ---- */
.prose pre { position: relative; overflow-x: auto; padding: var(--space-4) var(--space-5); background: var(--code-bg); color: var(--code-fg); border: 1px solid var(--border); border-top: 2px solid var(--docs-rule); border-radius: var(--radius-md); font-size: var(--text-sm); line-height: var(--leading-normal); }
.prose pre code { font-size: inherit; white-space: pre; }
.prose pre[data-lang]::before { content: attr(data-lang); position: absolute; top: var(--space-1); right: var(--space-3); font-family: var(--font-sans); font-size: var(--text-2xs); letter-spacing: var(--tracking-wide); text-transform: uppercase; color: var(--code-muted); }
.prose pre.has-copy[data-lang]::before { right: calc(var(--space-3) + 3.5rem); }
.code-copy { position: absolute; top: var(--space-1); right: var(--space-2); font: inherit; font-family: var(--font-sans); font-size: var(--text-2xs); line-height: 1; padding: 4px 8px; color: var(--muted-foreground); background: var(--card); border: 1px solid var(--border-strong); border-radius: var(--radius-sm); cursor: pointer; opacity: 0; transition: opacity var(--duration); }
.prose pre:hover .code-copy, .code-copy:focus-visible { opacity: 1; }

/* ---- tables ---- */
.table-wrap { overflow-x: auto; }
.prose table { width: 100%; border-collapse: collapse; font-size: var(--text-sm); line-height: var(--leading-snug); }
.prose th { text-align: left; font-weight: var(--weight-semibold); padding: var(--space-2) var(--space-3) var(--space-2) 0; border-bottom: 2px solid var(--docs-rule); vertical-align: bottom; }
.prose td { padding: var(--space-2) var(--space-3) var(--space-2) 0; border-bottom: 1px solid var(--border); vertical-align: top; }
.prose td:first-child code { white-space: nowrap; }
.prose .align-right { text-align: right; }
.prose .align-center { text-align: center; }

/* ---- previous / next ---- */
.docs-pager { max-width: 46rem; display: grid; grid-template-columns: 1fr 1fr; gap: var(--space-4); margin-top: var(--space-16); padding-top: var(--space-6); border-top: 1px solid var(--border); }
.docs-pager a { display: block; color: var(--foreground); text-decoration: none; font-family: var(--docs-serif); font-size: var(--text-lg); line-height: var(--leading-snug); }
.docs-pager a span { display: block; font-family: var(--font-sans); font-size: var(--text-xs); color: var(--muted-foreground); margin-bottom: var(--space-1); }
.docs-pager a:hover { color: var(--brand); }
.docs-pager-next { grid-column: 2; text-align: right; }

.docs-footer { border-top: 1px solid var(--border); padding: var(--space-6); text-align: center; font-size: var(--text-xs); color: var(--muted-foreground); }
.docs-footer p { margin: 0; }

/* ---- narrower screens ---- */
@media (max-width: 1100px) {
  .docs-layout { grid-template-columns: var(--docs-nav-width) minmax(0, 1fr); }
  .docs-toc { display: none; }
}
@media (max-width: 760px) {
  .docs-header-inner { padding: 0 var(--space-4); gap: var(--space-3); }
  .docs-header-link, .docs-search-key { display: none; }
  .wordmark-name { font-size: var(--text-lg); }
  .docs-search { width: auto; flex: 1; }
  .docs-layout { display: block; padding: 0 var(--space-4); }
  .docs-nav { position: static; max-height: none; padding: var(--space-4) 0 0; border-bottom: 1px solid var(--border); padding-bottom: var(--space-4); }
  .docs-nav-toggle:not([hidden]) { display: inline-flex; }
  .docs-nav-toggle + .docs-nav-groups { margin-top: var(--space-4); }
  .docs-nav-toggle[aria-expanded="false"] + .docs-nav-groups { display: none; }
  .docs-main { padding-top: var(--space-6); }
  .prose h1 { font-size: var(--text-4xl); }
  .prose h2 { font-size: var(--text-2xl); }
  .code-copy { opacity: 1; }
}
@media (min-width: 761px) {
  .docs-nav-toggle { display: none; }
}
@media print {
  .docs-header, .docs-nav, .docs-toc, .docs-pager, .code-copy { display: none; }
  .docs-layout { display: block; }
}
