/* ==========================================================================
   Bikeep Developer Guides — Styles
   Colors matched to RapidDoc theme:
     Nav BG:     #2F3A48
     Accent:     #AEFF00
     Hover BG:   #4F616B
     Text:       #333
     Font:       TTHoves family (via MyFontsWebfontsKit)
   ========================================================================== */

:root {
  --nav-bg: #2F3A48;
  --nav-text: #fff;
  --accent: #AEFF00;
  --hover-bg: #4F616B;
  --text: #333;
  --text-secondary: #666;
  --bg: #fff;
  --bg-secondary: #f7f8fa;
  --border: #e2e5e9;
  --code-bg: #f0f2f5;
  --font-family: "TTHoves-Regular", -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif;
  --font-family-medium: "TTHoves-Medium", -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif;
  --font-family-demibold: "TTHoves-DemiBold", -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif;
  --font-family-bold: "TTHoves-Bold", -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif;
  --heading-color: #1a2230;
  --font-mono: "SF Mono", "Fira Code", "Fira Mono", Menlo, Consolas, monospace;
  --content-max-width: 840px;
  --sidebar-width: 260px;

  /* Transition timing */
  --transition-fast: 0.15s;
  --transition-normal: 0.25s;

  /* Badge color families — used by method, status, security, and required badges */
  --badge-green-bg: #d4edda;   --badge-green-text: #155724;
  --badge-blue-bg: #cce5ff;    --badge-blue-text: #004085;
  --badge-yellow-bg: #fff3cd;  --badge-yellow-text: #856404;
  --badge-red-bg: #f8d7da;     --badge-red-text: #721c24;
}

html { scroll-behavior: smooth; }
@media (prefers-reduced-motion: reduce) { html { scroll-behavior: auto; } }
*, *::before, *::after { box-sizing: border-box; }
body { margin: 0; font-family: var(--font-family); color: var(--text); line-height: 1.65; background: var(--bg); }
a { color: var(--nav-bg); text-decoration: none; }
a:hover { text-decoration: underline; }

.site-header {
  background: var(--nav-bg);
  color: var(--nav-text);
  padding: 0 1.5rem 0 0;
  height: 56px;
  display: flex;
  align-items: center;
  position: sticky;
  top: 0;
  z-index: 100;

  & .header-inner {
    display: grid;
    grid-template-columns: var(--sidebar-width) 1fr auto;
    align-items: center;
    gap: 0 1rem;
    width: 100%;
  }

  & .logo-link {
    display: flex;
    align-items: center;
    gap: 0.75rem;
    color: var(--nav-text);
    position: relative;
    top: 1px;
    padding-left: 1.75rem;

    &:hover { text-decoration: none; opacity: 0.9; }
  }

  & .logo { height: 28px; }
  & .logo-text { display: none; }

  & .header-nav {
    display: flex;
    gap: 1.5rem;
    justify-self: center;

    & a {
      color: color-mix(in srgb, white 70%, transparent);
      font-size: 0.9rem;
      padding: 0.25rem 0;
      border-bottom: 2px solid transparent;
      transition: color var(--transition-fast), border-color var(--transition-fast);

      &:hover { color: var(--nav-text); text-decoration: none; }

      &.active {
        color: var(--nav-text);
        border-bottom-color: var(--accent);
      }
    }
  }
}

.page-layout {
  display: flex;
  min-height: calc(100vh - 56px - 60px);
}

.sidebar {
  width: var(--sidebar-width);
  min-width: var(--sidebar-width);
  background: var(--bg-secondary);
  border-right: 1px solid var(--border);
  padding: 1.5rem 0 2rem;
  position: sticky;
  top: 56px;
  height: calc(100vh - 56px);
  overflow-y: auto;
}
.sidebar::after {
  content: "";
  display: block;
  height: 2rem;
  margin-top: -2rem;
  background: linear-gradient(transparent, var(--bg-secondary));
  pointer-events: none;
}
.sidebar-nav { padding: 0 1rem 2.5rem; }
.nav-section { margin-bottom: 1.25rem; }
.nav-section-title {
  font-size: 0.75rem;
  font-family: var(--font-family-bold);
  text-transform: uppercase;
  letter-spacing: 0.05em;
  color: var(--text-secondary);
  padding: 0.25rem 0.75rem;
  margin-bottom: 0.25rem;
}
.nav-section-link {
  display: block;
  color: var(--text);
  font-size: 0.85rem;
  text-transform: uppercase;
  font-family: var(--font-family-bold);
  letter-spacing: 0.05em;
}
.nav-section-link:hover { text-decoration: none; color: var(--nav-bg); }
.nav-section ul {
  list-style: none;
  margin: 0;
  padding: 0;
}
.nav-section li a {
  display: block;
  padding: 0.3rem 0.75rem;
  font-size: 0.88rem;
  color: var(--text);
  border-radius: 0 4px 4px 0;
  border-left: 3px solid transparent;
  transition: background var(--transition-fast), padding-left var(--transition-fast), border-color var(--transition-fast);
}
.nav-section li a:hover {
  background: var(--border);
  text-decoration: none;
  padding-left: 0.85rem;
}
.nav-section li a.active {
  background: color-mix(in srgb, var(--nav-bg) 8%, transparent);
  color: var(--nav-bg);
  font-family: var(--font-family-demibold);
  border-left: 3px solid var(--accent);
}

/* ── Endpoint subnav (scroll-spy) ── */
.endpoint-subnav {
  list-style: none;
  margin: 0.25rem 0 0.25rem 0.5rem;
  padding: 0;
}
.endpoint-subnav-link {
  display: flex;
  align-items: baseline;
  gap: 0.5rem;
  padding: 0.2rem 0.5rem;
  font-size: 0.78rem;
  color: var(--text-secondary);
  text-decoration: none;
  border-left: 2px solid transparent;
  border-radius: 0 3px 3px 0;
  transition: background var(--transition-fast), color var(--transition-fast), border-color var(--transition-fast);
  min-width: 0;
}
.endpoint-subnav-link:hover {
  color: var(--text);
  background: color-mix(in srgb, var(--nav-bg) 5%, transparent);
  text-decoration: none;
}
.endpoint-subnav-link.active {
  color: var(--nav-bg);
  border-left-color: var(--accent);
  font-family: var(--font-family-demibold);
}
.endpoint-subnav-link .method-badge {
  font-size: 0.6rem;
  padding: 0.1em 0.35em;
  margin-right: 0.25rem;
  flex-shrink: 0;
  min-width: 3.5rem;
  text-align: center;
}
.endpoint-subnav-link span:last-child {
  font-size: 0.78rem;
  min-width: 0;
  display: -webkit-box;
  -webkit-line-clamp: 2;
  -webkit-box-orient: vertical;
  overflow: hidden;
}

.content {
  flex: 1;
  max-width: var(--content-max-width);
  padding: 2rem 3rem 3rem;
  margin: 0 auto;
}

.breadcrumbs {
  font-size: 0.82rem;
  color: var(--text-secondary);
  margin-bottom: 1.5rem;
}
.breadcrumbs a { color: var(--text-secondary); }
.breadcrumbs a:hover { color: var(--text); }
.breadcrumbs .sep { margin: 0 0.4rem; }

