/* ==========================================================================
   Conduit Docs — stylesheet
   All design values are CSS custom properties in :root.
   No hardcoded color values appear outside the :root block.
   ========================================================================== */

:root {
  /* Surfaces & text */
  --color-bg: #fafafa;
  --color-bg-card: #ffffff;
  --color-bg-code: #ffffff;
  --color-bg-subtle: #f3f4f6;
  --color-text: #1a1a1a;
  --color-text-muted: #5c6370;
  --color-accent: #2563eb;
  --color-accent-hover: #1d4ed8;
  --color-accent-soft: #eff4ff;
  --color-border: #e5e7eb;
  --color-border-strong: #d1d5db;
  --color-focus-ring: #2563eb;
  --color-selection: #dbe6ff;
  --color-kbd-bg: #f3f4f6;

  /* HTTP method colors (theme) + AA-safe badge backgrounds (white label text) */
  --m-get: #16a34a;
  --m-post: #2563eb;
  --m-delete: #dc2626;
  --m-put: #ca8a04;
  --badge-get-bg: #15803d;
  --badge-post-bg: #2563eb;
  --badge-delete-bg: #dc2626;
  --badge-text: #ffffff;

  /* Callouts (label colors darkened for WCAG AA on tinted backgrounds) */
  --callout-important: #2563eb;
  --callout-important-bg: #eff4ff;
  --callout-warning: #b45309;
  --callout-warning-bg: #fff7ed;
  --callout-tip: #15803d;
  --callout-tip-bg: #f0fdf4;

  /* Syntax theme (shared) — all >= 4.5:1 on the white code surface */
  --tok-keyword: #7c3aed;
  --tok-string: #15803d;
  --tok-number: #c2410c;
  --tok-comment: #6b7280;
  --tok-function: #2563eb;
  --tok-property: #0e7490;
  --tok-punct: #1a1a1a;

  /* Typography */
  --font-sans: system-ui, -apple-system, "Segoe UI", Roboto, sans-serif;
  --font-mono: ui-monospace, "JetBrains Mono", "SF Mono", Menlo, Consolas, monospace;
  --fs-13: 13px;
  --fs-14: 14px;
  --fs-16: 16px;
  --fs-20: 20px;
  --fs-26: 26px;
  --fs-34: 34px;
  --lh-prose: 1.65;
  --lh-mono: 1.55;
  --fw-normal: 400;
  --fw-medium: 500;
  --fw-semibold: 600;
  --fw-bold: 700;

  /* Spacing & geometry */
  --space-half: 4px;
  --space: 8px;
  --space-2: 16px;
  --space-3: 24px;
  --space-4: 32px;
  --space-5: 48px;
  --radius: 8px;
  --radius-sm: 6px;
  --radius-pill: 999px;
  --content-max: 760px;
  --sidebar-w: 256px;
  --toc-w: 220px;
  --header-h: 56px;
  --ring-w: 2px;

  /* Elevation (rgba — not hex) */
  --shadow-sm: 0 1px 2px rgba(15, 23, 42, 0.06);
  --shadow-pop: 0 6px 24px rgba(15, 23, 42, 0.10);
  --color-scrim: rgba(15, 23, 42, 0.32);

  /* Motion */
  --t-fast: 120ms ease;
  --t-base: 160ms ease;
}

/* --------------------------------------------------------------------------
   Reset & base
   -------------------------------------------------------------------------- */
*,
*::before,
*::after { box-sizing: border-box; }

html { scroll-behavior: smooth; }

body {
  margin: 0;
  background: var(--color-bg);
  color: var(--color-text);
  font-family: var(--font-sans);
  font-size: var(--fs-16);
  line-height: var(--lh-prose);
  -webkit-font-smoothing: antialiased;
  text-rendering: optimizeLegibility;
}

::selection { background: var(--color-selection); }

a {
  color: var(--color-accent);
  text-decoration: none;
}
a:hover { color: var(--color-accent-hover); text-decoration: underline; }

h1, h2, h3, h4 {
  color: var(--color-text);
  font-weight: var(--fw-semibold);
  line-height: 1.25;
  scroll-margin-top: calc(var(--header-h) + var(--space-3));
}

code, pre, kbd { font-family: var(--font-mono); }

img, svg { display: block; }

/* Accessibility helpers */
.visually-hidden {
  position: absolute;
  width: 1px;
  height: 1px;
  padding: 0;
  margin: -1px;
  overflow: hidden;
  clip: rect(0 0 0 0);
  white-space: nowrap;
  border: 0;
}

