/* Docs portal — sidebar + article, on the landing's theme tokens. */
.docs-shell {
  display: grid;
  grid-template-columns: 264px minmax(0, 1fr);
  max-width: 1180px;
  margin: 0 auto;
  min-height: 100vh;
}
.docs-side {
  position: sticky;
  top: 0;
  align-self: start;
  height: 100vh;
  overflow-y: auto;
  /* Generous bottom padding so the last nav item can scroll clear of Chrome's hover
     link-preview overlay (bottom-left of the viewport), which otherwise hides it. */
  padding: calc(20px + env(safe-area-inset-top)) 18px 72px;
  border-right: 1px solid var(--border);
  background: color-mix(in srgb, var(--panel) 55%, transparent);
}
.docs-home {
  display: inline-flex;
  align-items: center;
  gap: 8px;
  font-weight: 800;
  font-size: 18px;
  color: var(--text-primary);
  text-decoration: none;
  margin-bottom: 14px;
}
.docs-home .mark {
  width: 22px;
  height: 22px;
  display: inline-block;
  background: url("../assets/sun_logo.svg") center/contain no-repeat;
}
/* mobile-only chrome — hidden on desktop (the sidebar is always visible there) */
.docs-mobilebar,
.docs-navClose,
.docs-scrim {
  display: none;
}
/* search — client-side over docs/index.json (same corpus the MCP indexes). Lives in the main
   column (wide + prominent), not the narrow sidebar. */
.docs-search {
  position: relative;
  max-width: 780px;
  margin: 0 0 24px;
}
.docs-searchInput {
  width: 100%;
  box-sizing: border-box;
  padding: 12px 16px;
  font-size: 15px;
  font-family: inherit;
  color: var(--text-primary);
  background: var(--bg);
  border: 1px solid var(--border);
  border-radius: 12px;
  outline: none;
}
.docs-searchInput:focus {
  border-color: color-mix(in srgb, var(--consensus) 55%, var(--border));
}
.docs-searchInput::placeholder {
  color: var(--text-secondary);
}
.docs-searchResults {
  position: absolute;
  top: calc(100% + 6px);
  left: 0;
  right: 0;
  z-index: 20;
  max-height: min(60vh, 420px);
  overflow-y: auto;
  background: var(--panel);
  border: 1px solid var(--border);
  border-radius: 11px;
  box-shadow: 0 18px 44px rgba(0, 0, 0, 0.28);
  padding: 6px;
}
.docs-searchHit {
  display: block;
  padding: 8px 10px;
  border-radius: 8px;
  text-decoration: none;
  border: none !important;
}
.docs-searchHit:hover,
.docs-searchHit.active {
  background: var(--bg);
}
.docs-searchHitTitle {
  display: block;
  font-size: 13.5px;
  font-weight: 600;
  color: var(--text-primary);
}
.docs-searchHitMeta {
  display: block;
  font-family: var(--font-mono);
  font-size: 10.5px;
  letter-spacing: 0.02em;
  color: var(--consensus);
  margin-top: 1px;
}
.docs-searchHitSnip {
  display: block;
  font-size: 12px;
  line-height: 1.4;
  color: var(--text-secondary);
  margin-top: 3px;
  /* clamp the preview to two lines so a long hit doesn't dominate the list */
  display: -webkit-box;
  -webkit-line-clamp: 2;
  -webkit-box-orient: vertical;
  overflow: hidden;
}
.docs-searchEmpty {
  padding: 10px;
  font-size: 12.5px;
  color: var(--text-secondary);
}
.docs-picker {
  display: flex;
  align-items: center;
  gap: 8px;
  margin-bottom: 16px;
  font-family: var(--font-mono);
  font-size: 12px;
}
.docs-src {
  color: var(--text-primary);
  font-weight: 700;
}
.docs-ver,
.docs-ver-static {
  color: var(--consensus);
  background: color-mix(in srgb, var(--consensus) 12%, transparent);
  border: 1px solid color-mix(in srgb, var(--consensus) 30%, var(--border));
  border-radius: 999px;
  padding: 2px 9px;
  font-size: 11px;
}
.docs-ver {
  cursor: pointer;
}
.docs-src-group {
  margin-top: 18px;
  padding-top: 14px;
  border-top: 1px solid var(--border);
}
.docs-src-group:first-child {
  margin-top: 0;
  padding-top: 0;
  border-top: none;
}
.docs-src-head {
  display: flex;
  align-items: center;
  justify-content: space-between;
  gap: 8px;
  margin-bottom: 6px;
  font-family: var(--font-mono);
  font-size: 13px;
  font-weight: 700;
  letter-spacing: 0.02em;
  color: var(--text-primary);
}
.docs-nav .docs-sec {
  margin-bottom: 8px;
  padding-left: 10px;
  border-left: 1px solid var(--border);
}
.docs-nav h4 {
  font-family: var(--font-mono);
  font-size: 11px;
  letter-spacing: 0.1em;
  text-transform: uppercase;
  color: var(--text-secondary);
  margin: 8px 0 2px;
}
.docs-nav a {
  display: block;
  padding: 2px 8px;
  margin-left: 10px;
  border-radius: 7px;
  font-size: 14px;
  color: var(--text-secondary);
  text-decoration: none;
  line-height: 1.3;
}
.docs-nav a:hover {
  background: var(--bg);
  color: var(--text-primary);
}
.docs-nav a.active {
  background: color-mix(in srgb, var(--consensus) 12%, transparent);
  color: var(--consensus);
  font-weight: 600;
}
/* nav_highlight: true — a page that should stand out in the sidebar (e.g. the Docs MCP server).
   Always-on accent tint + a leading dot, distinct from the transient hover/active states. */