.guide-content h1 {
  font-size: 2rem;
  font-family: var(--font-family-bold);
  margin: 0 0 0.75rem;
  line-height: 1.2;
  color: var(--heading-color);
}
.guide-content h2 {
  font-size: 1.5rem;
  font-family: var(--font-family-bold);
  margin: 3.5rem 0 0.75rem;
  padding-bottom: 0.3rem;
  border-bottom: 1px solid var(--border);
  color: var(--heading-color);
  letter-spacing: -0.01em;
  scroll-margin-top: 72px;
}
.guide-content h3 {
  font-size: 1.15rem;
  font-family: var(--font-family-demibold);
  margin: 2.5rem 0 0.5rem;
  color: var(--heading-color);
  scroll-margin-top: 72px;
}
.guide-content h4 {
  font-size: 0.82rem;
  font-family: var(--font-family-bold);
  margin: 1.5rem 0 0.4rem;
  color: var(--text);
  text-transform: uppercase;
  letter-spacing: 0.04em;
}
.guide-content p { margin: 0 0 1.15rem; }
.guide-content > p:first-child,
.guide-content > h1 + p {
  font-size: 1.1rem;
  color: var(--text-secondary);
  line-height: 1.5;
}

.guide-content table {
  width: 100%;
  border-collapse: collapse;
  margin: 1rem 0 1.5rem;
  font-size: 0.9rem;
}
.guide-content th {
  text-align: left;
  padding: 0.65rem 0.85rem;
  background: var(--bg-secondary);
  color: var(--text-secondary);
  font-family: var(--font-family-demibold);
  font-size: 0.82rem;
  text-transform: uppercase;
  letter-spacing: 0.03em;
  border-bottom: 2px solid var(--border);
}
.guide-content td {
  padding: 0.65rem 0.85rem;
  border-bottom: 1px solid var(--border);
  vertical-align: top;
  transition: background var(--transition-fast);
}
.guide-content tr:hover td { background: var(--bg-secondary); }

.guide-content code {
  font-family: var(--font-mono);
  font-size: 0.85em;
  background: var(--code-bg);
  padding: 0.15em 0.4em;
  border-radius: 3px;
}
.guide-content pre {
  background: var(--nav-bg);
  color: #e6e8eb;
  padding: 1.25rem 1.5rem;
  border-radius: 8px;
  overflow-x: auto;
  margin: 1rem 0 1.5rem;
  font-size: 0.85rem;
  line-height: 1.5;
  box-shadow: 0 1px 3px rgba(0,0,0,0.08), 0 1px 2px rgba(0,0,0,0.06);
}
.guide-content pre code {
  background: none;
  padding: 0;
  color: inherit;
  font-size: inherit;
}

.guide-content ul, .guide-content ol {
  margin: 0 0 1rem;
  padding-left: 1.5rem;
}
.guide-content li { margin-bottom: 0.35rem; }
.guide-content li > ul,
.guide-content li > ol { margin-top: 0.35rem; margin-bottom: 0; }

/* Blockquotes (tips/notes) */
.guide-content blockquote {
  margin: 1rem 0 1.5rem;
  padding: 1rem 1.25rem;
  background: #f0f9e8;
  border-left: 4px solid var(--accent);
  border-radius: 0 6px 6px 0;
  color: var(--text);
}
.guide-content blockquote p:last-child { margin-bottom: 0; }

.guide-content .header-anchor {
  color: var(--border);
  margin-left: 0.3rem;
  font-weight: 400;
}
.guide-content .header-anchor:hover { color: var(--accent); text-decoration: none; }

.page-nav {
  display: flex;
  justify-content: space-between;
  margin-top: 3rem;
  padding-top: 1.5rem;
  border-top: 1px solid var(--border);
  gap: 1rem;
}
.page-nav-link {
  display: flex;
  flex-direction: column;
  padding: 0.75rem 1rem;
  border: 1px solid var(--border);
  border-radius: 6px;
  transition: border-color var(--transition-fast), box-shadow var(--transition-fast), transform var(--transition-fast);
  max-width: 50%;
}
.page-nav-link:hover {
  border-color: var(--nav-bg);
  text-decoration: none;
  box-shadow: 0 2px 8px rgba(0,0,0,0.08);
  transform: translateY(-1px);
}
.page-nav-link.next { margin-left: auto; text-align: right; }
.page-nav-label { font-size: 0.75rem; color: var(--text-secondary); text-transform: uppercase; letter-spacing: 0.05em; }
.page-nav-title { font-size: 0.95rem; color: var(--nav-bg); font-family: var(--font-family-demibold); }

.site-footer {
  background: var(--bg-secondary);
  border-top: 1px solid var(--border);
  padding: 1rem 1.5rem;
  text-align: center;
  font-size: 0.82rem;
  color: var(--text-secondary);
}
.footer-inner { max-width: 1200px; margin: 0 auto; }
.site-footer a { color: var(--text-secondary); }
.site-footer a:hover { color: var(--text); }

/* ==========================================================================
   API Reference — Component Styles
   ========================================================================== */

/* Wide content layout for reference pages */
.content-wide { --content-max-width: 1060px; }

/* ── Method badges ── */
.method-badge {
  display: inline-block;
  padding: 0.2em 0.55em;
  font-size: 0.72rem;
  font-weight: 700;
  text-transform: uppercase;
  letter-spacing: 0.04em;
  border-radius: 4px;
  font-family: var(--font-mono);
  line-height: 1.4;
}
.method-get    { background: var(--badge-green-bg); color: var(--badge-green-text); }
.method-post   { background: var(--badge-blue-bg); color: var(--badge-blue-text); }
.method-patch  { background: var(--badge-yellow-bg); color: var(--badge-yellow-text); }
.method-put    { background: var(--badge-yellow-bg); color: var(--badge-yellow-text); }
.method-delete { background: var(--badge-red-bg); color: var(--badge-red-text); }

/* ── Security badges ── */
.security-badge {
  display: inline-block;
  padding: 0.2em 0.55em;
  font-size: 0.72rem;
  font-family: var(--font-family-demibold);
  border-radius: 4px;
  white-space: nowrap;
}
.security-auth   { background: var(--badge-yellow-bg); color: var(--badge-yellow-text); }
.security-public { background: var(--badge-green-bg); color: var(--badge-green-text); }

/* ── Required badge ── */
.required-badge {
  display: inline-block;
  padding: 0.1em 0.35em;
  font-size: 0.68rem;
  font-family: var(--font-family-demibold);
  background: var(--badge-red-bg);
  color: var(--badge-red-text);
  border-radius: 2px;
  vertical-align: middle;
  margin-left: 0.3em;
}

/* ── Deprecated badge ── */
.deprecated-badge {
  display: inline-block;
  padding: 0.1em 0.35em;
  font-size: 0.68rem;
  font-family: var(--font-family-demibold);
  background: var(--badge-yellow-bg);
  color: var(--badge-yellow-text);
  border-radius: 2px;
  vertical-align: middle;
  margin-left: 0.3em;
}
.deprecated-badge-small {
  font-size: 0.62rem;
  margin-left: 0.4em;
}

/* ── Deprecated schema property (dimmed) ── */
.schema-prop-deprecated > .schema-prop-row {
  opacity: 0.55;
}
.schema-prop-deprecated > .schema-prop-row:hover {
  opacity: 0.8;
}

/* ── Deprecated endpoint section (dimmed) ── */
.endpoint-deprecated {
  opacity: 0.55;
}
.endpoint-deprecated:hover {
  opacity: 0.8;
}

/* ── Deprecated endpoint in TOC ── */
.endpoint-toc-deprecated {
  opacity: 0.55;
}
.endpoint-toc-deprecated:hover {
  opacity: 0.8;
}