.skip-link {
  position: absolute;
  left: var(--space-2);
  top: calc(var(--space) * -6);
  z-index: 100;
  padding: var(--space) var(--space-2);
  background: var(--color-accent);
  color: var(--badge-text);
  border-radius: var(--radius-sm);
  font-size: var(--fs-14);
  font-weight: var(--fw-medium);
  transition: top var(--t-base);
}
.skip-link:focus { top: var(--space-2); color: var(--badge-text); text-decoration: none; }

/* Universal focus ring */
:focus-visible {
  outline: var(--ring-w) solid var(--color-focus-ring);
  outline-offset: 2px;
  border-radius: var(--radius-sm);
}
:disabled,
[disabled] { cursor: not-allowed; opacity: 0.55; }

/* --------------------------------------------------------------------------
   Header
   -------------------------------------------------------------------------- */
.site-header {
  position: sticky;
  top: 0;
  z-index: 40;
  display: flex;
  align-items: center;
  gap: var(--space-2);
  height: var(--header-h);
  padding: 0 var(--space-3);
  background: var(--color-bg-card);
  border-bottom: 1px solid var(--color-border);
}

.brand {
  display: inline-flex;
  align-items: center;
  gap: var(--space);
  color: var(--color-text);
  font-weight: var(--fw-semibold);
  font-size: var(--fs-16);
}
.brand:hover { text-decoration: none; }
.brand-mark { width: 24px; height: 24px; color: var(--color-accent); }
.brand-name { letter-spacing: -0.01em; }

.search {
  position: relative;
  display: flex;
  align-items: center;
  margin-left: auto;
  width: min(360px, 42vw);
}
.search-icon {
  position: absolute;
  left: var(--space-2);
  width: 16px;
  height: 16px;
  color: var(--color-text-muted);
  pointer-events: none;
}
.search-input {
  width: 100%;
  height: 36px;
  padding: 0 calc(var(--space) * 6) 0 calc(var(--space) * 5);
  font-family: var(--font-sans);
  font-size: var(--fs-14);
  color: var(--color-text);
  background: var(--color-bg);
  border: 1px solid var(--color-border);
  border-radius: var(--radius);
  transition: border-color var(--t-base), box-shadow var(--t-base);
}
.search-input::placeholder { color: var(--color-text-muted); }
.search-input:focus-visible {
  outline: none;
  border-color: var(--color-accent);
  box-shadow: 0 0 0 var(--ring-w) var(--color-accent-soft);
}
.search-input:disabled { background: var(--color-bg-subtle); }
.search-hint {
  position: absolute;
  right: var(--space);
  display: inline-flex;
  align-items: center;
  height: 22px;
  padding: 0 var(--space);
  font-size: var(--fs-13);
  font-weight: var(--fw-medium);
  color: var(--color-text-muted);
  background: var(--color-kbd-bg);
  border: 1px solid var(--color-border);
  border-radius: var(--radius-sm);
  pointer-events: none;
}

.nav-menu-btn {
  display: none;
  align-items: center;
  justify-content: center;
  width: 36px;
  height: 36px;
  color: var(--color-text);
  background: transparent;
  border: 1px solid var(--color-border);
  border-radius: var(--radius);
  cursor: pointer;
  transition: background-color var(--t-fast), border-color var(--t-fast);
}
.nav-menu-btn:hover { background: var(--color-bg-subtle); }
.icon { width: 20px; height: 20px; stroke-width: 2; }

/* --------------------------------------------------------------------------
   Layout
   -------------------------------------------------------------------------- */
.layout {
  display: grid;
  grid-template-columns: var(--sidebar-w) minmax(0, 1fr) var(--toc-w);
  gap: var(--space-4);
  max-width: 1320px;
  margin: 0 auto;
  padding: var(--space-4) var(--space-3) var(--space-5);
}

/* --------------------------------------------------------------------------
   Sidebar
   -------------------------------------------------------------------------- */
.sidebar {
  position: sticky;
  top: calc(var(--header-h) + var(--space-3));
  align-self: start;
  max-height: calc(100vh - var(--header-h) - var(--space-4));
  overflow-y: auto;
  padding-right: var(--space);
}
.sidebar-group {
  margin: 0 0 var(--space) 0;
  padding: 0 var(--space);
  font-size: var(--fs-13);
  font-weight: var(--fw-semibold);
  letter-spacing: 0.06em;
  text-transform: uppercase;
  color: var(--color-text-muted);
}
.sidebar ul {
  list-style: none;
  margin: 0 0 var(--space-3) 0;
  padding: 0;
}
.sidebar li { margin: 2px 0; }
.sidebar a {
  display: block;
  padding: var(--space) var(--space-2);
  font-size: var(--fs-14);
  color: var(--color-text);
  border-radius: var(--radius-sm);
  transition: background-color var(--t-fast), color var(--t-fast);
}
.sidebar a:hover { background: var(--color-bg-subtle); text-decoration: none; }
.sidebar a[aria-current="page"] {
  background: var(--color-accent-soft);
  color: var(--color-accent);
  font-weight: var(--fw-semibold);
}