.docs-nav a.docs-navHi {
  color: var(--consensus);
  font-weight: 600;
  background: color-mix(in srgb, var(--consensus) 8%, transparent);
}
.docs-nav a.docs-navHi::before {
  content: "●";
  font-size: 8px;
  vertical-align: 1.5px;
  margin-right: 6px;
  color: var(--consensus);
}
.docs-nav a.docs-navHi:hover {
  background: color-mix(in srgb, var(--consensus) 16%, transparent);
  color: var(--consensus);
}
.docs-main {
  padding: 40px clamp(20px, 5vw, 56px) 64px;
  min-width: 0;
}
.docs-actions {
  display: flex;
  justify-content: flex-end;
  max-width: 780px;
  margin: 0 0 10px;
}
.docs-copy {
  display: inline-flex;
  align-items: center;
  gap: 6px;
  padding: 5px 12px;
  border: 1px solid var(--border);
  border-radius: 999px;
  background: var(--panel);
  color: var(--text-secondary);
  font-family: var(--font-mono);
  font-size: 12px;
  cursor: pointer;
  transition:
    border-color 0.15s,
    color 0.15s,
    background 0.15s;
}
.docs-copy:hover {
  border-color: color-mix(in srgb, var(--consensus) 45%, var(--border));
  color: var(--consensus);
  background: color-mix(in srgb, var(--consensus) 10%, var(--panel));
}
.docs-copy.ok {
  border-color: color-mix(in srgb, var(--consensus) 55%, var(--border));
  color: var(--consensus);
  background: color-mix(in srgb, var(--consensus) 16%, transparent);
}
.docs-article {
  max-width: 780px;
  min-width: 0;
  /* break only genuinely-unfittable tokens (long urls/patterns) — NOT normal words, so "string"
     never renders as "strin\ng". break-word won't split a word that otherwise fits. */
  overflow-wrap: break-word;
}
.docs-article code {
  overflow-wrap: break-word;
}
.docs-article h1 {
  font-size: clamp(30px, 5vw, 44px);
  font-weight: 800;
  letter-spacing: -0.8px;
  line-height: 1.08;
  margin: 0 0 14px;
}
.docs-article h2 {
  font-size: clamp(22px, 3.4vw, 30px);
  font-weight: 800;
  letter-spacing: -0.4px;
  margin: 44px 0 10px;
  padding-top: 8px;
  border-top: 1px solid var(--border);
}
.docs-article h3 {
  font-size: 19px;
  font-weight: 700;
  margin: 28px 0 8px;
}
.docs-article p,
.docs-article li {
  font-size: 16px;
  line-height: 1.68;
  color: var(--text-secondary);
}
/* breathing room between paragraphs + list items */
.docs-article p {
  margin: 0 0 16px;
}
.docs-article ul,
.docs-article ol {
  margin: 4px 0 18px;
  padding-left: 24px;
}
.docs-article li {
  margin: 6px 0;
  padding-left: 4px;
}
.docs-article li::marker {
  color: color-mix(in srgb, var(--consensus) 70%, var(--text-secondary));
}
.docs-article li > ul,
.docs-article li > ol {
  margin: 6px 0 6px;
}
.docs-article p strong,
.docs-article li strong {
  color: var(--text-primary);
  font-weight: 700;
}
.docs-article a {
  color: var(--consensus);
  text-decoration: none;
  border-bottom: 1px solid color-mix(in srgb, var(--consensus) 40%, transparent);
}
.docs-article a:hover {
  border-bottom-color: var(--consensus);
}
.docs-lede {
  font-size: 18px !important;
  color: var(--text-secondary);
  margin-bottom: 18px !important;
}
.docs-article code {
  font-family: var(--font-mono);
  font-size: 0.88em;
  background: color-mix(in srgb, var(--panel) 70%, transparent);
  border: 1px solid var(--border);
  border-radius: 5px;
  padding: 1px 5px;
}
.docs-article pre {
  position: relative;
  background: var(--panel);
  border: 1px solid var(--border);
  border-radius: 10px;
  padding: 14px 16px;
  overflow-x: auto;
  margin: 16px 0;
}
/* code-block copy button (top-right, appears on hover/focus) */
.docs-codeCopy {
  position: absolute;
  top: 8px;
  right: 8px;
  z-index: 2;
  padding: 4px 10px;
  border-radius: 7px;
  border: 1px solid var(--border);
  background: color-mix(in srgb, var(--panel) 88%, var(--bg));
  color: var(--text-secondary);
  font-family: var(--font-mono);
  font-size: 11px;
  cursor: pointer;
  opacity: 0;
  transition: opacity 0.15s ease;
}
/* ⛶ Fullscreen button — sits in the diagram wrapper (never inside the <pre>), reveals on hover */
.docs-mmFull {
  position: absolute;
  top: 8px;
  right: 8px;
  z-index: 2;
  padding: 4px 10px;
  border-radius: 7px;
  border: 1px solid var(--border);
  background: color-mix(in srgb, var(--panel) 88%, var(--bg));
  color: var(--text-secondary);
  font-family: var(--font-mono);
  font-size: 11px;
  cursor: pointer;
  opacity: 0;
  transition: opacity 0.15s ease;
}
.docs-article pre:hover .docs-codeCopy,
.docs-mmWrap:hover .docs-mmFull,
.docs-codeCopy:focus-visible,
.docs-mmFull:focus-visible {
  opacity: 1;
}
.docs-mmWrap {
  position: relative;
  margin: 16px 0;
}
.docs-mmWrap pre.mermaid {
  margin: 0;
}
.docs-codeCopy:hover,
.docs-mmFull:hover {
  color: var(--consensus);
  border-color: color-mix(in srgb, var(--consensus) 45%, var(--border));
}
.docs-codeCopy.ok {
  color: var(--consensus);
  border-color: color-mix(in srgb, var(--consensus) 55%, var(--border));
}
/* mermaid full-screen overlay — hidden by default; the [hidden] attr must win, so display is
   only set when NOT hidden (a bare `display:flex` would override [hidden] and show a blank modal). */