/* ── Endpoint TOC ── */
.endpoint-toc {
  background: var(--bg-secondary);
  border: 1px solid var(--border);
  border-radius: 6px;
  padding: 1.25rem 1.5rem;
  margin: 1.5rem 0 2rem;
}
.endpoint-toc h2 {
  font-size: 0.85rem;
  text-transform: uppercase;
  letter-spacing: 0.05em;
  color: var(--text-secondary);
  margin: 0 0 0.75rem;
  padding: 0;
  border: none;
}
.endpoint-toc-item {
  display: flex;
  align-items: flex-start;
  gap: 0.6rem;
  padding: 0.35rem 0.5rem;
  margin: 0 -0.5rem;
  color: var(--text);
  text-decoration: none;
  border-radius: 4px;
  transition: background var(--transition-fast);
}
.endpoint-toc-item .method-badge { margin-top: 0.15em; min-width: 4.2rem; text-align: center; }
.endpoint-toc-item:hover {
  color: var(--nav-bg);
  text-decoration: none;
  background: color-mix(in srgb, var(--nav-bg) 5%, transparent);
}
.endpoint-toc-item code {
  font-size: 0.85rem;
  background: none;
  padding: 0;
}
.endpoint-toc-detail {
  display: flex;
  flex-direction: column;
  gap: 0.1rem;
}
.endpoint-toc-path {
  display: flex;
  align-items: center;
  gap: 0.4rem;
}
.endpoint-toc-summary {
  font-size: 0.78rem;
  color: var(--text-secondary);
  line-height: 1.3;
}

/* ── Endpoint sections ── */
.endpoint-section {
  padding: 2.5rem 0 2rem;
  border-top: 3px solid var(--border);
  scroll-margin-top: 64px;

  &:first-of-type { border-top: none; }

  &:nth-of-type(even) {
    background: color-mix(in srgb, var(--bg-secondary) 40%, transparent);
    margin: 0 -1.5rem;
    padding-left: 1.5rem;
    padding-right: 1.5rem;
    border-radius: 4px;
  }

  & .endpoint-header {
    display: flex;
    align-items: center;
    justify-content: space-between;
    gap: 1rem;
    flex-wrap: wrap;
    margin-bottom: 0.75rem;

    &:hover .deep-link-btn { opacity: 1; }
  }

  & .endpoint-method-path {
    display: flex;
    align-items: center;
    gap: 0.6rem;
  }

  & .endpoint-path {
    font-size: 1.05rem;
    font-family: var(--font-family-demibold);
    background: var(--code-bg);
    padding: 0.15em 0.5em;
    border-radius: 4px;
    color: var(--text);
  }

  /* ── Endpoint header actions (security badge + deep link) ── */
  & .endpoint-header-actions {
    display: flex;
    align-items: center;
    gap: 0.5rem;
  }

  & .deep-link-btn {
    display: flex;
    align-items: center;
    justify-content: center;
    width: 28px;
    height: 28px;
    padding: 0;
    background: transparent;
    color: var(--text-secondary);
    border: 1px solid transparent;
    border-radius: 4px;
    cursor: pointer;
    opacity: 0;
    transition: opacity var(--transition-fast), background var(--transition-fast), color var(--transition-fast), border-color var(--transition-fast);

    &:hover {
      background: var(--bg-secondary);
      border-color: var(--border);
      color: var(--text);
    }

    &:focus-visible {
      opacity: 1;
      outline: 2px solid var(--accent);
      outline-offset: 1px;
    }

    &.copied {
      opacity: 1;
      color: var(--accent);
      border-color: var(--accent);
    }
  }
}

/* ── Parameter tables ── */
.param-table {
  width: 100%;
  border-collapse: collapse;
  margin: 0.75rem 0 1rem;
  font-size: 0.88rem;
}
.param-table th {
  text-align: left;
  padding: 0.5rem 0.6rem;
  background: var(--bg-secondary);
  color: var(--text-secondary);
  font-family: var(--font-family-demibold);
  font-size: 0.78rem;
  text-transform: uppercase;
  letter-spacing: 0.03em;
  border-bottom: 2px solid var(--border);
}
.param-table td {
  padding: 0.55rem 0.75rem;
  border-bottom: 1px solid var(--border);
  vertical-align: top;
  transition: background var(--transition-fast);
}
.param-table tr:hover td {
  background: color-mix(in srgb, var(--accent) 4%, transparent);
}

/* ── Schema fields (nested div layout) ── */
.schema-fields {
  margin: 0.75rem 0 1rem;
  font-size: 0.88rem;

  & .schema-prop-row {
    display: block;
    padding: 0.65rem 0.75rem;
    border-bottom: 1px solid var(--border);
    transition: background var(--transition-fast);

    &:hover {
      background: color-mix(in srgb, var(--accent) 4%, transparent);
    }
  }

  & .schema-prop-header {
    display: flex;
    flex-wrap: wrap;
    align-items: baseline;
    gap: 0.4em;
    line-height: 1.5;

    & > code {
      font-family: var(--font-mono);
      font-weight: 600;
      font-size: 0.88rem;
    }
  }

  & .schema-prop-desc {
    margin-top: 0.2rem;
    font-size: 0.86rem;
    color: var(--text-secondary);
    line-height: 1.5;

    & > p:first-child { margin-top: 0; }
    & > p:last-child  { margin-bottom: 0; }

    & ul, & ol { margin: 0.3rem 0; padding-left: 1.4em; }
    & li { margin: 0.15rem 0; }
  }

  & .schema-children {
    margin: 0.4rem 0.6rem 0.4rem 1.2rem;
    padding: 0.25rem 0;
    border: 1px solid var(--border);
    border-left: 3px solid color-mix(in srgb, var(--nav-bg) 45%, transparent);
    border-radius: 6px;
    background: color-mix(in srgb, var(--nav-bg) 3%, transparent);

    /* Alternate backgrounds at even nesting levels */
    & .schema-children {
      background: var(--bg-secondary);

      & .schema-children {
        background: color-mix(in srgb, var(--nav-bg) 3%, transparent);
      }
    }

    & > .schema-prop:last-child > .schema-prop-row {
      border-bottom: none;
    }
  }
}

.prop-type {
  font-family: var(--font-mono);
  font-size: 0.8rem;
  color: var(--text-secondary);
}

/* ── Enum badges ── */
.enum-badges-inline {
  display: inline-flex;
  flex-wrap: wrap;
  gap: 0.3em;
  margin-left: 0.3em;
  vertical-align: baseline;
}
.enum-badge {
  display: inline-block;
  font-family: var(--font-mono);
  font-size: 0.72rem;
  background: var(--code-bg);
  color: var(--text-secondary);
  border: 1px solid var(--border);
  border-radius: 3px;
  padding: 0.1em 0.35em;
  white-space: nowrap;
}

/* ── Response tabs ── */
.response-tabs {
  margin: 0.5rem 0 1rem;
}
.response-tabs-bar {
  display: flex;
  flex-wrap: wrap;
  gap: 0.5rem;
  border-bottom: 2px solid var(--border);
  padding-bottom: 0.5rem;
}
.response-tab {
  cursor: pointer;
  border: 2px solid transparent;
  opacity: 0.6;
  transition: opacity var(--transition-fast), border-color var(--transition-fast), box-shadow var(--transition-fast);
}
.response-tab.active {
  opacity: 1;
  border-color: currentColor;
}
.response-tab:hover {
  opacity: 0.85;
}
.response-desc {
  color: var(--text-secondary);
  font-size: 0.88rem;
  margin: 0.5rem 0;
}

/* Status code badges */
.status-badge {
  display: inline-block;
  padding: 0.2em 0.55em;
  font-size: 0.78rem;
  font-weight: 700;
  font-family: var(--font-mono);
  border-radius: 4px;
}
.status-2xx { background: var(--badge-green-bg); color: var(--badge-green-text); }
.status-3xx { background: var(--badge-blue-bg); color: var(--badge-blue-text); }
.status-4xx { background: var(--badge-yellow-bg); color: var(--badge-yellow-text); }
.status-5xx { background: var(--badge-red-bg); color: var(--badge-red-text); }

/* Lead paragraph for tag descriptions */
.lead {
  font-size: 1.05rem;
  color: var(--text-secondary);
  line-height: 1.5;
  margin-bottom: 1rem;
}