/* --------------------------------------------------------------------------
   Content
   -------------------------------------------------------------------------- */
.content {
  min-width: 0;
  max-width: var(--content-max);
}

.breadcrumb {
  display: flex;
  align-items: center;
  gap: var(--space);
  margin-bottom: var(--space-3);
  font-size: var(--fs-13);
  color: var(--color-text-muted);
}
.breadcrumb a { color: var(--color-text-muted); }
.breadcrumb a:hover { color: var(--color-accent); }
.breadcrumb .crumb-sep { color: var(--color-border-strong); }
.breadcrumb [aria-current="page"] { color: var(--color-text); font-weight: var(--fw-medium); }

.page-title {
  display: flex;
  flex-wrap: wrap;
  align-items: center;
  gap: var(--space-2);
  margin: 0 0 var(--space-2);
  font-size: var(--fs-34);
  letter-spacing: -0.02em;
}
.lead {
  margin: 0 0 var(--space-4);
  font-size: var(--fs-20);
  line-height: 1.5;
  color: var(--color-text-muted);
}

.content h2 {
  margin: var(--space-5) 0 var(--space-2);
  padding-top: var(--space);
  font-size: var(--fs-26);
  letter-spacing: -0.01em;
  border-top: 1px solid var(--color-border);
}
.content h3 {
  margin: var(--space-4) 0 var(--space);
  font-size: var(--fs-20);
}
.content p { margin: 0 0 var(--space-2); }
.content ul, .content ol { margin: 0 0 var(--space-2); padding-left: var(--space-3); }
.content li { margin: var(--space-half) 0; }

.content :not(pre) > code {
  padding: 2px 6px;
  font-size: 0.875em;
  color: var(--color-text);
  background: var(--color-bg-subtle);
  border: 1px solid var(--color-border);
  border-radius: var(--radius-sm);
  overflow-wrap: anywhere;
}

.time-badge {
  display: inline-flex;
  align-items: center;
  gap: var(--space-half);
  padding: var(--space-half) var(--space);
  font-size: var(--fs-13);
  font-weight: var(--fw-medium);
  color: var(--color-accent);
  background: var(--color-accent-soft);
  border-radius: var(--radius-pill);
}

.section-anchor {
  margin-left: var(--space);
  font-size: 0.7em;
  color: var(--color-border-strong);
  opacity: 0;
  transition: opacity var(--t-fast), color var(--t-fast);
}
h2:hover .section-anchor,
h3:hover .section-anchor { opacity: 1; }
.section-anchor:hover { color: var(--color-accent); text-decoration: none; }

/* Numbered steps */
.step {
  display: grid;
  grid-template-columns: 36px 1fr;
  gap: var(--space-2);
  margin: var(--space-3) 0;
}
.step-num {
  display: flex;
  align-items: center;
  justify-content: center;
  width: 32px;
  height: 32px;
  font-size: var(--fs-14);
  font-weight: var(--fw-semibold);
  color: var(--badge-text);
  background: var(--color-accent);
  border-radius: var(--radius-pill);
}
.step-body { min-width: 0; }
.step-body > h3 { margin-top: 0; }
.step.is-verify .step-num { background: var(--badge-get-bg); }

/* --------------------------------------------------------------------------
   Tables
   -------------------------------------------------------------------------- */
.table-wrap { overflow-x: auto; margin: var(--space-2) 0 var(--space-3); }
table {
  width: 100%;
  border-collapse: collapse;
  font-size: var(--fs-14);
}
thead th {
  text-align: left;
  font-weight: var(--fw-semibold);
  color: var(--color-text-muted);
  border-bottom: 1px solid var(--color-border-strong);
}
th, td {
  padding: var(--space) var(--space-2);
  vertical-align: top;
  border-bottom: 1px solid var(--color-border);
}
td code, th code { white-space: nowrap; }
td .indent-1 { padding-left: var(--space-2); }
td .indent-2 { padding-left: var(--space-4); }
.t-type { color: var(--color-text-muted); }
.t-req { color: var(--m-delete); font-weight: var(--fw-medium); }

/* --------------------------------------------------------------------------
   Code blocks
   -------------------------------------------------------------------------- */