.docs-mmOverlay {
  display: none;
  position: fixed;
  inset: 0;
  z-index: 80;
  align-items: center;
  justify-content: center;
  padding: 4vmin;
  background: color-mix(in srgb, var(--bg) 92%, #000);
  backdrop-filter: blur(4px);
}
.docs-mmOverlay:not([hidden]) {
  display: flex;
}
.docs-mmStage {
  max-width: 96vw;
  max-height: 92vh;
  overflow: auto;
}
.docs-mmStage svg {
  display: block;
  height: auto;
  /* width is set inline (min(94vw,1400px)) so the viewBox scales the diagram up */
}
.docs-mmClose {
  position: absolute;
  top: 16px;
  right: 20px;
  width: 40px;
  height: 40px;
  border-radius: 999px;
  border: 1px solid var(--border);
  background: var(--panel);
  color: var(--text-primary);
  font-size: 18px;
  cursor: pointer;
}
.docs-article pre code {
  background: none;
  border: none;
  padding: 0;
  font-size: 13.5px;
  line-height: 1.6;
}
.docs-article pre.mermaid {
  border: none;
  text-align: center;
}
.docs-article table {
  width: 100%;
  border-collapse: collapse;
  margin: 18px 0;
  font-size: 14px;
  display: block;
  overflow-x: auto;
}
.docs-article th,
.docs-article td {
  border: 1px solid var(--border);
  padding: 8px 11px;
  text-align: left;
  vertical-align: top;
}
.docs-article th {
  background: color-mix(in srgb, var(--panel) 60%, transparent);
  font-weight: 700;
  color: var(--text-primary);
}
.docs-article blockquote {
  border-left: 3px solid color-mix(in srgb, var(--consensus) 55%, var(--border));
  margin: 16px 0;
  padding: 2px 0 2px 16px;
  color: var(--text-secondary);
}
.docs-article img {
  /* Cap on desktop — full-bleed screenshots were oversized; centre and give a click-to-zoom. */
  display: block;
  max-width: min(100%, 680px);
  height: auto;
  border-radius: 10px;
  border: 1px solid var(--border);
  margin: 16px auto;
  cursor: zoom-in;
}
/* Full-screen image viewer — reuses the mermaid overlay (.docs-mmOverlay/.docs-mmStage). */
.docs-mmStage img {
  max-width: min(94vw, 1400px);
  max-height: 90vh;
  height: auto;
  border-radius: 10px;
  cursor: zoom-out;
}
.docs-foot {
  display: flex;
  align-items: center;
  justify-content: space-between;
  gap: 12px;
  flex-wrap: wrap;
  margin-top: 48px;
  padding-top: 18px;
  border-top: 1px solid var(--border);
  font-family: var(--font-mono);
  font-size: 13px;
}
.docs-foot a {
  color: var(--consensus);
  text-decoration: none;
}
/* the app CTA is the funnel out of the docs — an accent pill. */
.docs-footApp {
  padding: 8px 16px;
  border-radius: 999px;
  background: color-mix(in srgb, var(--consensus) 14%, transparent);
  border: 1px solid color-mix(in srgb, var(--consensus) 40%, var(--border));
  font-weight: 700;
}
.docs-footApp:hover {
  background: color-mix(in srgb, var(--consensus) 22%, transparent);
}
/* home portal cards */
.docs-cards {
  display: grid;
  grid-template-columns: repeat(auto-fit, minmax(220px, 1fr));
  gap: 14px;
  margin-top: 22px;
}
.docs-card {
  display: block;
  padding: 18px;
  border: 1px solid var(--border);
  border-radius: 12px;
  background: color-mix(in srgb, var(--panel) 50%, transparent);
  text-decoration: none !important;
  border-bottom: 1px solid var(--border) !important;
}
.docs-card:hover {
  border-color: color-mix(in srgb, var(--consensus) 45%, var(--border));
}
.docs-card h3 {
  margin: 0 0 4px;
  color: var(--text-primary);
}
.docs-card p {
  margin: 0;
  font-size: 13px !important;
  color: var(--text-secondary);
}
.docs-list li {
  margin: 4px 0;
}
.docs-list .muted {
  color: var(--text-secondary);
  font-size: 0.92em;
}

/* mobile: a top bar with a clear "☰ Menu" button; the sidebar becomes a left slide-in DRAWER over
   a scrim (same feel as the main landing), and the content column takes the full width. */
@media (max-width: 820px) {
  .docs-shell {
    grid-template-columns: 1fr;
  }
  /* top bar: logo left, labeled menu button right — aligned. */
  .docs-mobilebar {
    display: flex;
    align-items: center;
    justify-content: space-between;
    gap: 10px;
    position: sticky;
    top: 0;
    z-index: 40;
    padding: 10px 16px calc(10px + env(safe-area-inset-top));
    background: var(--bg);
    border-bottom: 1px solid var(--border);
  }
  .docs-mobilebar .docs-home {
    margin-bottom: 0;
    font-size: 16px;
  }
  .docs-navOpen {
    display: inline-flex;
    align-items: center;
    gap: 6px;
    background: var(--panel);
    border: 1px solid var(--border);
    border-radius: 999px;
    color: var(--text-primary);
    font-family: inherit;
    font-size: 14px;
    font-weight: 600;
    padding: 8px 14px;
    cursor: pointer;
  }
  /* sidebar → off-canvas left drawer */
  .docs-side {
    position: fixed;
    top: 0;
    left: 0;
    bottom: 0;
    z-index: 60;
    width: min(320px, 84%);
    height: 100vh;
    transform: translateX(-100%);
    transition: transform 0.28s cubic-bezier(0.34, 1.4, 0.5, 1);
    border-right: 1px solid var(--border);
    background: var(--panel);
    padding: calc(16px + env(safe-area-inset-top)) 16px 24px;
    /* iOS: a position:fixed pane with overflow:auto under a body scroll-lock has no scroll context
       until the first touch ("tap once, then it scrolls"). Momentum scrolling + a contained
       overscroll give it one immediately; pan-y lets a vertical drag scroll even when it starts on
       a nav link (otherwise the tap-vs-scroll delay swallows the first drag). */
    -webkit-overflow-scrolling: touch;
    overscroll-behavior: contain;
    touch-action: pan-y;
  }
  /* Nav content clears the absolutely-positioned ✕ close button (the "Latest" version pill on the
     first source header otherwise sits under it). */
  .docs-side .docs-nav {
    margin-top: 30px;
  }
  .docs-nav a {
    touch-action: pan-y;
  }
  .docs-side.open {
    transform: none;
  }
  .docs-homeDesk {
    display: none; /* the mobile top bar already shows the logo */
  }
  .docs-navClose {
    display: inline-flex;
    position: absolute;
    top: calc(12px + env(safe-area-inset-top));
    right: 12px;
    background: none;
    border: none;
    color: var(--text-secondary);
    font-size: 20px;
    line-height: 1;
    padding: 6px;
    cursor: pointer;
  }
  .docs-scrim {
    display: block;
    position: fixed;
    inset: 0;
    z-index: 55;
    background: rgba(0, 0, 0, 0.45);
    opacity: 0;
    visibility: hidden;
    transition: opacity 0.28s ease, visibility 0.28s;
  }
  .docs-scrim.open {
    opacity: 1;
    visibility: visible;
  }
  .docs-main {
    padding: 20px 16px 56px;
  }
  .docs-search {
    max-width: none;
    margin-bottom: 18px;
  }
  .docs-searchResults {
    max-height: min(70vh, 460px);
  }
  .docs-nav a {
    padding: 8px; /* larger touch targets */
  }
  @media (prefers-reduced-motion: reduce) {
    .docs-side,
    .docs-scrim {
      transition: none;
    }
  }
}