/* ── Code block wrapper, copy button, language label ── */
.code-block-wrapper {
  position: relative;
}
.code-lang-label {
  position: absolute;
  top: 0.5rem;
  left: 1rem;
  font-size: 0.65rem;
  letter-spacing: 0.06em;
  text-transform: uppercase;
  color: color-mix(in srgb, white 35%, transparent);
  pointer-events: none;
  font-family: var(--font-mono);
  font-weight: 700;
}
.copy-btn {
  position: absolute;
  top: 0.5rem;
  right: 0.5rem;
  padding: 0.25rem 0.6rem;
  font-size: 0.72rem;
  font-family: var(--font-family);
  background: color-mix(in srgb, white 15%, transparent);
  color: color-mix(in srgb, white 70%, transparent);
  border: 1px solid color-mix(in srgb, white 20%, transparent);
  border-radius: 4px;
  cursor: pointer;
  opacity: 0;
  transition: opacity var(--transition-fast), background var(--transition-fast), color var(--transition-fast);
}
.code-block-wrapper:hover .copy-btn { opacity: 1; }
.copy-btn:hover {
  background: color-mix(in srgb, white 20%, transparent);
  color: color-mix(in srgb, white 90%, transparent);
}
.copy-btn.copied {
  background: var(--accent);
  color: var(--nav-bg);
  border-color: var(--accent);
  opacity: 1;
}

/* ── Endpoint path copy button ── */
.path-copy-btn {
  display: inline-block;
  margin-left: 0.4rem;
  padding: 0.1rem 0.3rem;
  font-size: 0.72rem;
  background: transparent;
  color: var(--text-secondary);
  border: 1px solid transparent;
  border-radius: 3px;
  cursor: pointer;
  opacity: 0;
  transition: opacity var(--transition-fast), background var(--transition-fast);
  vertical-align: middle;
  line-height: 1;
  font-family: var(--font-mono);
}
.endpoint-method-path:hover .path-copy-btn { opacity: 1; }
.path-copy-btn:hover {
  background: var(--bg-secondary);
  border-color: var(--border);
}

/* ── Endpoint sub-section cards ── */
.endpoint-params,
.endpoint-request-body,
.endpoint-responses,
.endpoint-example {
  margin-top: 1.5rem;
  padding: 1.25rem 1.5rem;
  background: var(--bg-secondary);
  border: 1px solid var(--border);
  border-radius: 8px;
}
.endpoint-params h4,
.endpoint-request-body h4,
.endpoint-responses h4,
.endpoint-example h4 {
  margin-top: 0;
}
.endpoint-responses {
  border-left: 3px solid var(--accent);
}
.endpoint-example {
  background: transparent;
  border: none;
  padding: 0;
}

/* ── Back to top button ── */
.back-to-top {
  position: fixed;
  bottom: 2rem;
  right: 2rem;
  z-index: 90;
  width: 42px;
  height: 42px;
  display: flex;
  align-items: center;
  justify-content: center;
  background: var(--nav-bg);
  color: #fff;
  border: none;
  border-radius: 50%;
  cursor: pointer;
  box-shadow: 0 2px 8px rgba(0,0,0,0.18);
  opacity: 0;
  transform: translateY(12px);
  pointer-events: none;
  transition: opacity var(--transition-normal), transform var(--transition-normal), background var(--transition-fast);
}
.back-to-top.visible {
  opacity: 1;
  transform: translateY(0);
  pointer-events: auto;
}
.back-to-top:hover {
  background: var(--hover-bg);
}
.back-to-top:focus-visible {
  outline: 2px solid var(--accent);
  outline-offset: 2px;
}
@media (prefers-reduced-motion: reduce) {
  .back-to-top { transition: none; }
}

/* All header icon buttons share size, shape, and hover/focus states */
.header-icon-btn {
  display: flex;
  align-items: center;
  justify-content: center;
  height: 36px;
  padding: 0;
  background: transparent;
  border: 1px solid transparent;
  border-radius: 6px;
  cursor: pointer;
  color: var(--nav-text);
  transition: background var(--transition-fast), border-color var(--transition-fast);
}
.header-icon-btn:hover {
  background: color-mix(in srgb, white 10%, transparent);
  border-color: color-mix(in srgb, white 20%, transparent);
}
.header-icon-btn:focus-visible {
  outline: 2px solid var(--accent);
  outline-offset: 2px;
}

/* ==========================================================================
   Hamburger Button & Mobile Drawer
   ========================================================================== */

.hamburger-btn {
  display: none;
  width: 36px;
}

.nav-backdrop {
  display: none;
  position: fixed;
  inset: 0;
  top: 56px;
  z-index: 140;
  background: rgba(0,0,0,0.5);
  opacity: 0;
  transition: opacity var(--transition-normal);
}
body.nav-open .nav-backdrop {
  display: block;
  opacity: 1;
}

/* Body scroll lock when nav is open */
body.nav-open {
  overflow: hidden;
}

@media (max-width: 768px) {
  .hamburger-btn { display: flex; }
}

@media (prefers-reduced-motion: reduce) {
  .nav-backdrop { transition: none; }
}

/* ==========================================================================
   Header Actions (search + theme toggle group)
   ========================================================================== */

.header-actions {
  display: flex;
  align-items: center;
  gap: 0.5rem;
  justify-self: end;
}

/* ── Sidebar Toggle Button (desktop only) ── */
.sidebar-toggle-btn {
  display: none;
  width: 36px;
}
@media (min-width: 769px) {
  .sidebar-toggle-btn { display: flex; }
}

/* ── Sidebar-hidden state (desktop) ── */
.sidebar-hidden .sidebar {
  display: none;
}
.sidebar-hidden .header-inner {
  grid-template-columns: auto 1fr auto;
}
.sidebar-hidden .logo-link {
  padding-left: 1.5rem;
}

/* ==========================================================================
   Search Trigger Button
   ========================================================================== */

.search-trigger {
  gap: 0.4rem;
  padding: 0 0.7rem;
  color: color-mix(in srgb, white 70%, transparent);
  font-family: var(--font-family);
  font-size: 0.82rem;
  transition: background var(--transition-fast), border-color var(--transition-fast), color var(--transition-fast);
}
.search-trigger:hover {
  color: var(--nav-text);
}
.search-trigger-text {
  font-size: 0.82rem;
}
.search-trigger-kbd {
  display: inline-block;
  padding: 0.05em 0.4em;
  font-family: var(--font-mono);
  font-size: 0.72rem;
  background: rgba(255,255,255,0.12);
  border: 1px solid color-mix(in srgb, white 20%, transparent);
  border-radius: 3px;
  color: rgba(255,255,255,0.5);
  margin-left: 0.25rem;
}

@media (max-width: 768px) {
  .search-trigger-text,
  .search-trigger-kbd { display: none; }
  .search-trigger {
    width: 36px;
    height: 36px;
    padding: 0;
    justify-content: center;
    background: transparent;
    border-color: transparent;
  }
}

/* ==========================================================================
   Search Modal
   ========================================================================== */