.code-block {
  margin: var(--space-2) 0 var(--space-3);
  background: var(--color-bg-code);
  border: 1px solid var(--color-border);
  border-radius: var(--radius);
  overflow: hidden;
}
.code-head {
  display: flex;
  align-items: center;
  justify-content: space-between;
  padding: var(--space-half) var(--space-2);
  background: var(--color-bg-subtle);
  border-bottom: 1px solid var(--color-border);
}
.code-lang {
  font-family: var(--font-mono);
  font-size: var(--fs-13);
  font-weight: var(--fw-medium);
  color: var(--color-text-muted);
  text-transform: lowercase;
}
.copy-btn {
  display: inline-flex;
  align-items: center;
  gap: var(--space-half);
  padding: var(--space-half) var(--space);
  font-family: var(--font-sans);
  font-size: var(--fs-13);
  font-weight: var(--fw-medium);
  color: var(--color-text);
  background: var(--color-bg-card);
  border: 1px solid var(--color-border-strong);
  border-radius: var(--radius-sm);
  cursor: pointer;
  transition: background-color var(--t-fast), border-color var(--t-fast), color var(--t-fast);
}
.copy-btn:hover { background: var(--color-bg-subtle); border-color: var(--color-text-muted); }
.copy-btn:disabled { background: var(--color-bg-subtle); }
.copy-btn.is-copied { color: var(--badge-get-bg); border-color: var(--badge-get-bg); }

.code-block pre {
  margin: 0;
  padding: var(--space-2);
  font-size: var(--fs-14);
  line-height: var(--lh-mono);
  color: var(--color-text);
  white-space: pre-wrap;
  overflow-wrap: anywhere;
  overflow-x: auto;
  tab-size: 2;
}
.code-block pre code { font-size: inherit; color: inherit; }

/* Syntax tokens */
.tok-keyword  { color: var(--tok-keyword); }
.tok-string   { color: var(--tok-string); }
.tok-number   { color: var(--tok-number); }
.tok-comment  { color: var(--tok-comment); font-style: italic; }
.tok-function { color: var(--tok-function); }
.tok-property { color: var(--tok-property); }
.tok-punct    { color: var(--tok-punct); }

/* Tab groups (synced language tabs) */
.tabs { margin: var(--space-2) 0 var(--space-3); }
.tablist {
  display: flex;
  gap: var(--space-half);
  border-bottom: 1px solid var(--color-border);
}
.tab {
  padding: var(--space) var(--space-2);
  font-family: var(--font-sans);
  font-size: var(--fs-14);
  font-weight: var(--fw-medium);
  color: var(--color-text-muted);
  background: transparent;
  border: 0;
  border-bottom: 2px solid transparent;
  cursor: pointer;
  transition: color var(--t-fast), border-color var(--t-fast);
}
.tab:hover { color: var(--color-text); }
.tab[aria-selected="true"] { color: var(--color-accent); border-bottom-color: var(--color-accent); }
.tabpanel[hidden] { display: none; }
.tabs .code-block { margin-top: var(--space-2); }

/* --------------------------------------------------------------------------
   API endpoints
   -------------------------------------------------------------------------- */
.endpoint {
  margin: var(--space-2) 0 var(--space-4);
  padding: var(--space-2);
  background: var(--color-bg-card);
  border: 1px solid var(--color-border);
  border-left: 3px solid var(--color-border-strong);
  border-radius: var(--radius);
}
.endpoint.m-get { border-left-color: var(--m-get); }
.endpoint.m-post { border-left-color: var(--m-post); }
.endpoint.m-delete { border-left-color: var(--m-delete); }
.endpoint-head {
  display: flex;
  flex-wrap: wrap;
  align-items: center;
  gap: var(--space);
}
.method {
  display: inline-flex;
  align-items: center;
  padding: 3px var(--space);
  font-family: var(--font-mono);
  font-size: var(--fs-13);
  font-weight: var(--fw-bold);
  letter-spacing: 0.04em;
  color: var(--badge-text);
  border-radius: var(--radius-sm);
}
.method.get { background: var(--badge-get-bg); }
.method.post { background: var(--badge-post-bg); }
.method.delete { background: var(--badge-delete-bg); }
.endpoint-path {
  font-family: var(--font-mono);
  font-size: var(--fs-16);
  font-weight: var(--fw-semibold);
  overflow-wrap: anywhere;
}
.endpoint-path .path-var { color: var(--color-accent); }

/* --------------------------------------------------------------------------
   Callouts
   -------------------------------------------------------------------------- */