.search-modal {
  position: fixed;
  inset: 0;
  z-index: 200;
  display: flex;
  align-items: flex-start;
  justify-content: center;
  padding-top: 12vh;
  background: rgba(0,0,0,0.6);
  animation: searchOverlayIn 0.18s ease;

  &[hidden] { display: none; }

  & .search-modal-inner {
    width: 100%;
    max-width: 580px;
    background: var(--bg);
    border-radius: 14px;
    box-shadow:
      0 0 0 1px rgba(0,0,0,0.05),
      0 4px 12px rgba(0,0,0,0.08),
      0 20px 60px rgba(0,0,0,0.18);
    overflow: hidden;
    display: flex;
    flex-direction: column;
    animation: searchModalIn 0.2s cubic-bezier(0.16, 1, 0.3, 1);
  }

  /* ── Search input area ── */
  & .search-input-wrap {
    display: flex;
    align-items: center;
    gap: 0.65rem;
    padding: 0.9rem 1.15rem;
    border-bottom: 1px solid var(--border);

    &:focus-within .search-icon {
      opacity: 1;
      color: var(--text);
    }
  }

  & .search-icon {
    color: var(--text-secondary);
    flex-shrink: 0;
    opacity: 0.7;
    transition: opacity var(--transition-fast), color var(--transition-fast);
  }

  & .search-input {
    flex: 1;
    border: none;
    outline: none;
    background: none;
    font-family: var(--font-family);
    font-size: 1rem;
    color: var(--text);
    min-width: 0;

    &::placeholder {
      color: var(--text-secondary);
      opacity: 0.5;
    }

    /* Override the default accent focus ring for the search input */
    &:focus-visible {
      outline: none;
    }

    &:focus ~ .search-icon {
      opacity: 1;
      color: var(--text);
    }
  }

  & .search-close-btn {
    font-family: var(--font-mono);
    font-size: 0.68rem;
    padding: 0.2em 0.45em;
    background: var(--bg-secondary);
    border: 1px solid var(--border);
    border-radius: 4px;
    color: var(--text-secondary);
    flex-shrink: 0;
    cursor: pointer;
    line-height: 1;
    transition: background var(--transition-fast), color var(--transition-fast), border-color var(--transition-fast);

    &:hover {
      background: var(--border);
      color: var(--text);
    }

    &:focus-visible {
      outline: 2px solid var(--accent);
      outline-offset: 2px;
    }
  }

  & .search-close-x {
    display: none;
  }

  /* ── Search results ── */
  & .search-results {
    max-height: 45vh;
    overflow-y: auto;
    padding: 0.35rem 0;
    scroll-behavior: smooth;
    overscroll-behavior: contain;

    /* Scrollbar styling */
    &::-webkit-scrollbar {
      width: 6px;
    }

    &::-webkit-scrollbar-track {
      background: transparent;
    }

    &::-webkit-scrollbar-thumb {
      background: var(--border);
      border-radius: 3px;

      &:hover {
        background: var(--text-secondary);
      }
    }

    /* Empty state */
    &:empty {
      display: flex;
      flex-direction: column;
      align-items: center;
      justify-content: center;
      padding: 2rem 1.5rem 1.75rem;
      gap: 0.5rem;

      &::before {
        content: "";
        display: block;
        width: 40px;
        height: 40px;
        opacity: 0.18;
        background-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' fill='none' stroke='%23666' stroke-width='1.5' stroke-linecap='round' stroke-linejoin='round'%3E%3Ccircle cx='11' cy='11' r='8'/%3E%3Cline x1='21' y1='21' x2='16.65' y2='16.65'/%3E%3C/svg%3E");
        background-size: contain;
        background-repeat: no-repeat;
      }

      &::after {
        content: "Search guides, endpoints, and concepts";
        display: block;
        text-align: center;
        color: var(--text-secondary);
        font-size: 0.85rem;
        opacity: 0.6;
      }
    }
  }

  /* ── Group titles ── */
  & .search-group-title {
    display: flex;
    align-items: center;
    gap: 0.5rem;
    padding: 0.65rem 1.15rem 0.3rem;
    font-size: 0.68rem;
    font-family: var(--font-family-bold);
    text-transform: uppercase;
    letter-spacing: 0.06em;
    color: var(--text-secondary);
    opacity: 0.65;

    &::after {
      content: "";
      flex: 1;
      height: 1px;
      background: var(--border);
      opacity: 0.6;
    }
  }

  /* ── Result items ── */
  & .search-result-item {
    display: flex;
    align-items: flex-start;
    gap: 0.7rem;
    padding: 0.6rem 1.15rem;
    margin: 0 0.4rem;
    border-radius: 8px;
    color: var(--text);
    text-decoration: none;
    transition: background 0.1s;
    cursor: pointer;

    &:hover {
      background: var(--bg-secondary);
      text-decoration: none;
    }

    &.active {
      background: var(--bg-secondary);
      text-decoration: none;
      box-shadow: inset 3px 0 0 var(--accent);

      & .search-result-icon {
        background: var(--border);
        color: var(--text);
      }

      & .search-result-enter {
        opacity: 0.5;
      }
    }

    &:hover .search-result-icon {
      background: var(--border);
      color: var(--text);
    }
  }

  & .search-result-icon {
    flex-shrink: 0;
    width: 28px;
    height: 28px;
    display: flex;
    align-items: center;
    justify-content: center;
    border-radius: 6px;
    background: var(--bg-secondary);
    color: var(--text-secondary);
    margin-top: 0.05rem;
    transition: background 0.1s, color 0.1s;

    & svg {
      width: 14px;
      height: 14px;
    }

    /* Endpoint icon uses method-specific color */
    &.icon-endpoint {
      background: color-mix(in srgb, var(--nav-bg) 8%, transparent);
      color: var(--nav-bg);
    }
  }

  & .search-result-body {
    flex: 1;
    min-width: 0;
  }

  & .search-result-title {
    font-family: var(--font-family-medium);
    font-size: 0.88rem;
    line-height: 1.35;
    display: flex;
    align-items: center;
    gap: 0.4rem;
    flex-wrap: wrap;

    & mark {
      background: color-mix(in srgb, var(--accent) 25%, transparent);
      color: inherit;
      border-radius: 2px;
      padding: 0 1px;
    }
  }

  & .search-result-method {
    display: inline-block;
    padding: 0.1em 0.4em;
    font-size: 0.62rem;
    font-weight: 700;
    text-transform: uppercase;
    letter-spacing: 0.03em;
    border-radius: 3px;
    font-family: var(--font-mono);
    line-height: 1.4;
    flex-shrink: 0;
  }

  & .search-result-desc {
    font-size: 0.78rem;
    color: var(--text-secondary);
    margin-top: 0.15rem;
    line-height: 1.4;
    white-space: nowrap;
    overflow: hidden;
    text-overflow: ellipsis;

    & mark {
      background: color-mix(in srgb, var(--accent) 15%, transparent);
      color: inherit;
      border-radius: 2px;
      padding: 0 1px;
    }
  }

  & .search-result-enter {
    flex-shrink: 0;
    align-self: center;
    color: var(--text-secondary);
    opacity: 0;
    transition: opacity 0.1s;

    & svg {
      width: 14px;
      height: 14px;
    }
  }
}
@keyframes searchOverlayIn {
  from { opacity: 0; }
  to { opacity: 1; }
}
@keyframes searchModalIn {
  from { opacity: 0; transform: translateY(-12px) scale(0.97); }
  to { opacity: 1; transform: translateY(0) scale(1); }
}
@media (prefers-reduced-motion: reduce) {
  .search-modal { animation: none; }
  .search-modal-inner { animation: none; }
}

/* ── No results (inside .search-modal) ── */
.search-no-results {
  display: flex;
  flex-direction: column;
  align-items: center;
  gap: 0.35rem;
  padding: 2rem 1.5rem;
  text-align: center;

  & .search-no-results-text {
    color: var(--text-secondary);
    font-size: 0.88rem;
  }

  & .search-no-results-hint {
    color: var(--text-secondary);
    font-size: 0.78rem;
    opacity: 0.6;
  }
}

/* ── Search footer ── */
.search-footer {
  display: flex;
  align-items: center;
  justify-content: space-between;
  padding: 0.55rem 1.15rem;
  border-top: 1px solid var(--border);
  background: var(--bg-secondary);
  flex-shrink: 0;

  & .search-footer-hints {
    display: flex;
    gap: 0.85rem;
  }

  & .search-hint {
    display: flex;
    align-items: center;
    gap: 0.3rem;
    font-size: 0.72rem;
    color: var(--text-secondary);
    opacity: 0.6;

    & kbd {
      display: inline-flex;
      align-items: center;
      justify-content: center;
      min-width: 1.3em;
      height: 1.3em;
      padding: 0 0.25em;
      font-family: var(--font-mono);
      font-size: 0.68rem;
      background: var(--bg);
      border: 1px solid var(--border);
      border-radius: 3px;
      line-height: 1;
    }
  }

  & .search-footer-powered {
    font-size: 0.65rem;
    color: var(--text-secondary);
    opacity: 0.4;
  }
}

/* ── Mobile search ── */
@media (max-width: 768px) {
  .search-modal {
    padding-top: 0;
    align-items: stretch;
    background: rgba(0,0,0,0.7);
  }
  .search-modal-inner {
    max-width: none;
    border-radius: 0;
    height: 100%;
    max-height: none;
    animation: searchModalInMobile 0.2s cubic-bezier(0.16, 1, 0.3, 1);
  }
  @keyframes searchModalInMobile {
    from { opacity: 0; transform: translateY(-20px); }
    to { opacity: 1; transform: translateY(0); }
  }
  .search-results {
    max-height: none;
    flex: 1;
    overflow-y: auto;
  }
  .search-close-esc { display: none; }
  .search-close-x { display: inline; }
  .search-close-btn {
    min-width: 44px;
    min-height: 44px;
    align-self: stretch;
    font-size: 1.3rem;
    display: flex;
    align-items: center;
    justify-content: center;
    border-radius: 8px;
  }
  .search-footer-hints { display: none; }
  .search-footer-powered { margin-left: auto; }
  .search-result-enter { display: none; }
  .search-result-item {
    padding: 0.7rem 1rem;
    margin: 0 0.25rem;
  }
  /* Larger touch targets */
  .search-result-icon {
    width: 32px;
    height: 32px;
  }
  .search-result-icon svg {
    width: 16px;
    height: 16px;
  }
}

/* ==========================================================================
   Landing Page Cards
   ========================================================================== */

.landing-hero {
  margin-bottom: 2.5rem;
}
.landing-hero h1 {
  font-size: 2.2rem;
  font-family: var(--font-family-bold);
  color: var(--nav-bg);
  margin-bottom: 0.75rem;
  line-height: 1.15;
}
.landing-hero p {
  font-size: 1.1rem;
  color: var(--text-secondary);
  line-height: 1.55;
  max-width: 600px;
}
.landing-cta {
  display: inline-flex;
  align-items: center;
  gap: 0.4rem;
  margin-top: 1rem;
  padding: 0.65rem 1.4rem;
  background: var(--nav-bg);
  color: var(--accent);
  font-family: var(--font-family-demibold);
  font-size: 0.95rem;
  border-radius: 6px;
  text-decoration: none;
  transition: background var(--transition-fast), transform var(--transition-fast), box-shadow var(--transition-fast);
}
.landing-cta:hover {
  background: var(--hover-bg);
  text-decoration: none;
  transform: translateY(-1px);
  box-shadow: 0 4px 12px rgba(0,0,0,0.15);
}

.card-section-title {
  font-size: 0.78rem;
  font-family: var(--font-family-bold);
  text-transform: uppercase;
  letter-spacing: 0.05em;
  color: var(--text-secondary);
  margin: 2.5rem 0 0.75rem;
}
.card-grid {
  display: grid;
  grid-template-columns: repeat(2, 1fr);
  gap: 1rem;
  margin-bottom: 1.5rem;
}
.card {
  display: flex;
  flex-direction: column;
  padding: 1.15rem 1.25rem;
  background: var(--bg);
  border: 1px solid var(--border);
  border-radius: 8px;
  text-decoration: none;
  color: var(--text);
  transition: border-color var(--transition-fast), box-shadow var(--transition-fast), transform var(--transition-fast);

  &:hover {
    border-color: var(--nav-bg);
    box-shadow: 0 4px 16px rgba(0,0,0,0.08);
    transform: translateY(-2px);
    text-decoration: none;

    & .card-title::after {
      opacity: 0.8;
      transform: translateX(3px);
    }
  }

  & .card-title {
    font-family: var(--font-family-demibold);
    font-size: 0.95rem;
    color: var(--nav-bg);
    margin-bottom: 0.35rem;
    display: flex;
    align-items: center;
    justify-content: space-between;

    &::after {
      content: "\2192";
      font-size: 1rem;
      opacity: 0.4;
      transition: opacity var(--transition-fast), transform var(--transition-fast);
    }
  }

  & .card-desc {
    font-size: 0.85rem;
    color: var(--text-secondary);
    line-height: 1.45;
  }
}

@media (max-width: 600px) {
  .card-grid { grid-template-columns: 1fr; }
  .landing-hero h1 { font-size: 1.6rem; }
}

/* ==========================================================================
   Blockquote Variants (tip, warning, note, important)
   ========================================================================== */

.guide-content blockquote.tip {
  background: #f0f9e8;
  border-left-color: #4caf50;
}
.guide-content blockquote.warning {
  background: #fff8e1;
  border-left-color: #ff9800;
}
.guide-content blockquote.note {
  background: #e8f4fd;
  border-left-color: #2196f3;
}
.guide-content blockquote.important {
  background: #fde8e8;
  border-left-color: #f44336;
}

/* ==========================================================================
   Table Zebra Striping
   ========================================================================== */

.guide-content tr:nth-child(even) td {
  background: var(--bg-secondary);
}
.guide-content tr:nth-child(even):hover td {
  background: var(--border);
}

/* ==========================================================================
   Enum Overflow Toggle
   ========================================================================== */

.enum-badges-overflow {
  display: inline-flex;
  flex-wrap: wrap;
  gap: 0.3em;
  margin-left: 0.3em;
  vertical-align: baseline;
}
.enum-badges-overflow .enum-badge-hidden {
  display: none;
}
.enum-badges-overflow.enum-expanded .enum-badge-hidden {
  display: inline-block;
}
.enum-show-more {
  display: inline-block;
  font-family: var(--font-mono);
  font-size: 0.72rem;
  background: var(--bg-secondary);
  color: var(--text-secondary);
  border: 1px solid var(--border);
  border-radius: 3px;
  padding: 0.1em 0.4em;
  cursor: pointer;
  transition: background var(--transition-fast), color var(--transition-fast);
}
.enum-show-more:hover {
  background: var(--border);
  color: var(--text);
}
.enum-badges-overflow.enum-expanded .enum-show-more {
  display: none;
}

/* ==========================================================================
   Mermaid Diagrams
   ========================================================================== */

.guide-content pre.mermaid {
  background: var(--bg-secondary);
  color: var(--text);
  padding: 2.5rem 2rem;
  border: 1px solid var(--border);
  border-radius: 10px;
  box-shadow: 0 1px 3px rgba(0,0,0,0.04), 0 4px 12px rgba(0,0,0,0.02);
  text-align: center;
  overflow-x: auto;
  margin: 2rem 0;
}

/* Mermaid SVG enhancements */
.guide-content pre.mermaid svg {
  text-rendering: optimizeLegibility;
  -webkit-font-smoothing: antialiased;
}

/* State diagram: rounded nodes */
.guide-content pre.mermaid .statediagram-state rect,
.guide-content pre.mermaid .state-group rect {
  rx: 6;
  ry: 6;
}

/* State diagram: transition edges */
.guide-content pre.mermaid .statediagram-state .transition,
.guide-content pre.mermaid .edge path {
  stroke-width: 1.5px;
}