.callout {
  margin: var(--space-3) 0;
  padding: var(--space-2);
  border: 1px solid var(--color-border);
  border-left: 4px solid var(--color-border-strong);
  border-radius: var(--radius);
  background: var(--color-bg-card);
}
.callout > :last-child { margin-bottom: 0; }
.callout-label {
  display: block;
  margin-bottom: var(--space-half);
  font-size: var(--fs-13);
  font-weight: var(--fw-semibold);
  letter-spacing: 0.04em;
  text-transform: uppercase;
}
.callout.important { border-left-color: var(--callout-important); background: var(--callout-important-bg); }
.callout.important .callout-label { color: var(--callout-important); }
.callout.warning { border-left-color: var(--callout-warning); background: var(--callout-warning-bg); }
.callout.warning .callout-label { color: var(--callout-warning); }
.callout.tip { border-left-color: var(--callout-tip); background: var(--callout-tip-bg); }
.callout.tip .callout-label { color: var(--callout-tip); }

/* ASCII diagram */
.diagram {
  margin: var(--space-2) 0 var(--space-3);
  padding: var(--space-3);
  font-family: var(--font-mono);
  font-size: var(--fs-13);
  line-height: 1.5;
  color: var(--color-text);
  background: var(--color-bg-card);
  border: 1px solid var(--color-border);
  border-radius: var(--radius);
  white-space: pre;
  overflow-x: auto;
}

/* --------------------------------------------------------------------------
   Right TOC (On this page) — collapsible details
   -------------------------------------------------------------------------- */
.toc {
  position: sticky;
  top: calc(var(--header-h) + var(--space-3));
  align-self: start;
  max-height: calc(100vh - var(--header-h) - var(--space-4));
  overflow-y: auto;
  font-size: var(--fs-13);
}
.toc-summary {
  font-weight: var(--fw-semibold);
  letter-spacing: 0.06em;
  text-transform: uppercase;
  color: var(--color-text-muted);
  cursor: pointer;
  list-style: none;
}
.toc-summary::-webkit-details-marker { display: none; }
.toc-nav { display: flex; flex-direction: column; margin-top: var(--space); }
.toc-nav a {
  padding: var(--space-half) var(--space);
  color: var(--color-text-muted);
  border-left: 2px solid var(--color-border);
  transition: color var(--t-fast), border-color var(--t-fast);
}
.toc-nav a:hover { color: var(--color-text); text-decoration: none; }
.toc-nav a.toc-h3 { padding-left: var(--space-3); }
.toc-nav a.active {
  color: var(--color-accent);
  border-left-color: var(--color-accent);
  font-weight: var(--fw-medium);
}

/* --------------------------------------------------------------------------
   Responsive: TOC collapses above content <= 960px
   -------------------------------------------------------------------------- */
@media (max-width: 960px) {
  .layout { grid-template-columns: var(--sidebar-w) minmax(0, 1fr); }
  .toc {
    position: static;
    grid-column: 1 / -1;
    max-height: none;
    margin-bottom: var(--space-3);
    padding: var(--space-2);
    background: var(--color-bg-card);
    border: 1px solid var(--color-border);
    border-radius: var(--radius);
  }
  .toc-summary { padding: var(--space-half) 0; }
}

/* Responsive: sidebar -> hamburger <= 768px */
@media (max-width: 768px) {
  .nav-menu-btn { display: inline-flex; }
  .search { width: auto; flex: 1; }
  .search-hint { display: none; }
  .layout { grid-template-columns: minmax(0, 1fr); padding: var(--space-3) var(--space-2) var(--space-4); }
  .sidebar {
    position: fixed;
    top: var(--header-h);
    left: 0;
    bottom: 0;
    width: min(280px, 80vw);
    padding: var(--space-3) var(--space-2);
    background: var(--color-bg-card);
    border-right: 1px solid var(--color-border);
    box-shadow: var(--shadow-pop);
    transform: translateX(-100%);
    transition: transform var(--t-base);
    z-index: 50;
  }
  body.nav-open .sidebar { transform: translateX(0); }
  .toc { grid-column: 1 / -1; }
  .page-title { font-size: var(--fs-26); }
  .nav-scrim {
    position: fixed;
    inset: var(--header-h) 0 0 0;
    background: var(--color-scrim);
    opacity: 0;
    visibility: hidden;
    transition: opacity var(--t-base), visibility var(--t-base);
    z-index: 45;
  }
  body.nav-open .nav-scrim { opacity: 1; visibility: visible; }
}

/* Reduced motion */
@media (prefers-reduced-motion: reduce) {
  html { scroll-behavior: auto; }
  *,
  *::before,
  *::after {
    transition-duration: 0.01ms !important;
    animation-duration: 0.01ms !important;
    animation-iteration-count: 1 !important;
  }
}