/* Sequence diagram: actor boxes */
.guide-content pre.mermaid .actor {
  rx: 6;
  ry: 6;
  stroke-width: 1.5px;
}

/* Sequence diagram: message lines */
.guide-content pre.mermaid .messageLine0,
.guide-content pre.mermaid .messageLine1 {
  stroke-width: 1.5px;
}

/* Sequence diagram: note boxes */
.guide-content pre.mermaid .note rect {
  rx: 4;
  ry: 4;
}

/* ==========================================================================
   Focus States (global audit)
   ========================================================================== */

a:focus-visible,
button:focus-visible,
input:focus-visible {
  outline: 2px solid var(--accent);
  outline-offset: 2px;
}

/* ==========================================================================
   Dark Mode
   ========================================================================== */

[data-theme="dark"] {
  --nav-bg: #1a2230;
  --heading-color: #e0e4e8;
  --hover-bg: #3a4a5c;
  --text: #e0e4e8;
  --text-secondary: #9aa5b1;
  --bg: #1e2a38;
  --bg-secondary: #253040;
  --border: #3a4a5c;
  --code-bg: #2a3648;

  /* Links: use accent on dark bg to stay visible */
  & a { color: var(--accent); }
  & a:hover { color: #c8ff4d; }

  & .header-nav a { color: rgba(255,255,255,0.7); }
  & .header-nav a:hover { color: var(--nav-text); }
  & .header-nav a.active { color: var(--nav-text); }

  & .logo-link { color: var(--nav-text); }

  & .breadcrumbs a { color: var(--text-secondary); }
  & .breadcrumbs a:hover { color: var(--text); }

  & .site-footer a { color: var(--text-secondary); }
  & .site-footer a:hover { color: var(--text); }

  & .nav-section-link { color: var(--text); }
  & .nav-section-link:hover { color: var(--accent); }
  & .nav-section li a { color: var(--text); }

  /* Headings */
  & .page-nav-title { color: var(--text); }

  /* Active sidebar link */
  & .nav-section li a.active {
    background: color-mix(in srgb, var(--accent) 8%, transparent);
    color: var(--accent);
  }

  /* Blockquotes */
  & .guide-content blockquote {
    background: color-mix(in srgb, var(--accent) 6%, transparent);
  }

  /* Pre box-shadow */
  & .guide-content pre {
    box-shadow: 0 1px 3px rgba(0,0,0,0.3), 0 1px 2px rgba(0,0,0,0.2);
  }

  /* Mermaid dark mode */
  & .guide-content pre.mermaid {
    box-shadow: 0 1px 3px rgba(0,0,0,0.3), 0 4px 12px rgba(0,0,0,0.15);
  }

  /* Page nav hover */
  & .page-nav-link:hover {
    border-color: var(--accent);
    box-shadow: 0 2px 8px rgba(0,0,0,0.25);
  }

  /* Endpoint TOC hover */
  & .endpoint-toc-item:hover {
    background: color-mix(in srgb, var(--accent) 6%, transparent);
  }
  & .endpoint-toc-summary {
    color: var(--text-secondary);
  }

  /* Endpoint subnav */
  & .endpoint-subnav-link { color: var(--text-secondary); }
  & .endpoint-subnav-link:hover {
    color: var(--text);
    background: color-mix(in srgb, var(--accent) 6%, transparent);
  }
  & .endpoint-subnav-link.active { color: var(--accent); }

  /* TOC rail — keep links muted, only active gets accent */
  & .toc-rail-link { color: var(--text-secondary); }
  & .toc-rail-link:hover { color: var(--text); }
  & .toc-rail-link.active { color: var(--accent); }

  /* Deep link button */
  & .deep-link-btn:hover {
    background: var(--bg-secondary);
    border-color: var(--border);
    color: var(--text);
  }
  & .deep-link-btn.copied {
    color: var(--accent);
    border-color: var(--accent);
  }

  /* Back-to-top */
  & .back-to-top {
    box-shadow: 0 2px 8px rgba(0,0,0,0.35);
  }

  /* Param row hover */
  & .param-table tr:hover td {
    background: color-mix(in srgb, var(--accent) 6%, transparent);
  }

  /* Schema field hover & nesting accent */
  & .schema-prop-row:hover {
    background: color-mix(in srgb, var(--accent) 6%, transparent);
  }
  & .schema-children {
    border-color: var(--border);
    border-left-color: color-mix(in srgb, var(--accent) 35%, transparent);
    background: color-mix(in srgb, var(--accent) 3%, transparent);
  }
  & .schema-children .schema-children {
    background: var(--bg-secondary);
  }
  & .schema-children .schema-children .schema-children {
    background: color-mix(in srgb, var(--accent) 3%, transparent);
  }

  /* Schema tabs — dark mode inherits most styling via CSS variables */
  & .schema-tab.active {
    border-bottom-color: var(--accent);
  }

  /* ── Badge dark variants — override the color-family variables ── */
  --badge-green-bg: #1a3a2a;   --badge-green-text: #6ee7a0;
  --badge-blue-bg: #1a2a3a;    --badge-blue-text: #7ec8e3;
  --badge-yellow-bg: #3a3020;  --badge-yellow-text: #f5d77a;
  --badge-red-bg: #3a1a20;     --badge-red-text: #f5a0a8;

  /* ── Enum dark overrides ── */
  & .enum-badge {
    background: var(--code-bg);
    border-color: var(--border);
    color: var(--text-secondary);
  }

  /* ── Dark: search modal ── */
  & .search-modal-inner {
    box-shadow:
      0 0 0 1px rgba(255,255,255,0.06),
      0 4px 12px rgba(0,0,0,0.2),
      0 20px 60px rgba(0,0,0,0.5);
  }
  & .search-result-item:hover {
    background: color-mix(in srgb, var(--accent) 5%, transparent);
  }
  & .search-result-item.active {
    background: color-mix(in srgb, var(--accent) 8%, transparent);
  }
  & .search-result-icon {
    background: color-mix(in srgb, var(--accent) 6%, transparent);
    color: var(--text-secondary);
  }
  & .search-result-item.active .search-result-icon,
  & .search-result-item:hover .search-result-icon {
    background: color-mix(in srgb, var(--accent) 12%, transparent);
    color: var(--accent);
  }
  & .search-result-icon.icon-endpoint {
    background: color-mix(in srgb, var(--accent) 6%, transparent);
    color: var(--accent);
  }
  & .search-result-title mark {
    background: color-mix(in srgb, var(--accent) 20%, transparent);
  }
  & .search-result-desc mark {
    background: color-mix(in srgb, var(--accent) 12%, transparent);
  }
  & .search-results:empty::before {
    opacity: 0.12;
    background-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' fill='none' stroke='%23aaa' stroke-width='1.5' stroke-linecap='round' stroke-linejoin='round'%3E%3Ccircle cx='11' cy='11' r='8'/%3E%3Cline x1='21' y1='21' x2='16.65' y2='16.65'/%3E%3C/svg%3E");
  }
  & .search-hint kbd {
    background: var(--bg);
    border-color: var(--border);
  }

  /* ── Dark: cards ── */
  & .card:hover {
    border-color: var(--accent);
    box-shadow: 0 4px 16px rgba(0,0,0,0.3);
  }
  & .card-title { color: var(--text); }
  & .landing-hero h1 { color: var(--text); }
  & .landing-cta {
    background: var(--accent);
    color: var(--nav-bg);
  }
  & .landing-cta:hover {
    background: #c8ff4d;
  }

  /* ── Dark: blockquote variants ── */
  & .guide-content blockquote.tip {
    background: rgba(76, 175, 80, 0.08);
  }
  & .guide-content blockquote.warning {
    background: rgba(255, 152, 0, 0.08);
  }
  & .guide-content blockquote.note {
    background: rgba(33, 150, 243, 0.08);
  }
  & .guide-content blockquote.important {
    background: rgba(244, 67, 56, 0.08);
  }

  /* ── Dark: table zebra ── */
  & .guide-content tr:nth-child(even) td {
    background: var(--bg-secondary);
  }
  & .guide-content tr:nth-child(even):hover td {
    background: color-mix(in srgb, var(--accent) 6%, transparent);
  }

  /* ── Dark: links subtlety ── */
  & .guide-content a {
    text-decoration-color: color-mix(in srgb, var(--accent) 35%, transparent);
  }
  & .guide-content a:hover {
    text-decoration-color: color-mix(in srgb, var(--accent) 70%, transparent);
  }

  /* ── Dark: endpoint path background ── */
  & .endpoint-path {
    background: var(--code-bg);
  }

  /* ── Dark: alternating endpoint sections ── */
  & .endpoint-section:nth-of-type(even) {
    background: color-mix(in srgb, var(--bg-secondary) 50%, transparent);
  }

  /* ── Dark: theme toggle icon swap ── */
  & .theme-toggle .icon-sun  { display: block; }
  & .theme-toggle .icon-moon { display: none; }
}

/* Smooth theme transition on key surfaces */
body,
.sidebar,
.site-header,
.site-footer {
  transition: background 0.2s, color 0.2s, border-color 0.2s;
}

/* ── Theme toggle button ── */
.theme-toggle {
  width: 36px;
}
/* Light mode defaults — dark mode overrides in [data-theme="dark"] block */
.theme-toggle .icon-sun  { display: none; }
.theme-toggle .icon-moon { display: block; }

/* ==========================================================================
   Schema Tabs (Fields / Example)
   ========================================================================== */

.schema-tabs {
  margin: 0.75rem 0 1rem;
}

.schema-tabs-bar {
  display: flex;
  gap: 0;
  border-bottom: 2px solid var(--border);
  margin-bottom: 0;
}

.schema-tab {
  padding: 0.45rem 1rem;
  font-family: var(--font-family-demibold);
  font-size: 0.78rem;
  text-transform: uppercase;
  letter-spacing: 0.03em;
  color: var(--text-secondary);
  background: none;
  border: none;
  border-bottom: 2px solid transparent;
  margin-bottom: -2px;
  cursor: pointer;
  transition: color var(--transition-fast), border-color var(--transition-fast);
}
.schema-tab:hover {
  color: var(--text);
}
.schema-tab.active {
  color: var(--text);
  border-bottom-color: var(--accent);
}
.schema-tab:focus-visible {
  outline: 2px solid var(--accent);
  outline-offset: -2px;
}

.schema-tab-panel[hidden] {
  display: none;
}

/* Remove top margin from schema fields when inside tabs */
.schema-tab-panel .schema-fields {
  margin-top: 0;
}

/* Example JSON panel styling */
.schema-tab-panel .code-block-wrapper {
  margin: 0;
  border-top: none;
  border-radius: 0 0 8px 8px;
}

/* ==========================================================================
   Collapsible Schema Children (Stripe-style text button)
   ========================================================================== */

.schema-children-toggle {
  display: inline-flex;
  align-items: center;
  gap: 0.35em;
  margin-top: 0.45rem;
  padding: 0.3em 0.7em;
  font-family: var(--font-family-demibold);
  font-size: 0.76rem;
  color: var(--text-secondary);
  background: var(--bg-secondary);
  border: 1px solid var(--border);
  border-radius: 4px;
  cursor: pointer;
  transition: background var(--transition-fast), color var(--transition-fast), border-color var(--transition-fast);
}
.schema-children-toggle:hover {
  color: var(--text);
  background: var(--border);
}
.schema-children-toggle:focus-visible {
  outline: 2px solid var(--accent);
  outline-offset: 2px;
}

/* ==========================================================================
   Drawer Nav (mobile sidebar top links)
   ========================================================================== */

.drawer-nav {
  display: none;
}

/* ==========================================================================
   TOC Right Rail (guide pages with toc: true)
   ========================================================================== */

.toc-rail {
  width: 220px;
  min-width: 220px;
  position: sticky;
  top: 56px;
  align-self: flex-start;
  max-height: calc(100vh - 56px);
  overflow-y: auto;
  padding: 1.5rem 0 1.5rem 1.25rem;
  border-left: 1px solid var(--border);
}

.toc-rail nav ul {
  list-style: none;
  margin: 0;
  padding: 0;
}

.toc-rail-title {
  font-family: var(--font-family-demibold);
  font-size: 0.7rem;
  text-transform: uppercase;
  letter-spacing: 0.06em;
  color: var(--text-secondary);
  margin-bottom: 0.75rem;
  padding-left: 0.75rem;
}

.toc-rail-link {
  display: block;
  padding: 0.25rem 0.75rem;
  font-size: 0.8rem;
  line-height: 1.4;
  color: var(--text-secondary);
  border-left: 2px solid transparent;
  text-decoration: none;
  transition: color var(--transition-fast), border-color var(--transition-fast);
}
.toc-rail-link:hover {
  color: var(--text);
  text-decoration: none;
}
.toc-rail-link.active {
  color: var(--heading-color);
  border-left-color: var(--accent);
  font-family: var(--font-family-medium);
}

.toc-rail-link-h3 {
  padding-left: 1.5rem;
  font-size: 0.76rem;
}

@media (max-width: 1279px) {
  .toc-rail { display: none; }
}

/* ==========================================================================
   Responsive
   ========================================================================== */

/* Tablet landscape */
@media (max-width: 1024px) {
  :root {
    --sidebar-width: 220px;
  }
  .content {
    padding: 2rem;
  }
}

/* Tablet / mobile */
@media (max-width: 768px) {
  .site-header { padding-left: 1rem; }
  .logo-link { padding-left: 0; }
  .header-nav { display: none; }
  .header-inner {
    grid-template-columns: auto 1fr auto;
  }
  .drawer-nav {
    display: flex;
    flex-direction: column;
    padding: 1rem 1.25rem;
    border-bottom: 1px solid var(--border);
  }
  .drawer-nav a {
    padding: 0.5rem 0;
    color: var(--text);
    font-family: var(--font-family-medium);
    font-size: 0.95rem;
  }
  .drawer-nav a.active {
    color: var(--accent);
  }
  .drawer-nav a:hover {
    text-decoration: none;
    color: var(--accent);
  }
  .sidebar {
    display: none;
    position: fixed;
    top: 56px;
    left: 0;
    bottom: 0;
    z-index: 150;
    width: 280px;
    min-width: 280px;
    transform: translateX(-100%);
    transition: transform var(--transition-normal) ease;
  }
  body.nav-open .sidebar {
    display: block;
    transform: translateX(0);
  }
  .content { padding: 1.5rem; }
  .page-layout { display: block; }
  .endpoint-header { flex-direction: column; align-items: flex-start; }
  .copy-btn { opacity: 1; }
  .path-copy-btn { opacity: 1; }
  .deep-link-btn { opacity: 1; }
  .endpoint-subnav { display: none; }

  /* Responsive typography */
  .guide-content h1 { font-size: 1.5rem; }
  .guide-content h2 { font-size: 1.25rem; }
  .guide-content h3 { font-size: 1.05rem; }

  /* Endpoint path: drop background on small screens */
  .endpoint-path {
    font-size: 0.92rem;
    word-break: break-all;
  }
}

@media (prefers-reduced-motion: reduce) {
  .sidebar { transition: none; }
}

/* ==========================================================================
   View Transitions
   ========================================================================== */

@view-transition { navigation: auto; }
.guide-content { view-transition-name: main-content; }
::view-transition-old(main-content),
::view-transition-new(main-content) { animation-duration: var(--transition-fast); }