@import url("docs-site-nav.css");
@import url("internal-layout.css");

/* Shared documentation styles */

:root {
  color-scheme: light;
  --bg: #f7f9fc;
  --bg-gradient-top: #f4f7fc;
  --card: #ffffff;
  --text: #1f2937;
  --muted: #4b5563;
  --accent: #2563eb;
  --line: #dbe3ef;
  --inline-code-bg: #eef2ff;
  --pre-bg: #f1f5f9;
  --pre-fg: #0f172a;
  --pre-inset-shadow: rgba(255, 255, 255, 0.6);
  --table-bg: #ffffff;
  --table-th-bg: #f3f6fc;
  --card-shadow: 0 3px 10px rgba(15, 23, 42, 0.05);
  --search-panel-bg: #ffffff;
  --search-result-hover-bg: #eff6ff;
  --search-result-hover-border: #bfdbfe;
  --search-result-preview: #334155;
  --docs-placeholder: #94a3b8;
  --search-results-shadow: 0 10px 24px rgba(15, 23, 42, 0.12);
  --time-cell-bg: #f1f5f9;
  --adr-status-tracks-bg: #fafbff;
  --adr-track-label-color: #475569;
  --adr-step-arrow: #94a3b8;
  --adr-step-border: #cbd5e1;
  --adr-step-bg: #f1f5f9;
  --adr-step-text: #475569;
  --adr-step-done-bg: #dcfce7;
  --adr-step-done-border: #86efac;
  --adr-step-done-text: #14532d;
  --adr-step-current-bg: #fef9c3;
  --adr-step-current-border: #fde047;
  --adr-step-current-text: #713f12;
  --adr-step-todo-bg: #f1f5f9;
  --adr-step-todo-border: #cbd5e1;
  --adr-step-todo-text: #64748b;
  --adr-step-muted-bg: #f1f5f9;
  --adr-step-muted-border: #cbd5e1;
  --adr-step-muted-text: #64748b;
  --adr-step-blocked-bg: #fee2e2;
  --adr-step-blocked-border: #fca5a5;
  --adr-step-blocked-text: #7f1d1d;
  --adr-status-log-bg: #fafbff;
  --adr-status-log-title: #64748b;
  --details-summary-fg: #334155;
  --diagram-bg: #ffffff;
  --sys-diagram-bg: linear-gradient(165deg, #fafbff 0%, #ffffff 52%);
  --sys-diagram-frame-shadow:
    0 1px 0 rgba(15, 23, 42, 0.05),
    0 12px 32px rgba(15, 23, 42, 0.07);
  --sys-diagram-head-bg: linear-gradient(90deg, rgba(37, 99, 235, 0.07) 0%, transparent 55%);
  --sys-diagram-badge-fg: #1e40af;
  --sys-diagram-badge-bg: linear-gradient(180deg, #dbeafe 0%, #bfdbfe 100%);
  --sys-diagram-badge-border: #93c5fd;
  --sys-diagram-canvas-bg:
    radial-gradient(ellipse 90% 60% at 50% 0%, rgba(37, 99, 235, 0.06) 0%, transparent 55%),
    #f8fafc;
  --sys-diagram-foot-bg: #f8fafc;
  --audit-legend-warn-bg: #fff8e6;
  --audit-legend-error-bg: #fde8e8;
  --audit-legend-error-fg: #7f1d1d;
  --badge-default-bg: #f8fbff;
  --badge-success-bg: #dcfce7;
  --badge-success-border: #86efac;
  --badge-success-text: #14532d;
  --badge-warning-bg: #fef9c3;
  --badge-warning-border: #fde047;
  --badge-warning-text: #713f12;
  --badge-muted-bg: #f1f5f9;
  --badge-muted-border: #cbd5e1;
  --badge-muted-text: #334155;
  --badge-danger-bg: #fee2e2;
  --badge-danger-border: #fca5a5;
  --badge-danger-text: #7f1d1d;
  /* Top nav (docs-site-nav.css) */
  --nav-group-bg: linear-gradient(165deg, #ffffff 0%, #f8fafc 100%);
  --nav-group-shadow: 0 1px 2px rgba(15, 23, 42, 0.04);
  --nav-internal-border: #bfdbfe;
  --nav-internal-bg: linear-gradient(165deg, #f8fbff 0%, #f0f7ff 55%, #f8fafc 100%);
  --nav-internal-shadow: 0 1px 2px rgba(30, 64, 175, 0.05);
  --nav-internal-title: #1d4ed8;
  --nav-internal-hint: #60a5fa;
  --nav-public-border: #e9d5ff;
  --nav-public-bg: linear-gradient(165deg, #fdfaff 0%, #faf5ff 55%, #f8fafc 100%);
  --nav-public-shadow: 0 1px 2px rgba(88, 28, 135, 0.05);
  --nav-public-title: #7e22ce;
  --nav-public-hint: #a78bfa;
  --nav-section-title: #64748b;
  --nav-section-hint: #94a3b8;
  --nav-toggle-bg: #ffffff;
  --nav-toggle-fg: #475569;
  --nav-toggle-focus-ring: #93c5fd;
  --nav-link-bg: #f8fbff;
  --nav-link-active-bg: #e8efff;
  --nav-link-active-border: #9db7ff;
  --nav-link-active-text: #1e40af;
  --nav-public-link-hover-border: #c4b5fd;
  --nav-public-link-hover-text: #7e22ce;
  --nav-public-link-active-bg: #f5f3ff;
  --nav-public-link-active-text: #581c87;
  --nav-pdoc-shell-bg: linear-gradient(180deg, #f8fafc 0%, rgba(248, 250, 252, 0.4) 100%);
  --nav-theme-btn-bg: #ffffff;
  --nav-theme-btn-fg: #475569;
  --internal-sidebar-title: #64748b;
  --internal-tree-border: #e8edf5;
  --internal-tree-hover-bg: #eef2ff;
  --internal-tree-active-bg: #e8efff;
  --internal-tree-active-border: #c7d7fe;
  --internal-tree-active-text: #1e40af;
  --internal-group-bg: #ffffff;
  --internal-summary-hover-bg: #f8fafc;
  --internal-http-tablet-bg: linear-gradient(165deg, #ffffff 0%, #f4f7fc 50%, #eef2ff 100%);
  --internal-http-tablet-path: #0f172a;
  --internal-toggle-bg: #ffffff;
  --internal-toggle-fg: #475569;
  --internal-toggle-hover-fg: #1e40af;
  --adr-cs-base-bg: #f8fafc;
  --adr-cs-label: #64748b;
  --adr-cs-value: #0f172a;
  /* Assessment score bands (Table 2) — see ADR 0024, docs/assets/audit-score-legend-fragment.html */
  --audit-score-excellent-bg: #d1e7dd;
  --audit-score-excellent-border: #198754;
  --audit-score-good-bg: #fff3cd;
  --audit-score-good-border: #e0a800;
  --audit-score-needs-bg: #f8d7da;
  --audit-score-needs-border: #c82333;
  --audit-score-legend-border: #dee2e6;
  --audit-score-legend-bg: #f8f9fa;
  --motion-fast: 150ms;
  --motion-base: 220ms;
  --motion-ease-premium: cubic-bezier(0.22, 1, 0.36, 1);
  --focus-ring: 0 0 0 2px color-mix(in srgb, var(--accent) 20%, transparent);
  --shadow-premium-sm: 0 1px 4px rgba(15, 23, 42, 0.08);
  --shadow-premium-md: 0 8px 24px rgba(15, 23, 42, 0.14);
  /* Premium docs UI kit tokens (quick actions + floating cards + feedback). */
  --docs-premium-surface-border: color-mix(in srgb, var(--line) 66%, var(--accent));
  --docs-premium-surface-bg:
    linear-gradient(165deg,
      color-mix(in srgb, var(--card) 97%, #fff) 0%,
      color-mix(in srgb, var(--card) 93%, var(--bg)) 52%,
      color-mix(in srgb, var(--card) 90%, var(--bg)) 100%);
  --docs-premium-surface-shadow:
    0 20px 46px rgba(2, 6, 23, 0.22),
    0 1px 0 rgba(255, 255, 255, 0.46) inset,
    0 0 0 1px color-mix(in srgb, var(--accent) 10%, transparent);
  --docs-premium-chip-bg: color-mix(in srgb, var(--card) 95%, var(--bg));
  --docs-premium-chip-border: var(--line);
  --docs-premium-item-border: color-mix(in srgb, var(--line) 74%, transparent);
  --docs-premium-item-bg:
    linear-gradient(180deg,
      color-mix(in srgb, var(--card) 98%, #fff) 0%,
      color-mix(in srgb, var(--card) 93%, transparent) 100%);
  --docs-premium-item-hover-bg:
    linear-gradient(180deg,
      color-mix(in srgb, var(--search-result-hover-bg) 66%, var(--card)) 0%,
      color-mix(in srgb, var(--search-result-hover-bg) 48%, var(--card)) 100%);
  --docs-premium-item-active-bg:
    linear-gradient(140deg,
      color-mix(in srgb, var(--accent) 10%, var(--card)) 0%,
      color-mix(in srgb, var(--search-result-hover-bg) 58%, var(--card)) 100%);
  --docs-premium-focus-glow-soft: color-mix(in srgb, var(--accent) 10%, transparent);
  --docs-premium-focus-glow-strong: color-mix(in srgb, var(--accent) 24%, transparent);
  /* Inline glossary tooltips (.docs-tooltip) */
  --docs-tooltip-bg: #1e293b;
  --docs-tooltip-fg: #f8fafc;
  --docs-tooltip-border: rgba(15, 23, 42, 0.25);
  --docs-tooltip-shadow: 0 10px 28px rgba(15, 23, 42, 0.22);
  /* Glossary: ETR (.docs-tooltip--etr) — single source for hint text */
  --docs-tooltip-etr-text: "Extract–Transform–Retrieve — learning methodology acronym used in product and API naming (ETR Study API).";
  /*
   * Footer atmosphere: fog + dot “matter” (Grok-like), strongest toward the footer.
   * Set --docs-footer-veil to 0 to disable without deleting rules.
   * Scroll strength: 1 = full; docs-nav.js sets ~0.18…1 from scroll (weaker at top, full near end).
   */
  --docs-footer-veil: 1;
  --docs-footer-scroll-strength: 1;
  /* Tall band so mist + dots can ramp from ~viewport middle downward */
  --docs-footer-veil-height: min(78vh, 900px);
  /* Coarse dot grid */
  --docs-footer-dot-step: 22px;
  /* Fine grain (smaller step = denser haze) */
  --docs-footer-fine-dot-step: 13px;
  --docs-footer-glow-accent-mix: 11%;
  --docs-footer-dot-line-mix: 56%;
  --docs-footer-fine-dot-mix: 38%;
  --docs-footer-veil-duration: 8s;
  --docs-footer-fog-duration: 16s;
  /* Dot wave (pre-GIF style): asymmetric path, smooth easing */
  --docs-footer-wave-duration: 32s;
  --docs-footer-fog-undulate-duration: 42s;
  /* Keyframes use numeric opacity (not calc(var*var)) so Safari/file:// interpolates reliably. */
  --docs-footer-breathe-min: 0.72;
}

* {
  box-sizing: border-box;
}

body {
  margin: 0;
  font-family: Inter, Segoe UI, Roboto, Arial, sans-serif;
  background: linear-gradient(180deg, var(--bg-gradient-top) 0%, var(--bg) 220px);
  color: var(--text);
  line-height: 1.55;
  isolation: isolate;
}

/*
 * Back layer: gray mist / depth ramps — thickens toward the bottom edge.
 */
body::before {
  content: "";
  position: fixed;
  left: 0;
  right: 0;
  bottom: 0;
  height: var(--docs-footer-veil-height);
  z-index: 0;
  pointer-events: none;
  opacity: calc(var(--docs-footer-veil) * 0.96 * var(--docs-footer-scroll-strength, 1));
  background:
    radial-gradient(ellipse 95% 55% at 72% 100%, color-mix(in srgb, var(--muted) 18%, transparent) 0%, transparent 52%),
    radial-gradient(ellipse 90% 60% at 28% 100%, color-mix(in srgb, var(--line) 14%, transparent) 0%, transparent 48%),
    radial-gradient(ellipse 118% 72% at 50% 100%, color-mix(in srgb, var(--line) 26%, transparent) 0%, transparent 58%),
    linear-gradient(to top,
      color-mix(in srgb, var(--muted) 32%, var(--bg) 68%) 0%,
      color-mix(in srgb, var(--line) 16%, transparent) 22%,
      transparent 56%);
  background-size: 100% 100%, 100% 100%, 100% 100%, 100% 100%;
  background-position: center bottom, center bottom, center bottom, center bottom;
  background-repeat: no-repeat, no-repeat, no-repeat, no-repeat;
  /* Soft ramp: dense near footer, imperceptible toward mid-screen */
  mask-image: linear-gradient(to top,
      #000 0%,
      #000 20%,
      rgba(0, 0, 0, 0.9) 46%,
      rgba(0, 0, 0, 0.38) 66%,
      rgba(0, 0, 0, 0.1) 84%,
      transparent 100%);
  -webkit-mask-image: linear-gradient(to top,
      #000 0%,
      #000 20%,
      rgba(0, 0, 0, 0.9) 46%,
      rgba(0, 0, 0, 0.38) 66%,
      rgba(0, 0, 0, 0.1) 84%,
      transparent 100%);
}

@media (prefers-reduced-motion: no-preference) {
  body::before {
    animation:
      docs-footer-fog-swell var(--docs-footer-fog-duration) ease-in-out infinite,
      docs-footer-fog-undulate var(--docs-footer-fog-undulate-duration) ease-in-out infinite;
  }
}

@media (prefers-reduced-motion: reduce) {
  body::before {
    animation: none;
  }
}

@keyframes docs-footer-fog-swell {

  0%,
  100% {
    opacity: calc(var(--docs-footer-veil) * 0.82 * var(--docs-footer-scroll-strength, 1));
    transform: translateY(0);
  }

  50% {
    opacity: calc(var(--docs-footer-veil) * 0.98 * var(--docs-footer-scroll-strength, 1));
    transform: translateY(-5px);
  }
}

/* Very slow lateral drift of fog layers (pairs with dot wave). */
@keyframes docs-footer-fog-undulate {

  0%,
  100% {
    background-position: center bottom, center bottom, center bottom, center bottom;
  }

  20% {
    background-position: 14px 8px, -12px 10px, 10px -8px, center bottom;
  }

  40% {
    background-position: -10px 14px, 16px -6px, -14px 10px, center bottom;
  }

  60% {
    background-position: 8px -10px, -8px 16px, 12px 8px, center bottom;
  }

  80% {
    background-position: 12px 4px, 6px -12px, -10px -6px, center bottom;
  }
}

/*
 * Front layer: two repeating dot grids + glow (must use repeat on dot layers or the grid vanishes).
 */
body::after {
  content: "";
  position: fixed;
  left: 0;
  right: 0;
  bottom: 0;
  height: var(--docs-footer-veil-height);
  z-index: 0;
  pointer-events: none;
  opacity: calc(var(--docs-footer-veil) * var(--docs-footer-scroll-strength, 1));
  background:
    radial-gradient(circle at 1px 1px,
      color-mix(in srgb, var(--muted) var(--docs-footer-fine-dot-mix), transparent) 1px,
      transparent 0),
    radial-gradient(circle at 1px 1px,
      color-mix(in srgb, var(--line) var(--docs-footer-dot-line-mix), transparent) 1px,
      transparent 0),
    radial-gradient(ellipse 92% 88% at 50% 100%,
      color-mix(in srgb, var(--accent) var(--docs-footer-glow-accent-mix), transparent) 0%,
      transparent 58%),
    linear-gradient(to top,
      color-mix(in srgb, var(--line) 14%, transparent) 0%,
      transparent 36%);
  background-size:
    var(--docs-footer-fine-dot-step) var(--docs-footer-fine-dot-step),
    var(--docs-footer-dot-step) var(--docs-footer-dot-step),
    100% 100%,
    100% 100%;
  background-position: 0 0, 16px 11px, center bottom, center bottom;
  background-repeat: repeat, repeat, no-repeat, no-repeat;
  /*
   * Dots fade in gradually from ~mid-screen (soft mask), strongest at footer.
   */
  mask-image: linear-gradient(to top,
      #000 0%,
      #000 10%,
      #000 32%,
      rgba(0, 0, 0, 0.82) 52%,
      rgba(0, 0, 0, 0.32) 70%,
      rgba(0, 0, 0, 0.07) 86%,
      transparent 100%);
  -webkit-mask-image: linear-gradient(to top,
      #000 0%,
      #000 10%,
      #000 32%,
      rgba(0, 0, 0, 0.82) 52%,
      rgba(0, 0, 0, 0.32) 70%,
      rgba(0, 0, 0, 0.07) 86%,
      transparent 100%);
}

@media (prefers-reduced-motion: no-preference) {
  body::after {
    animation:
      docs-footer-veil-breathe var(--docs-footer-veil-duration) ease-in-out infinite,
      docs-footer-dot-wave var(--docs-footer-wave-duration) cubic-bezier(0.37, 0.02, 0.62, 0.98) infinite;
  }
}

@media (prefers-reduced-motion: reduce) {
  body::after {
    animation: none;
  }
}

@keyframes docs-footer-veil-breathe {

  0%,
  100% {
    opacity: calc(var(--docs-footer-veil) * var(--docs-footer-breathe-min) * var(--docs-footer-scroll-strength, 1));
    transform: translateY(0) scale(1);
  }

  50% {
    opacity: calc(var(--docs-footer-veil) * var(--docs-footer-scroll-strength, 1));
    transform: translateY(-2px) scale(1.005);
  }
}

/* Asymmetric wave (same as pre-GIF): two grids, uneven keyframe spacing */
@keyframes docs-footer-dot-wave {

  0%,
  100% {
    background-position: 0 0, 16px 11px, center bottom, center bottom;
  }

  9% {
    background-position: 17px 3px, -3px 19px, center bottom, center bottom;
  }

  21% {
    background-position: 24px 15px, -19px 23px, center bottom, center bottom;
  }

  34% {
    background-position: 14px 26px, -20px 9px, center bottom, center bottom;
  }

  46% {
    background-position: -9px 22px, 2px -10px, center bottom, center bottom;
  }

  57% {
    background-position: -21px 9px, 19px -5px, center bottom, center bottom;
  }

  68% {
    background-position: -18px -7px, 23px 12px, center bottom, center bottom;
  }

  78% {
    background-position: 4px -5px, 14px 22px, center bottom, center bottom;
  }

  88% {
    background-position: 14px 6px, 6px 16px, center bottom, center bottom;
  }

  95% {
    background-position: 6px 2px, 20px 12px, center bottom, center bottom;
  }
}

/* Keep page chrome above the decorative veil (::after paints after in-flow content by default). */
body>* {
  position: relative;
  z-index: 1;
}

/* Embedded figures / diagrams: never spill past the content column on narrow viewports. */
img,
svg,
video {
  max-width: 100%;
  height: auto;
}

main.container,
.container {
  max-width: 1080px;
  margin: 0 auto;
  padding: 28px 20px 80px;
  min-width: 0;
}

h1,
h2,
h3,
h4,
h5,
h6 {
  line-height: 1.25;
}

h1 {
  margin: 0 0 12px;
  font-size: 2rem;
}

.docs-page-title-row {
  display: flex;
  align-items: center;
  gap: 12px;
  margin: 0 0 16px;
}

.docs-page-title-row > h1 {
  margin: 0;
  flex: 1 1 auto;
  min-width: 0;
}

.docs-page-title-row .top-nav__theme-btn--flashlight {
  flex: 0 0 auto;
  margin-left: auto;
  align-self: center;
}

h2 {
  margin: 28px 0 12px;
  font-size: 1.35rem;
  border-bottom: 1px solid var(--line);
  padding-bottom: 8px;
}

h3 {
  margin: 22px 0 8px;
  font-size: 1.05rem;
  color: var(--accent);
}

p,
li {
  line-height: 1.55;
}

p {
  margin: 10px 0;
}

ul,
ol {
  margin: 8px 0 8px 22px;
}

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

a:hover {
  text-decoration: underline;
}

a:focus-visible,
button:focus-visible,
input:focus-visible,
select:focus-visible,
textarea:focus-visible,
summary:focus-visible {
  outline: 2px solid color-mix(in srgb, var(--accent) 86%, #ffffff);
  outline-offset: 2px;
  box-shadow:
    0 0 0 3px color-mix(in srgb, var(--accent) 28%, transparent),
    0 0 0 1px color-mix(in srgb, var(--accent) 52%, transparent) inset;
}

/* Keyboard accessibility: jump directly to main article content. */
.docs-skip-link {
  position: fixed;
  top: 10px;
  left: 12px;
  z-index: 2401;
  transform: translateY(-160%);
  opacity: 0;
  pointer-events: none;
  border-radius: 999px;
  border: 1px solid color-mix(in srgb, var(--line) 70%, var(--accent));
  background: color-mix(in srgb, var(--card) 96%, #ffffff);
  color: var(--text);
  padding: 7px 12px;
  font-size: 0.82rem;
  font-weight: 700;
  text-decoration: none;
  box-shadow: 0 10px 22px rgba(2, 6, 23, 0.2);
  transition: transform 140ms cubic-bezier(0.22, 1, 0.36, 1), opacity 120ms ease;
}

.docs-skip-link:focus-visible {
  transform: translateY(0);
  opacity: 1;
  pointer-events: auto;
}

/* Inline code only — not inside pre (see pre code below). */
:not(pre)>code {
  background: var(--inline-code-bg);
  padding: 2px 6px;
  border-radius: 6px;
  font-size: 0.92em;
}

pre {
  margin: 12px 0;
  padding: 14px 16px;
  border-radius: 10px;
  overflow: auto;
  line-height: 1.5;
  font-size: 0.9rem;
  tab-size: 2;
  background: var(--pre-bg);
  color: var(--pre-fg);
  border: 1px solid var(--line);
  box-shadow: inset 0 1px 0 var(--pre-inset-shadow);
}

/* Avoid nested <code> fighting with pre (was: light box on dark pre → unreadable). */
pre code {
  background: transparent;
  color: inherit;
  padding: 0;
  border-radius: 0;
  font-size: inherit;
  font-family: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", monospace;
}

.lead {
  color: var(--muted);
  margin-bottom: 18px;
}

.small {
  font-size: 0.9rem;
  color: var(--muted);
}

.card {
  background: var(--card);
  border: 1px solid var(--line);
  border-radius: 14px;
  padding: 16px 18px;
  margin: 12px 0;
  box-shadow: var(--card-shadow);
  min-width: 0;
  max-width: 100%;
}

.badge {
  display: inline-block;
  border: 1px solid var(--line);
  border-radius: 999px;
  padding: 3px 10px;
  margin: 2px 6px 2px 0;
  font-size: 0.85rem;
  background: var(--badge-default-bg);
}

/* ADR and status badges — calm contrast (readable on light background). */
.badge--success {
  background: var(--badge-success-bg);
  border-color: var(--badge-success-border);
  color: var(--badge-success-text);
}

.badge--warning {
  background: var(--badge-warning-bg);
  border-color: var(--badge-warning-border);
  color: var(--badge-warning-text);
}

.badge--muted {
  background: var(--badge-muted-bg);
  border-color: var(--badge-muted-border);
  color: var(--badge-muted-text);
}

.badge--danger {
  background: var(--badge-danger-bg);
  border-color: var(--badge-danger-border);
  color: var(--badge-danger-text);
}

.adr-meta {
  margin: 10px 0 14px;
  line-height: 1.7;
}

/* ADR status tracks: per-axis stepper (green = done, yellow = current, gray = not yet, red = blocked). */
.adr-status-tracks {
  display: flex;
  flex-direction: column;
  gap: 12px;
  margin: 12px 0 18px;
  padding: 14px 16px;
  border: 1px solid var(--line);
  border-radius: 10px;
  background: var(--adr-status-tracks-bg);
}

.adr-status-tracks--example {
  margin-top: 0;
  margin-bottom: 18px;
}

p.adr-track-branch-note {
  margin: 0 0 12px;
}

.adr-track {
  display: flex;
  flex-wrap: wrap;
  align-items: center;
  gap: 10px 14px;
}

.adr-track-label {
  flex: 0 0 8.5rem;
  font-size: 0.8rem;
  font-weight: 600;
  color: var(--adr-track-label-color);
  text-transform: uppercase;
  letter-spacing: 0.04em;
}

.adr-steps {
  display: flex;
  flex-wrap: wrap;
  align-items: center;
  gap: 0;
  list-style: none;
  padding: 0;
  margin: 0;
}

.adr-steps>li {
  display: inline-flex;
  align-items: center;
  font-size: 0.85rem;
  line-height: 1.3;
}

.adr-steps>li+li::before {
  content: "→";
  color: var(--adr-step-arrow);
  font-size: 0.75rem;
  margin: 0 0.45rem;
  font-weight: normal;
}

.adr-step {
  border-radius: 8px;
  padding: 4px 10px;
  border: 1px solid var(--adr-step-border);
  background: var(--adr-step-bg);
  color: var(--adr-step-text);
}

.adr-step--done {
  background: var(--adr-step-done-bg);
  border-color: var(--adr-step-done-border);
  color: var(--adr-step-done-text);
}

.adr-step--current {
  background: var(--adr-step-current-bg);
  border-color: var(--adr-step-current-border);
  color: var(--adr-step-current-text);
  font-weight: 600;
}

.adr-step--todo {
  background: var(--adr-step-todo-bg);
  border-color: var(--adr-step-todo-border);
  color: var(--adr-step-todo-text);
}

/* Neutral gray: default “current” for Draft / Not started, or Accepted when Superseded is the final green step. */
.adr-step--muted {
  background: var(--adr-step-muted-bg);
  border-color: var(--adr-step-muted-border);
  color: var(--adr-step-muted-text);
  font-weight: 500;
}

.adr-step--blocked {
  background: var(--adr-step-blocked-bg);
  border-color: var(--adr-step-blocked-border);
  color: var(--adr-step-blocked-text);
  font-weight: 600;
}

@media (max-width: 640px) {
  .adr-track-label {
    flex: 1 1 100%;
  }
}

/* ADR / RFC: current status + linear status log (docs-nav.js: data-adr-weight or data-rfc-weight on <main>) */
@property --adr-status-border-angle {
  syntax: "<angle>";
  inherits: false;
  initial-value: 0deg;
}

.adr-current-status {
  --adr-status-border-angle: 0deg;
  margin: 0;
  display: inline-flex;
  align-items: center;
  gap: 0.1rem;
  width: fit-content;
  max-width: 100%;
  padding: 7px 12px;
  border: 2px solid transparent;
  border-radius: 999px;
  background: linear-gradient(var(--adr-cs-base-bg), var(--adr-cs-base-bg)) padding-box;
  position: sticky;
  top: 0;
  z-index: 6;
  font-size: 0.95rem;
  animation: adr-status-border-sweep 10s linear infinite;
}

.adr-current-status__label {
  color: var(--adr-cs-label);
  margin-right: 0.35em;
}

.adr-current-status__value {
  color: var(--adr-cs-value);
}

.adr-current-status--draft {
  background:
    linear-gradient(#f1f5f9, #f1f5f9) padding-box,
    conic-gradient(from var(--adr-status-border-angle),
      #64748b 0deg 65deg,
      #cbd5e1 65deg 180deg,
      #64748b 180deg 245deg,
      #cbd5e1 245deg 360deg) border-box;
}

.adr-current-status--ongoing {
  background:
    linear-gradient(#fffbeb, #fffbeb) padding-box,
    conic-gradient(from var(--adr-status-border-angle),
      #b45309 0deg 65deg,
      #fcd34d 65deg 180deg,
      #b45309 180deg 245deg,
      #fcd34d 245deg 360deg) border-box;
}

.adr-current-status--declined {
  background:
    linear-gradient(#fef2f2, #fef2f2) padding-box,
    conic-gradient(from var(--adr-status-border-angle),
      #b91c1c 0deg 65deg,
      #fca5a5 65deg 180deg,
      #b91c1c 180deg 245deg,
      #fca5a5 245deg 360deg) border-box;
}

.adr-current-status--declined .adr-current-status__value {
  color: #7f1d1d;
  font-weight: 700;
}

.adr-current-status--done {
  background:
    linear-gradient(#f0fdf4, #f0fdf4) padding-box,
    conic-gradient(from var(--adr-status-border-angle),
      #15803d 0deg 65deg,
      #86efac 65deg 180deg,
      #15803d 180deg 245deg,
      #86efac 245deg 360deg) border-box;
}

.adr-current-status--done .adr-current-status__value {
  color: #14532d;
  font-weight: 700;
}

.adr-status-row {
  display: flex;
  align-items: flex-start;
  gap: 10px;
  margin: 0 0 18px;
  flex-wrap: wrap;
}

@keyframes adr-status-border-sweep {
  to {
    --adr-status-border-angle: 360deg;
  }
}

@media (prefers-reduced-motion: reduce) {
  .adr-current-status {
    animation: none;
  }
}

details.adr-status-log {
  margin: 0;
  border: 0;
  padding: 0;
  background: transparent;
  position: relative;
}

.adr-status-log__summary {
  cursor: pointer;
  list-style: none;
  display: inline-flex;
  align-items: center;
  gap: 8px;
  min-height: 40px;
  padding: 8px 16px;
  border: 1px solid var(--line);
  border-radius: 999px;
  background: var(--card);
  font-size: 0.82rem;
  font-weight: 700;
  text-transform: uppercase;
  letter-spacing: 0.04em;
  color: var(--adr-status-log-title);
  user-select: none;
}

.adr-status-log__summary::before {
  content: "▾";
  color: var(--muted);
  font-size: 0.8rem;
}

details.adr-status-log[open] > .adr-status-log__summary::before {
  content: "▴";
}

details.adr-status-log[open] > .adr-status-log__summary {
  margin-bottom: 10px;
}

.adr-status-log__panel {
  display: none;
}

.adr-status-log__callout {
  margin: 0;
  padding: 14px 16px;
  border: 1px solid var(--line);
  border-left: 4px solid #f59e0b;
  border-radius: 8px;
  background: color-mix(in srgb, var(--card) 80%, #fef3c7 20%);
  font-size: 0.92rem;
  line-height: 1.45;
}

.adr-status-log__row {
  display: flex;
  flex-wrap: wrap;
  align-items: center;
  gap: 10px;
  margin-top: 0;
  padding: 14px 16px;
}

.adr-status-log[open] .adr-status-log__panel {
  display: block;
  position: absolute;
  top: calc(100% + 6px);
  left: 0;
  width: fit-content;
  min-width: min(560px, calc(100vw - 48px));
  max-width: min(900px, calc(100vw - 48px));
  border: 1px solid var(--line);
  border-radius: 12px;
  background: var(--adr-status-log-bg);
  box-shadow: 0 14px 36px rgba(15, 23, 42, 0.2);
  z-index: 20;
  overflow: hidden;
}

.adr-status-log[open].adr-status-log--align-right .adr-status-log__panel {
  left: auto;
  right: 0;
}

.adr-status-log[open] .adr-status-log__callout,
.adr-status-log[open] .adr-status-log__row {
  border: 0;
  width: 100%;
}

.adr-status-log[open] .adr-status-log__callout {
  border-radius: 0;
  border-bottom: 1px solid var(--line);
}

@media (max-width: 760px) {
  .adr-status-log[open] .adr-status-log__panel {
    position: fixed;
    left: 16px;
    right: 16px;
    top: auto;
    width: auto;
    max-height: min(60vh, 420px);
    overflow: auto;
  }
}

.adr-status-log__row .adr-step {
  font-size: 0.88rem;
  line-height: 1.35;
}

/* Final step when it is the current max: green (see stepKind in docs-nav.js) + clear focus */
.adr-status-log__row .adr-step--done[aria-current="step"] {
  font-weight: 600;
}

/* ADR template: collapsible weight instructions (<details> in 0000-template.html) */
/* docs-theory-help: same chrome for optional “theory background” blocks (e.g. internal README). */
details.adr-weight-help,
details.rfc-weight-help,
details.docs-theory-help {
  margin: 0 0 18px;
  border: 1px solid var(--line);
  border-radius: 10px;
  padding: 10px 14px 12px;
  background: var(--card);
}

details.adr-weight-help summary,
details.rfc-weight-help summary,
details.docs-theory-help summary {
  cursor: pointer;
  font-weight: 600;
  color: var(--details-summary-fg);
}

details.adr-weight-help[open] summary,
details.rfc-weight-help[open] summary,
details.docs-theory-help[open] summary {
  margin-bottom: 8px;
  border-bottom: 1px solid var(--line);
  padding-bottom: 8px;
}

/* Raster diagrams (legacy PNG exports) */
.diagram {
  width: 100%;
  max-width: 960px;
  height: auto;
  border: 1px solid var(--line);
  border-radius: 10px;
  background: var(--diagram-bg);
  padding: 8px;
  margin: 8px 0 6px;
  margin-left: auto;
  margin-right: auto;
  box-sizing: border-box;
}

/* System / C4 diagrams — Mermaid diagram chrome (vector, scalable) */
.sys-diagram {
  margin: 0;
  border: 1px solid var(--line);
  border-radius: 14px;
  overflow: hidden;
  background: var(--sys-diagram-bg);
  box-shadow: var(--sys-diagram-frame-shadow);
}

/* Badge + title share row 1; subtitle spans full width on row 2 (no huge gap beside badge). */
.sys-diagram__head {
  display: grid;
  grid-template-columns: auto minmax(0, 1fr);
  gap: 6px 12px;
  align-items: start;
  padding: 14px 18px 12px;
  border-bottom: 1px solid var(--line);
  background: var(--sys-diagram-head-bg);
}

.sys-diagram__head>.sys-diagram__badge {
  grid-column: 1;
  grid-row: 1;
  align-self: center;
}

.sys-diagram__titles {
  display: contents;
}

.sys-diagram__titles>h3 {
  grid-column: 2;
  grid-row: 1;
  margin: 0;
  align-self: center;
  font-size: 1.05rem;
  font-weight: 650;
  color: var(--text);
  letter-spacing: -0.01em;
  line-height: 1.35;
}

.sys-diagram__titles>.sys-diagram__sub {
  grid-column: 1 / -1;
  grid-row: 2;
  margin: 0;
  margin-top: 4px;
}

/* Sequence diagrams: badge + h3 only (no .sys-diagram__titles wrapper). */
.sys-diagram__head>h3 {
  grid-column: 2;
  grid-row: 1;
  margin: 0;
  align-self: center;
  font-size: 1.05rem;
  font-weight: 650;
  color: var(--text);
  letter-spacing: -0.01em;
  line-height: 1.35;
}

.sys-diagram__badge {
  display: inline-flex;
  align-items: center;
  flex-shrink: 0;
  font-size: 0.7rem;
  font-weight: 700;
  letter-spacing: 0.07em;
  text-transform: uppercase;
  color: var(--sys-diagram-badge-fg);
  background: var(--sys-diagram-badge-bg);
  border: 1px solid var(--sys-diagram-badge-border);
  border-radius: 8px;
  padding: 5px 11px;
}

.sys-diagram__sub {
  font-size: 0.88rem;
  color: var(--muted);
  line-height: 1.45;
}

.sys-diagram__canvas {
  padding: 22px 14px 26px;
  overflow-x: auto;
  background: var(--sys-diagram-canvas-bg);
}

.sys-diagram__canvas .mermaid {
  display: flex;
  justify-content: center;
  align-items: flex-start;
}

.sys-diagram__canvas svg {
  max-width: 100%;
  height: auto;
}

/* PlantUML SVG: keep **intrinsic** width/height — do not ``width: 100%`` or narrow diagrams
   (e.g. sparse sequences) scale up in the column and look like a larger font than wide SVGs.
   Wide exports are capped in style.puml; users zoom via expand/lightbox (docs-diagram-lightbox.js). */
.sys-diagram__canvas img {
  display: block;
  width: auto;
  max-width: min(960px, 100%);
  height: auto;
  margin: 0 auto;
  border: none;
  padding: 0;
  box-shadow: none;
  background: transparent;
}

/* Override ``.diagram { width: 100% }`` (higher specificity) so PlantUML SVGs keep intrinsic size. */
.sys-diagram__canvas img.diagram {
  width: auto;
  max-width: min(960px, 100%);
  box-sizing: content-box;
}

/* Avoid double frame: outer .sys-diagram already has a border; strip .diagram chrome here. */
.sys-diagram__canvas img.diagram--uml {
  border: none;
  padding: 0;
  background: transparent;
}

/* Wrapper for UML diagram + expand control (see docs-diagram-lightbox.js). */
.diagram-uml-wrap {
  position: relative;
}

.diagram-expand-btn {
  position: absolute;
  top: 8px;
  right: 8px;
  z-index: 1;
  padding: 6px 12px;
  font-size: 0.8rem;
  line-height: 1.2;
  cursor: pointer;
  border-radius: 8px;
  border: 1px solid var(--line);
  background: var(--card);
  color: var(--text);
  box-shadow: 0 1px 2px rgba(15, 23, 42, 0.08);
}

.diagram-expand-btn:hover {
  border-color: var(--accent);
  color: var(--accent);
}

body.docs-diagram-lightbox-open {
  overflow: hidden;
}

.docs-diagram-lightbox {
  position: fixed;
  inset: 0;
  z-index: 10000;
  display: flex;
  align-items: center;
  justify-content: center;
  padding: min(24px, 4vw);
}

.docs-diagram-lightbox[hidden] {
  display: none;
}

.docs-diagram-lightbox__backdrop {
  position: absolute;
  inset: 0;
  margin: 0;
  padding: 0;
  border: none;
  cursor: pointer;
  background: rgba(15, 23, 42, 0.82);
}

/* Panel: fixed footprint; toolbar + viewport so zoom/pan has room (docs-diagram-lightbox.js). */
.docs-diagram-lightbox__panel {
  position: relative;
  z-index: 1;
  box-sizing: border-box;
  width: min(96vw, 1400px);
  height: min(92vh, 900px);
  max-height: 96vh;
  display: flex;
  flex-direction: column;
  align-items: stretch;
  padding: 8px;
}

.docs-diagram-lightbox__close {
  position: absolute;
  top: -12px;
  right: -12px;
  z-index: 2;
  width: 40px;
  height: 40px;
  padding: 0;
  font-size: 1.5rem;
  line-height: 1;
  cursor: pointer;
  border-radius: 999px;
  border: 1px solid var(--line);
  background: var(--card);
  color: var(--text);
}

.docs-diagram-lightbox__toolbar {
  display: flex;
  flex-wrap: wrap;
  align-items: center;
  gap: 8px;
  flex-shrink: 0;
  padding: 8px 44px 10px 10px;
  margin: 0 0 4px 0;
  border-radius: 8px;
  border: 1px solid var(--line);
  background: var(--card);
  box-shadow: 0 1px 2px rgba(15, 23, 42, 0.06);
}

.docs-diagram-lightbox__tool-btn {
  padding: 6px 12px;
  font-size: 0.85rem;
  line-height: 1.2;
  font-weight: 600;
  cursor: pointer;
  border-radius: 8px;
  border: 1px solid var(--line);
  background: var(--card);
  color: var(--text);
  box-shadow: 0 1px 2px rgba(15, 23, 42, 0.06);
}

.docs-diagram-lightbox__tool-btn:hover {
  border-color: var(--accent);
  color: var(--accent);
  background: var(--table-th-bg, var(--card));
}

.docs-diagram-lightbox__hint {
  font-size: 0.75rem;
  color: var(--muted);
  margin-left: auto;
  user-select: none;
}

.docs-diagram-lightbox__viewport {
  flex: 1 1 auto;
  min-height: 0;
  position: relative;
  overflow: hidden;
  display: flex;
  align-items: center;
  justify-content: center;
  cursor: grab;
  touch-action: none;
  border-radius: 8px;
  border: 1px solid var(--line);
  background: var(--card);
}

.docs-diagram-lightbox__viewport.is-panning {
  cursor: grabbing;
}

.docs-diagram-lightbox__stage {
  transform-origin: center center;
  will-change: transform;
}

.docs-diagram-lightbox__img {
  display: block;
  box-sizing: border-box;
  margin: 0;
  max-width: min(88vw, 1280px);
  max-height: min(78vh, 820px);
  width: auto;
  height: auto;
  object-fit: contain;
  object-position: center;
  /* Let viewport receive wheel / drag */
  pointer-events: none;
  user-select: none;
}

.sys-diagram__foot {
  margin: 0;
  padding: 12px 18px 14px;
  font-size: 0.85rem;
  color: var(--muted);
  border-top: 1px solid var(--line);
  background: var(--sys-diagram-foot-bg);
  line-height: 1.55;
}

.sys-diagram__foot a {
  color: var(--accent);
}

.sys-diagram__foot code {
  font-size: 0.88em;
}

/* Horizontal scroll for wide tables (narrow viewports, long code cells). */
.docs-table-scroll {
  overflow-x: auto;
  -webkit-overflow-scrolling: touch;
  margin: 10px 0;
  border-radius: 10px;
  border: 1px solid var(--line);
  background: var(--table-bg);
}

.docs-table-scroll table {
  width: max-content;
  min-width: 100%;
  margin: 0;
}

/* FR/NFR (system-design): fixed ID column; base table uses max-content which breaks % widths. */
.docs-table-scroll.docs-table--req table {
  width: 100%;
  table-layout: fixed;
  min-width: 100%;
}

.docs-table-scroll.docs-table--req col.docs-table__col--id {
  width: 7rem;
}

.docs-table-scroll.docs-table--req col.docs-table__col--req {
  width: 22%;
}

.docs-table-scroll.docs-table--req th:first-child,
.docs-table-scroll.docs-table--req td:first-child {
  white-space: nowrap;
}

/* Stacked endpoint rows (internal API docs): replaces wide 5-column tables. */
.api-endpoint-list {
  margin: 14px 0 0;
  border: 1px solid var(--line);
  border-radius: 10px;
  overflow: hidden;
  background: var(--table-bg);
}

.api-endpoint {
  padding: 14px 16px;
  border-bottom: 1px solid var(--line);
}

.api-endpoint:last-child {
  border-bottom: none;
}

.api-endpoint__title {
  margin: 0 0 10px;
  font-size: 1.02rem;
  font-weight: 650;
  line-height: 1.4;
  color: var(--text);
  border-bottom: none;
  padding-bottom: 0;
}

.api-endpoint__title code {
  font-size: 0.92em;
}

.api-endpoint__grid {
  display: grid;
  grid-template-columns: minmax(108px, 132px) minmax(0, 1fr);
  gap: 8px 14px;
  margin: 0;
  font-size: 0.93rem;
}

.api-endpoint__grid dt {
  margin: 0;
  color: var(--muted);
  font-weight: 600;
}

.api-endpoint__grid dd {
  margin: 0;
  word-break: break-word;
  overflow-wrap: anywhere;
}

table {
  width: 100%;
  border-collapse: collapse;
  margin: 10px 0;
  background: var(--table-bg);
  border: 1px solid var(--line);
  border-radius: 10px;
  overflow: hidden;
}

th,
td {
  border-bottom: 1px solid var(--line);
  text-align: left;
  vertical-align: top;
  padding: 10px 12px;
  font-size: 0.95rem;
}

th {
  background: var(--table-th-bg);
  font-weight: 600;
}

/*
 * Hand-authored docs (`main.container`, not pdoc): keep tables in the content column on narrow viewports.
 * Skip: .docs-table-scroll (horizontal scroll region), audit score/reference tables (own layout + wrapper).
 */
main.container:not(.container--swagger) :not(.docs-table-scroll)>table:not(.audit-ref-table):not(.audit-score-table):not(.audit-gap-table) {
  table-layout: fixed;
  width: 100%;
  max-width: 100%;
}

main.container:not(.container--swagger) :not(.docs-table-scroll)>table:not(.audit-ref-table):not(.audit-score-table):not(.audit-gap-table) th,
main.container:not(.container--swagger) :not(.docs-table-scroll)>table:not(.audit-ref-table):not(.audit-score-table):not(.audit-gap-table) td {
  overflow-wrap: anywhere;
  word-break: break-word;
}

main.container:not(.container--swagger) :not(.docs-table-scroll)>table:not(.audit-ref-table):not(.audit-score-table):not(.audit-gap-table) :not(pre)>code {
  white-space: pre-wrap;
  overflow-wrap: anywhere;
  word-break: break-word;
}

/* Assessment Table 2 — score column + legend layout (normative copy: audit-score-legend-fragment.html; ADR 0024). */

.audit-score-table td.score-excellent,
.audit-score-table td.score-good,
.audit-score-table td.score-needs-attention,
.audit-score-table td.score-neutral {
  font-weight: 600;
  text-align: center;
  border-left: 3px solid transparent;
}

.audit-score-table td.score-excellent {
  background-color: var(--audit-score-excellent-bg);
  border-left-color: var(--audit-score-excellent-border);
}

.audit-score-table td.score-good {
  background-color: var(--audit-score-good-bg);
  border-left-color: var(--audit-score-good-border);
}

/* 1–6 / gaps — same visual (alias: score-neutral kept for older HTML) */
.audit-score-table td.score-needs-attention,
.audit-score-table td.score-neutral {
  background-color: var(--audit-score-needs-bg);
  border-left-color: var(--audit-score-needs-border);
}

aside.audit-score-legend {
  margin: 1rem 0 1.25rem;
  padding: 0.85rem 1rem 1rem;
  border: 1px solid var(--audit-score-legend-border);
  border-radius: 8px;
  background: var(--audit-score-legend-bg);
}

.audit-score-legend-title {
  margin: 0 0 0.5rem;
  font-size: 1.05rem;
  color: var(--text);
}

.audit-score-legend-intro {
  margin: 0 0 0.65rem;
  font-size: 0.92rem;
  color: var(--muted);
  line-height: 1.5;
}

ul.audit-score-legend-bands {
  list-style: none;
  margin: 0;
  padding: 0;
}

.audit-score-legend-bands li {
  display: flex;
  align-items: flex-start;
  gap: 0.6rem;
  margin: 0.45rem 0 0;
  line-height: 1.45;
  font-size: 0.92rem;
}

.audit-score-swatch {
  width: 1.15rem;
  height: 1.15rem;
  min-width: 1.15rem;
  border-radius: 4px;
  margin-top: 0.15rem;
  border: 1px solid rgba(0, 0, 0, 0.12);
  box-sizing: border-box;
}

.audit-score-swatch.score-excellent {
  background: var(--audit-score-excellent-bg);
  border-color: var(--audit-score-excellent-border);
}

.audit-score-swatch.score-good {
  background: var(--audit-score-good-bg);
  border-color: var(--audit-score-good-border);
}

.audit-score-swatch.score-needs-attention {
  background: var(--audit-score-needs-bg);
  border-color: var(--audit-score-needs-border);
}

/* Placeholder before docs-nav.js injects the legend from audit-score-legend-fragment.html */
.audit-score-legend-include {
  min-height: 1px;
}

p.audit-score-legend-noscript,
p.audit-score-legend-error {
  margin: 0.75rem 0;
  padding: 0.65rem 0.85rem;
  font-size: 0.9rem;
  color: var(--muted);
  background: var(--audit-legend-warn-bg);
  border: 1px solid var(--line);
  border-radius: 6px;
}

p.audit-score-legend-error {
  background: var(--audit-legend-error-bg);
  color: var(--audit-legend-error-fg);
}

/* Table 2 — optional justification column (why this score vs reference) */
.audit-score-table td.audit-table-justification {
  font-size: 0.92rem;
  line-height: 1.45;
  color: var(--muted);
  max-width: 22rem;
}

/* Weighted / formula summary blocks */
.audit-scoring-formula {
  margin: 0.75rem 0 1rem;
  padding: 0.85rem 1rem;
  font-family: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace;
  font-size: 0.88rem;
  line-height: 1.55;
  white-space: pre-wrap;
  overflow-wrap: anywhere;
  word-break: break-word;
  background: var(--inline-code-bg);
  border: 1px solid var(--line);
  border-radius: 8px;
  color: var(--text);
}

/* Top gaps — workflow status (distinct from score column colours) */
table.audit-gap-table {
  width: 100%;
  border-collapse: collapse;
  font-size: 0.92rem;
}

table.audit-gap-table th,
table.audit-gap-table td {
  border: 1px solid var(--line);
  padding: 0.5rem 0.65rem;
  vertical-align: top;
  text-align: left;
}

table.audit-gap-table th {
  background: var(--table-th-bg);
}

.audit-gap-table td.audit-gap-status {
  font-weight: 600;
  text-align: center;
  white-space: nowrap;
}

.audit-gap-table td.audit-gap-status--todo {
  background: #e9ecef;
  border-left: 3px solid #6c757d;
  color: #343a40;
}

.audit-gap-table td.audit-gap-status--inprogress {
  background: #fff3cd;
  border-left: 3px solid #e0a800;
  color: #664d03;
}

.audit-gap-table td.audit-gap-status--done {
  background: #d1e7dd;
  border-left: 3px solid #198754;
  color: #0a3622;
}

/* openapi/openapi-explorer.html — OpenAPI (test), Swagger UI browse-only */
main.container--swagger {
  max-width: min(1240px, 100%);
}

main.container--swagger #swagger-ui {
  min-height: 72vh;
  margin-top: 16px;
}

/* Long-form docs: sticky “On this page” TOC (e.g. internal/system-design.html) */
main.container.docs-page-layout {
  max-width: min(1240px, 100%);
}

/* Offset so in-page links don’t hide under browser UI */
main.docs-page-layout [id] {
  scroll-margin-top: 1.25rem;
}

.docs-page-layout__inner {
  display: grid;
  grid-template-columns: min(260px, 30%) minmax(0, 1fr);
  gap: 2rem 1.75rem;
  align-items: start;
}

/* Auto TOC: pages with only h1/lead (e.g. openapi/openapi-explorer.html) have no sidebar — use full width */
.docs-page-layout__inner--single {
  grid-template-columns: minmax(0, 1fr);
}

/* DOM order is article then aside; order places the sticky TOC in the first column (left). */
.docs-page-layout__article {
  min-width: 0;
  order: 2;
}

.docs-inpage-toc {
  order: 1;
  position: sticky;
  top: 1rem;
  padding: 6px 0 0;
  background: transparent;
  border: 0;
  border-radius: 0;
  font-size: 0.9rem;
  box-shadow: none;
  backdrop-filter: none;
  -webkit-backdrop-filter: none;
}

.docs-inpage-toc__title {
  margin: 0 0 8px;
  font-size: 0.74rem;
  font-weight: 700;
  text-transform: uppercase;
  letter-spacing: 0.045em;
  color: var(--muted);
  padding: 0 0 0 8px;
  border-bottom: 0;
}

.docs-inpage-toc__title::before {
  content: none;
}

/* Long outlines (e.g. backlog): keep the box on-screen; scroll links inside it */
.docs-inpage-toc nav {
  max-height: min(75vh, 36rem);
  overflow-y: auto;
  overscroll-behavior: contain;
}

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

.docs-inpage-toc nav li {
  margin: 5px 0;
  line-height: 1.35;
}

.docs-inpage-toc nav li.docs-inpage-toc__item--nested {
  padding-left: 0.75rem;
}

.docs-inpage-toc nav a {
  display: block;
  padding: 4px 8px;
  margin: 1px 0;
  border-left: 2px solid transparent;
  border-radius: 0;
  color: var(--text);
  text-decoration: none;
  transition:
    color 0.16s ease,
    border-left-color 0.16s ease;
}

.docs-inpage-toc nav a:hover {
  color: var(--accent);
  border-left-color: var(--accent);
}

.docs-inpage-toc nav a.docs-inpage-toc__link--active {
  font-weight: 650;
  color: var(--accent);
  border-left-color: var(--accent);
  box-shadow: none;
}

/* Global docs search (docs-nav.js + docs/assets/search-index.json). */
.docs-search {
  position: relative;
  margin-top: 12px;
}

.docs-search__label {
  display: block;
  font-size: 0.8rem;
  color: var(--muted);
  margin-bottom: 6px;
}

.docs-search__input {
  width: 100%;
  border: 1px solid var(--line);
  border-radius: 10px;
  padding: 10px 12px;
  font-size: 0.95rem;
  background: var(--search-panel-bg);
  color: var(--text);
  transition: border-color var(--motion-fast) var(--motion-ease-premium), box-shadow var(--motion-fast) var(--motion-ease-premium);
}

.docs-search__input:focus-visible {
  outline: none;
  border-color: var(--accent);
  box-shadow: var(--focus-ring);
}

.docs-search__input::placeholder {
  color: var(--docs-placeholder);
}

.docs-search__chips {
  margin-top: 8px;
  display: flex;
  flex-wrap: wrap;
  gap: 6px;
}

.docs-search__chip {
  border: 1px solid var(--line);
  border-radius: 999px;
  background: color-mix(in srgb, var(--search-panel-bg) 86%, var(--card));
  color: var(--muted);
  font-size: 0.74rem;
  font-weight: 700;
  letter-spacing: 0.03em;
  padding: 4px 10px;
  cursor: pointer;
}

.docs-search__chip.is-active {
  border-color: color-mix(in srgb, var(--accent) 55%, var(--line));
  color: color-mix(in srgb, var(--accent) 74%, var(--text));
  background: color-mix(in srgb, var(--accent) 12%, var(--search-panel-bg));
}

.docs-search__results {
  list-style: none;
  margin: 8px 0 0;
  padding: 8px;
  background: var(--search-panel-bg);
  border: 1px solid var(--line);
  border-radius: 10px;
  box-shadow: var(--search-results-shadow);
  max-height: 360px;
  overflow-y: auto;
}

.docs-search__result-link {
  display: block;
  padding: 8px 10px;
  border-radius: 8px;
  border: 1px solid transparent;
  color: var(--text);
  text-decoration: none;
  transition: border-color var(--motion-fast) var(--motion-ease-premium), box-shadow var(--motion-fast) var(--motion-ease-premium), transform var(--motion-fast) var(--motion-ease-premium);
}

.docs-search__result-link:hover,
.docs-search__result-link--active {
  background: var(--search-result-hover-bg);
  border-color: var(--search-result-hover-border);
  box-shadow: var(--shadow-premium-sm);
  transform: translateY(-1px);
  text-decoration: none;
}

.docs-search__result-title {
  display: block;
  font-weight: 600;
}

.docs-search__result-top {
  display: flex;
  align-items: center;
  justify-content: space-between;
  gap: 8px;
}

.docs-search__result-kind {
  flex: 0 0 auto;
  display: inline-flex;
  align-items: center;
  border-radius: 999px;
  padding: 2px 8px;
  font-size: 0.7rem;
  font-weight: 700;
  letter-spacing: 0.02em;
  color: color-mix(in srgb, var(--accent, #2563eb) 82%, #0f172a);
  background: color-mix(in srgb, var(--accent, #2563eb) 16%, transparent);
  border: 1px solid color-mix(in srgb, var(--accent, #2563eb) 34%, transparent);
}

.docs-search__result-meta {
  display: block;
  margin-top: 2px;
  font-size: 0.82rem;
  color: var(--muted);
}

.docs-search__result-preview {
  display: block;
  margin-top: 4px;
  font-size: 0.85rem;
  color: var(--search-result-preview);
  line-height: 1.35;
}

.docs-search__match {
  padding: 0 0.18em;
  border-radius: 4px;
  background: color-mix(in srgb, var(--accent) 20%, transparent);
  color: color-mix(in srgb, var(--accent) 78%, var(--text));
}

.docs-search__empty,
.docs-search__status {
  padding: 10px 12px;
  color: var(--muted);
  font-size: 0.9rem;
}

.docs-search__empty-title {
  margin: 0;
  color: var(--text);
  font-weight: 700;
}

.docs-search__empty-tips {
  margin: 8px 0 0;
  padding-left: 18px;
  line-height: 1.35;
}

.docs-search__didyoumean {
  margin: 8px 0 0;
  font-size: 0.84rem;
  color: var(--muted);
}

.docs-search__didyoumean-action,
.docs-search__related-query {
  border: 1px solid color-mix(in srgb, var(--line) 86%, var(--accent));
  border-radius: 999px;
  background: color-mix(in srgb, var(--search-panel-bg) 90%, var(--card));
  color: color-mix(in srgb, var(--accent) 70%, var(--text));
  font-size: 0.78rem;
  font-weight: 650;
  padding: 2px 9px;
  cursor: pointer;
}

.docs-search__didyoumean-action:hover,
.docs-search__related-query:hover {
  border-color: var(--accent);
}

.docs-search__related-queries {
  margin: 10px 0 0;
  font-size: 0.82rem;
  color: var(--muted);
  display: flex;
  flex-wrap: wrap;
  align-items: center;
  gap: 6px;
}

.docs-search__empty-actions {
  margin-top: 10px;
  display: flex;
  flex-wrap: wrap;
  gap: 8px;
}

.docs-search__empty-action {
  display: inline-flex;
  align-items: center;
  justify-content: center;
  min-height: 32px;
  padding: 6px 10px;
  border-radius: 999px;
  border: 1px solid var(--line);
  background: color-mix(in srgb, var(--search-panel-bg) 82%, #ffffff 18%);
  color: var(--text);
  text-decoration: none;
  font-size: 0.82rem;
  font-weight: 600;
  cursor: pointer;
}

.docs-search__empty-action:hover {
  border-color: var(--accent);
  color: var(--accent);
  text-decoration: none;
}

.docs-search__empty-action--clear {
  background: color-mix(in srgb, var(--accent) 14%, var(--search-panel-bg) 86%);
}

.docs-reading-progress {
  position: fixed;
  top: 0;
  left: 0;
  width: 100%;
  height: 3px;
  z-index: 60;
  pointer-events: none;
  background: color-mix(in srgb, var(--line, #dbe3ef) 66%, transparent);
  opacity: 1;
  transition: opacity var(--motion-fast) var(--motion-ease-premium);
}

.docs-reading-progress.is-hidden {
  opacity: 0;
}

.docs-reading-progress__fill {
  display: block;
  width: 100%;
  height: 100%;
  transform: scaleX(0);
  transform-origin: left center;
  background: linear-gradient(90deg,
      color-mix(in srgb, var(--accent, #2563eb) 88%, #0ea5e9) 0%,
      color-mix(in srgb, var(--accent, #2563eb) 78%, #22c55e) 100%);
}

.docs-search__status--error {
  color: #7f1d1d;
}

/* Theme cycle pillow toast (docs-nav.js `showDocsThemePillowToast`). */
.docs-theme-toast-host {
  position: fixed;
  top: max(14px, env(safe-area-inset-top, 0px));
  left: 50%;
  transform: translateX(-50%);
  z-index: 2400;
  pointer-events: none;
  display: flex;
  justify-content: center;
  width: min(440px, calc(100vw - 28px));
}

.docs-theme-toast--pillow {
  max-width: 100%;
  padding: 11px 20px 12px;
  font-size: 0.9rem;
  font-weight: 600;
  line-height: 1.35;
  letter-spacing: 0.01em;
  text-align: center;
  color: var(--text);
  border-radius: 999px;
  border: 1px solid color-mix(in srgb, var(--line) 70%, transparent);
  background: color-mix(in srgb, var(--card) 88%, transparent);
  box-shadow:
    0 10px 28px color-mix(in srgb, var(--text) 10%, transparent),
    0 2px 10px color-mix(in srgb, var(--accent) 8%, transparent),
    inset 0 1px 0 color-mix(in srgb, #fff 55%, transparent);
  backdrop-filter: blur(10px);
  -webkit-backdrop-filter: blur(10px);
  opacity: 0;
  transform: translateY(-12px) scale(0.96);
  transition:
    opacity 0.28s ease,
    transform 0.36s cubic-bezier(0.22, 1, 0.36, 1);
}

:root[data-theme="dark"] .docs-theme-toast--pillow {
  box-shadow:
    0 12px 32px rgba(0, 0, 0, 0.45),
    0 2px 12px color-mix(in srgb, var(--accent) 14%, transparent),
    inset 0 1px 0 color-mix(in srgb, #fff 8%, transparent);
  background: color-mix(in srgb, var(--card) 78%, transparent);
}

:root[data-theme="dark"] {
  --docs-premium-surface-border: color-mix(in srgb, var(--line) 54%, var(--accent));
  --docs-premium-surface-bg:
    linear-gradient(168deg,
      color-mix(in srgb, var(--card) 88%, #0b1220 12%) 0%,
      color-mix(in srgb, var(--card) 82%, #070b14 18%) 52%,
      color-mix(in srgb, var(--card) 76%, #050810 24%) 100%);
  --docs-premium-surface-shadow:
    0 24px 56px rgba(0, 0, 0, 0.48),
    0 1px 0 color-mix(in srgb, #fff 10%, transparent) inset,
    0 0 0 1px color-mix(in srgb, var(--accent) 16%, transparent);
  --docs-premium-chip-bg: color-mix(in srgb, var(--card) 88%, #0a1220 12%);
  --docs-premium-chip-border: color-mix(in srgb, var(--line) 60%, var(--accent));
  --docs-premium-item-border: color-mix(in srgb, var(--line) 54%, transparent);
  --docs-premium-item-bg:
    linear-gradient(180deg,
      color-mix(in srgb, var(--card) 86%, #0b1220 14%) 0%,
      color-mix(in srgb, var(--card) 80%, #070b14 20%) 100%);
  --docs-premium-item-hover-bg:
    linear-gradient(180deg,
      color-mix(in srgb, var(--accent) 18%, var(--card)) 0%,
      color-mix(in srgb, var(--accent) 10%, var(--card)) 100%);
  --docs-premium-item-active-bg:
    linear-gradient(145deg,
      color-mix(in srgb, var(--accent) 24%, var(--card)) 0%,
      color-mix(in srgb, var(--accent) 12%, var(--card)) 100%);
  --docs-premium-focus-glow-soft: color-mix(in srgb, var(--accent) 18%, transparent);
  --docs-premium-focus-glow-strong: color-mix(in srgb, var(--accent) 36%, transparent);
}

/* Premium parity for dark theme: quick actions, tips, floating cards, and feedback UI. */
:root[data-theme="dark"] .docs-page-actions__link,
:root[data-theme="dark"] .docs-page-actions__button {
  border-color: var(--docs-premium-chip-border);
  background: var(--docs-premium-chip-bg);
  color: color-mix(in srgb, var(--text) 92%, #fff 8%);
}

:root[data-theme="dark"] .docs-page-actions__link:hover,
:root[data-theme="dark"] .docs-page-actions__button:hover {
  border-color: color-mix(in srgb, var(--accent) 78%, var(--line));
  box-shadow:
    0 8px 18px rgba(0, 0, 0, 0.3),
    0 0 0 1px color-mix(in srgb, var(--accent) 20%, transparent) inset;
}

:root[data-theme="dark"] .docs-quick-actions__backdrop {
  background:
    radial-gradient(1200px 660px at 12% -12%, color-mix(in srgb, var(--accent) 28%, transparent) 0%, transparent 48%),
    radial-gradient(920px 560px at 88% 118%, rgba(56, 189, 248, 0.18), transparent 52%),
    rgba(2, 6, 23, 0.62);
  backdrop-filter: blur(4px) saturate(1.08);
}

:root[data-theme="dark"] .docs-quick-actions__panel {
  border-color: var(--docs-premium-surface-border);
  background: var(--docs-premium-surface-bg);
  box-shadow: var(--docs-premium-surface-shadow);
}

:root[data-theme="dark"] .docs-quick-actions__title {
  color: color-mix(in srgb, var(--text) 94%, #fff 6%);
}

:root[data-theme="dark"] .docs-quick-actions__kbd-hint {
  color: color-mix(in srgb, var(--muted) 82%, #dbeafe 18%);
}

:root[data-theme="dark"] .docs-quick-actions__filter {
  border-color: color-mix(in srgb, var(--line) 56%, var(--accent));
  background: color-mix(in srgb, var(--card) 84%, #0a1220 16%);
}

:root[data-theme="dark"] .docs-quick-actions__filter:focus-visible {
  border-color: color-mix(in srgb, var(--accent) 82%, #93c5fd);
  box-shadow:
    var(--focus-ring),
    0 0 0 1px var(--docs-premium-focus-glow-strong),
    0 0 0 6px var(--docs-premium-focus-glow-soft);
}

:root[data-theme="dark"] .docs-quick-actions__list a,
:root[data-theme="dark"] .docs-quick-actions__list button {
  border-color: var(--docs-premium-item-border);
  background: var(--docs-premium-item-bg);
}

:root[data-theme="dark"] .docs-quick-actions__item-glyph {
  color: color-mix(in srgb, var(--accent) 74%, #dbeafe);
  background: color-mix(in srgb, var(--accent) 22%, transparent);
  border-color: color-mix(in srgb, var(--accent) 44%, transparent);
}

:root[data-theme="dark"] .docs-quick-actions__item-pill {
  border-color: color-mix(in srgb, var(--line) 60%, var(--accent));
  color: color-mix(in srgb, var(--muted) 68%, #dbeafe 32%);
  background: color-mix(in srgb, var(--card) 88%, #0a1220 12%);
}

:root[data-theme="dark"] .docs-quick-actions__item-keycap {
  border-color: color-mix(in srgb, var(--line) 62%, var(--accent));
  color: color-mix(in srgb, var(--muted) 70%, #e2e8f0 30%);
  background: color-mix(in srgb, var(--card) 86%, #0a1220 14%);
}

:root[data-theme="dark"] .docs-quick-actions__list a:hover,
:root[data-theme="dark"] .docs-quick-actions__list button:hover {
  border-color: color-mix(in srgb, var(--accent) 82%, var(--line));
  background: var(--docs-premium-item-hover-bg);
  box-shadow:
    0 12px 26px rgba(0, 0, 0, 0.32),
    0 1px 0 color-mix(in srgb, #fff 12%, transparent) inset;
}

:root[data-theme="dark"] .docs-quick-actions__list a:focus-visible,
:root[data-theme="dark"] .docs-quick-actions__list button:focus-visible {
  box-shadow:
    var(--focus-ring),
    0 0 0 1px var(--docs-premium-focus-glow-strong),
    0 0 0 5px var(--docs-premium-focus-glow-soft);
}

:root[data-theme="dark"] .docs-quick-actions__list a.docs-quick-actions__item--active,
:root[data-theme="dark"] .docs-quick-actions__list button.docs-quick-actions__item--active {
  border-color: color-mix(in srgb, var(--accent) 88%, #93c5fd);
  background: var(--docs-premium-item-active-bg);
  box-shadow:
    var(--focus-ring),
    0 14px 30px rgba(37, 99, 235, 0.22),
    0 1px 0 color-mix(in srgb, #fff 14%, transparent) inset;
}

:root[data-theme="dark"] .docs-hotkey-tip,
:root[data-theme="dark"] .docs-continue-reading {
  border-color: color-mix(in srgb, var(--line) 58%, var(--accent));
  background:
    linear-gradient(170deg,
      color-mix(in srgb, var(--card) 86%, #0a1220 14%) 0%,
      color-mix(in srgb, var(--card) 80%, #070b14 20%) 100%);
  box-shadow:
    0 14px 30px rgba(0, 0, 0, 0.34),
    0 1px 0 color-mix(in srgb, #fff 10%, transparent) inset;
}

:root[data-theme="dark"] .docs-hotkey-tip__close,
:root[data-theme="dark"] .docs-continue-reading__btn {
  border-color: var(--docs-premium-chip-border);
  background: var(--docs-premium-chip-bg);
}

:root[data-theme="dark"] .docs-feedback-card {
  border-color: color-mix(in srgb, var(--line) 58%, var(--accent));
  background:
    linear-gradient(175deg,
      color-mix(in srgb, var(--card) 86%, #0b1220 14%) 0%,
      color-mix(in srgb, var(--card) 80%, #070b14 20%) 100%);
  box-shadow:
    var(--card-shadow),
    0 14px 30px rgba(0, 0, 0, 0.34),
    0 1px 0 color-mix(in srgb, #fff 9%, transparent) inset;
}

:root[data-theme="dark"] .docs-feedback-card__textarea,
:root[data-theme="dark"] .docs-feedback-card__select {
  border-color: color-mix(in srgb, var(--line) 62%, var(--accent));
  background: color-mix(in srgb, var(--card) 88%, #0a1220 12%);
}

:root[data-theme="dark"] .docs-feedback-card__textarea:focus-visible,
:root[data-theme="dark"] .docs-feedback-card__select:focus-visible {
  border-color: color-mix(in srgb, var(--accent) 82%, #93c5fd);
  box-shadow:
    0 0 0 1px color-mix(in srgb, var(--accent) 36%, transparent),
    0 0 0 4px color-mix(in srgb, var(--accent) 18%, transparent);
}

:root[data-theme="dark"] .docs-feedback-card__status--error {
  color: #fca5a5;
}

:root[data-theme="dark"] .docs-feedback-card__status--success {
  color: #86efac;
}

:root[data-theme="dark"] .docs-feedback-card__toast {
  border-color: color-mix(in srgb, var(--accent) 58%, var(--line));
  background: color-mix(in srgb, var(--card) 86%, #0a1220 14%);
  color: color-mix(in srgb, var(--accent) 70%, #dbeafe 30%);
}

.docs-theme-toast--pillow.docs-theme-toast--visible {
  opacity: 1;
  transform: translateY(0) scale(1);
}

.docs-theme-toast--pillow.docs-theme-toast--leaving {
  opacity: 0;
  transform: translateY(-8px) scale(0.98);
  transition-duration: 0.26s, 0.28s;
}

@media (prefers-reduced-motion: reduce) {
  html {
    scroll-behavior: auto !important;
  }

  *,
  *::before,
  *::after {
    animation-duration: 0.01ms !important;
    animation-iteration-count: 1 !important;
    transition-duration: 0.01ms !important;
    transition-delay: 0ms !important;
  }

  .docs-theme-toast--pillow {
    transition: none;
  }
}

.docs-page-actions {
  margin: 0 0 10px;
  display: flex;
  align-items: center;
  flex-wrap: wrap;
  gap: 6px;
}

.docs-page-actions__hint {
  font-size: 0.68rem;
  letter-spacing: 0.04em;
  text-transform: uppercase;
  color: var(--muted);
  opacity: 0.92;
}

.docs-page-actions__link {
  border: 1px solid var(--docs-premium-chip-border);
  border-radius: 10px;
  padding: 4px 9px;
  font-size: 0.76rem;
  color: var(--text);
  text-decoration: none;
  background: var(--docs-premium-chip-bg);
  transition: border-color var(--motion-fast) var(--motion-ease-premium), box-shadow var(--motion-fast) var(--motion-ease-premium), transform var(--motion-fast) var(--motion-ease-premium);
}

.docs-page-actions__button {
  border: 1px solid var(--docs-premium-chip-border);
  border-radius: 10px;
  padding: 4px 9px;
  font-size: 0.76rem;
  color: var(--text);
  background: var(--docs-premium-chip-bg);
  cursor: pointer;
  transition: border-color var(--motion-fast) var(--motion-ease-premium), box-shadow var(--motion-fast) var(--motion-ease-premium), transform var(--motion-fast) var(--motion-ease-premium);
}

.docs-page-actions__link:hover {
  border-color: var(--accent);
  box-shadow: var(--shadow-premium-sm);
  transform: translateY(-1px);
}

.docs-page-actions__button:hover {
  border-color: var(--accent);
  box-shadow: var(--shadow-premium-sm);
  transform: translateY(-1px);
}

.docs-page-actions__link:focus-visible {
  outline: none;
  border-color: var(--accent);
  box-shadow: var(--focus-ring);
}

.docs-page-actions__button:focus-visible {
  outline: none;
  border-color: var(--accent);
  box-shadow: var(--focus-ring);
}

.docs-page-actions__button.docs-page-actions__button--active {
  border-color: var(--accent);
  background: var(--search-result-hover-bg);
  box-shadow: var(--focus-ring);
}

@media (max-width: 760px) {
  .docs-page-actions {
    display: none !important;
  }

  .docs-hotkey-tip {
    display: none !important;
  }

  .docs-continue-reading {
    right: 10px;
    left: 10px;
    max-width: none;
    bottom: max(12px, env(safe-area-inset-bottom, 0px));
  }
}

.docs-quick-actions[hidden] {
  display: none;
}

.docs-quick-actions {
  position: fixed;
  inset: 0;
  z-index: 1300;
  display: grid;
  place-items: start center;
  padding: clamp(12px, 6vh, 72px) 12px 12px;
}

.docs-quick-actions__backdrop {
  position: absolute;
  inset: 0;
  background:
    radial-gradient(1100px 560px at 12% -12%, rgba(37, 99, 235, 0.16), transparent 46%),
    radial-gradient(860px 500px at 88% 118%, rgba(14, 165, 233, 0.12), transparent 50%),
    rgba(2, 6, 23, 0.42);
  backdrop-filter: blur(3px) saturate(1.04);
}

.docs-quick-actions__panel {
  position: relative;
  z-index: 1;
  width: min(560px, 100%);
  max-height: min(74vh, 620px);
  border: 1px solid var(--docs-premium-surface-border);
  border-radius: 12px;
  background: var(--docs-premium-surface-bg);
  box-shadow: var(--docs-premium-surface-shadow);
  padding: 10px;
  display: flex;
  flex-direction: column;
  gap: 8px;
  overflow: hidden;
  animation: docs-quick-actions-enter 240ms cubic-bezier(0.16, 1, 0.3, 1);
}

.docs-quick-actions__title {
  margin: 0;
  font-weight: 740;
  font-size: 0.9rem;
  color: color-mix(in srgb, var(--text) 80%, var(--muted));
  letter-spacing: 0.015em;
}

.docs-quick-actions__head {
  display: flex;
  align-items: baseline;
  justify-content: space-between;
  gap: 10px;
}

.docs-quick-actions__kbd-hint {
  margin: 0;
  font-size: 0.69rem;
  color: color-mix(in srgb, var(--muted) 88%, var(--text));
  opacity: 0.82;
}

.docs-hotkey-tip {
  position: fixed;
  right: max(14px, env(safe-area-inset-right, 0px));
  bottom: max(14px, env(safe-area-inset-bottom, 0px));
  z-index: 90;
  display: flex;
  align-items: center;
  gap: 8px;
  max-width: min(460px, calc(100vw - 24px));
  padding: 7px 9px;
  border: 1px solid var(--line);
  border-radius: 10px;
  background:
    linear-gradient(170deg,
      color-mix(in srgb, var(--card) 95%, #fff) 0%,
      color-mix(in srgb, var(--card) 90%, var(--bg)) 100%);
  box-shadow:
    0 10px 24px rgba(2, 6, 23, 0.16),
    0 1px 0 rgba(255, 255, 255, 0.38) inset;
}

.docs-hotkey-tip__text {
  margin: 0;
  font-size: 0.76rem;
  color: var(--text);
}

.docs-hotkey-tip__text kbd {
  padding: 1px 5px;
  border: 1px solid var(--line);
  border-radius: 5px;
  font-size: 0.72rem;
  font-family: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace;
  background: var(--card);
}

.docs-hotkey-tip__close {
  border: 1px solid var(--line);
  border-radius: 8px;
  background: color-mix(in srgb, var(--card) 96%, #fff);
  color: var(--text);
  font-size: 0.72rem;
  font-weight: 600;
  padding: 3px 8px;
  cursor: pointer;
}

.docs-hotkey-tip__close:hover {
  border-color: var(--accent);
}

.docs-hotkey-tip__close:focus-visible {
  outline: none;
  border-color: var(--accent);
  box-shadow: var(--focus-ring);
}

.docs-continue-reading {
  position: fixed;
  right: max(14px, env(safe-area-inset-right, 0px));
  bottom: max(72px, calc(env(safe-area-inset-bottom, 0px) + 16px));
  z-index: 89;
  display: grid;
  gap: 7px;
  max-width: min(430px, calc(100vw - 24px));
  padding: 8px 10px;
  border: 1px solid color-mix(in srgb, var(--line) 72%, var(--accent));
  border-radius: 10px;
  background:
    linear-gradient(170deg,
      color-mix(in srgb, var(--card) 96%, #fff) 0%,
      color-mix(in srgb, var(--card) 90%, var(--bg)) 100%);
  box-shadow:
    0 12px 26px rgba(2, 6, 23, 0.14),
    0 1px 0 rgba(255, 255, 255, 0.38) inset;
}

.docs-continue-reading__title {
  margin: 0;
  font-size: 0.78rem;
  color: var(--text);
  font-weight: 600;
}

.docs-continue-reading__actions {
  display: flex;
  align-items: center;
  gap: 8px;
}

.docs-continue-reading__btn {
  border: 1px solid var(--line);
  border-radius: 999px;
  padding: 3px 8px;
  font-size: 0.72rem;
  font-weight: 600;
  background: var(--card);
  color: var(--text);
  cursor: pointer;
}

.docs-continue-reading__btn--continue {
  border-color: color-mix(in srgb, var(--accent) 52%, var(--line));
  color: color-mix(in srgb, var(--accent) 72%, var(--text));
}

.docs-continue-reading__btn:hover {
  border-color: var(--accent);
}

.docs-continue-reading__btn:focus-visible {
  outline: none;
  border-color: var(--accent);
  box-shadow: var(--focus-ring);
}

.docs-quick-actions__filter {
  width: 100%;
  border: 1px solid color-mix(in srgb, var(--line) 76%, var(--accent));
  border-radius: 9px;
  background: color-mix(in srgb, var(--card) 97%, #fff);
  color: var(--text);
  padding: 8px 10px;
  font: inherit;
  font-size: 0.9rem;
  line-height: 1.3;
  transition:
    border-color var(--motion-fast) var(--motion-ease-premium),
    box-shadow var(--motion-fast) var(--motion-ease-premium),
    background var(--motion-fast) var(--motion-ease-premium);
}

.docs-quick-actions__filter::placeholder {
  color: var(--docs-placeholder);
}

.docs-quick-actions__filter:focus-visible {
  outline: none;
  border-color: var(--accent);
  background: color-mix(in srgb, var(--card) 97%, #fff);
  box-shadow:
    var(--focus-ring),
    0 0 0 1px var(--docs-premium-focus-glow-strong),
    0 0 0 6px var(--docs-premium-focus-glow-soft);
}

.docs-quick-actions__list {
  list-style: none;
  margin: 0;
  padding: 0;
  display: flex;
  flex-direction: column;
  gap: 6px;
  overflow: auto;
  min-height: 0;
}

.docs-quick-actions__group {
  position: sticky;
  top: 0;
  z-index: 1;
  padding: 7px 4px 6px;
  font-size: 0.71rem;
  font-weight: 700;
  letter-spacing: 0.09em;
  text-transform: uppercase;
  color: color-mix(in srgb, var(--muted) 84%, var(--accent));
  background: linear-gradient(180deg,
    color-mix(in srgb, var(--card) 97%, transparent) 0%,
    color-mix(in srgb, var(--card) 88%, transparent) 100%);
  border-bottom: 1px solid color-mix(in srgb, var(--line) 86%, transparent);
  backdrop-filter: blur(2px);
}

.docs-quick-actions__list a,
.docs-quick-actions__list button {
  display: block;
  width: 100%;
  border: 1px solid var(--docs-premium-item-border);
  border-radius: 11px;
  background: var(--docs-premium-item-bg);
  color: var(--text);
  text-decoration: none;
  padding: 8px 10px;
  font: inherit;
  font-size: 0.9rem;
  line-height: 1.35;
  text-align: left;
  cursor: pointer;
  transition:
    transform 180ms cubic-bezier(0.16, 1, 0.3, 1),
    border-color var(--motion-fast) var(--motion-ease-premium),
    box-shadow var(--motion-fast) var(--motion-ease-premium),
    background var(--motion-fast) var(--motion-ease-premium),
    filter var(--motion-fast) var(--motion-ease-premium);
}

.docs-quick-actions__item-label {
  display: block;
  font-weight: 670;
}

.docs-quick-actions__item-row {
  display: flex;
  align-items: center;
  justify-content: space-between;
  gap: 10px;
}

.docs-quick-actions__item-meta {
  display: inline-flex;
  align-items: center;
  gap: 6px;
  flex: 0 0 auto;
}

.docs-quick-actions__item-glyph {
  display: inline-flex;
  align-items: center;
  justify-content: center;
  width: 18px;
  height: 18px;
  border-radius: 6px;
  font-size: 0.72rem;
  font-weight: 700;
  color: color-mix(in srgb, var(--accent) 78%, var(--text));
  background: color-mix(in srgb, var(--accent) 14%, transparent);
  border: 1px solid color-mix(in srgb, var(--accent) 28%, transparent);
}

.docs-quick-actions__item-pill {
  display: inline-flex;
  align-items: center;
  border: 1px solid color-mix(in srgb, var(--line) 78%, var(--accent));
  border-radius: 8px;
  padding: 2px 7px;
  font-size: 0.66rem;
  font-weight: 600;
  letter-spacing: 0.02em;
  text-transform: none;
  color: color-mix(in srgb, var(--muted) 72%, var(--text));
  background: color-mix(in srgb, var(--card) 98%, #fff);
}

.docs-quick-actions__match {
  padding: 0 0.2em;
  border-radius: 4px;
  background: color-mix(in srgb, var(--accent) 20%, transparent);
  color: color-mix(in srgb, var(--accent) 78%, var(--text));
}

.docs-quick-actions__item-hint {
  display: block;
  margin-top: 4px;
  font-size: 0.82rem;
  color: var(--muted);
  opacity: 0.92;
}

.docs-quick-actions__item-keycaps {
  display: inline-flex;
  align-items: center;
  gap: 6px;
  margin-top: 8px;
}

.docs-quick-actions__item-keycap {
  display: inline-flex;
  align-items: center;
  justify-content: center;
  min-width: 1.7em;
  padding: 1px 6px;
  border: 1px solid color-mix(in srgb, var(--line) 82%, var(--accent));
  border-bottom-width: 1px;
  border-radius: 5px;
  font-size: 0.7rem;
  font-family: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace;
  font-weight: 700;
  letter-spacing: 0.02em;
  color: color-mix(in srgb, var(--muted) 78%, var(--text));
  background: color-mix(in srgb, var(--card) 95%, #fff);
}

.docs-quick-actions__empty {
  border: 1px dashed var(--line);
  border-radius: 10px;
  padding: 12px;
  color: var(--muted);
  font-size: 0.9rem;
}

.docs-quick-actions__list a:hover,
.docs-quick-actions__list button:hover {
  border-color: var(--accent);
  background: var(--docs-premium-item-hover-bg);
  box-shadow:
    0 10px 22px rgba(2, 6, 23, 0.1),
    0 1px 0 rgba(255, 255, 255, 0.5) inset;
  transform: translateY(-2px);
  filter: saturate(1.03);
}

.docs-quick-actions__list a:focus-visible,
.docs-quick-actions__list button:focus-visible {
  outline: none;
  box-shadow:
    var(--focus-ring),
    0 0 0 1px var(--docs-premium-focus-glow-strong),
    0 0 0 5px var(--docs-premium-focus-glow-soft);
  border-color: var(--accent);
}

.docs-quick-actions__list a.docs-quick-actions__item--active,
.docs-quick-actions__list button.docs-quick-actions__item--active {
  border-color: var(--accent);
  background: var(--docs-premium-item-active-bg);
  box-shadow:
    var(--focus-ring),
    0 12px 26px rgba(37, 99, 235, 0.12),
    0 1px 0 rgba(255, 255, 255, 0.46) inset;
  transform: translateY(-2px);
}

.docs-quick-actions__list a.docs-quick-actions__item--active .docs-quick-actions__item-pill,
.docs-quick-actions__list button.docs-quick-actions__item--active .docs-quick-actions__item-pill {
  border-color: color-mix(in srgb, var(--accent) 56%, transparent);
  color: color-mix(in srgb, var(--accent) 72%, var(--text));
}

.docs-quick-actions__list a.docs-quick-actions__item--active .docs-quick-actions__item-glyph,
.docs-quick-actions__list button.docs-quick-actions__item--active .docs-quick-actions__item-glyph {
  background: color-mix(in srgb, var(--accent) 18%, transparent);
  border-color: color-mix(in srgb, var(--accent) 52%, transparent);
}

.docs-quick-actions__list a.docs-quick-actions__item--active .docs-quick-actions__item-keycap,
.docs-quick-actions__list button.docs-quick-actions__item--active .docs-quick-actions__item-keycap {
  border-color: color-mix(in srgb, var(--accent) 58%, transparent);
  color: color-mix(in srgb, var(--accent) 72%, var(--text));
}

/* UI density presets for quick-actions-related chrome.
   - compact: current default (no override needed)
   - ultra compact: add `docs-density-ultra-compact` on <body> */
body.docs-density-ultra-compact .docs-page-actions {
  margin-bottom: 8px;
  gap: 5px;
}

body.docs-density-ultra-compact .docs-page-actions__hint {
  font-size: 0.64rem;
  letter-spacing: 0.03em;
}

body.docs-density-ultra-compact .docs-page-actions__link,
body.docs-density-ultra-compact .docs-page-actions__button {
  padding: 2px 8px;
  font-size: 0.71rem;
}

body.docs-density-ultra-compact .docs-quick-actions__panel {
  width: min(520px, 100%);
  max-height: min(70vh, 560px);
  border-radius: 10px;
  padding: 8px;
  gap: 6px;
}

body.docs-density-ultra-compact .docs-quick-actions__title {
  font-size: 0.84rem;
}

body.docs-density-ultra-compact .docs-quick-actions__kbd-hint {
  font-size: 0.64rem;
}

body.docs-density-ultra-compact .docs-quick-actions__filter {
  border-radius: 8px;
  padding: 7px 9px;
  font-size: 0.84rem;
}

body.docs-density-ultra-compact .docs-quick-actions__list a,
body.docs-density-ultra-compact .docs-quick-actions__list button {
  border-radius: 8px;
  padding: 7px 9px;
  font-size: 0.84rem;
}

body.docs-density-ultra-compact .docs-hotkey-tip {
  max-width: min(380px, calc(100vw - 24px));
  padding: 6px 8px;
  border-radius: 9px;
}

body.docs-density-ultra-compact .docs-hotkey-tip__text {
  font-size: 0.7rem;
}

body.docs-density-ultra-compact .docs-hotkey-tip__close {
  font-size: 0.68rem;
  padding: 2px 7px;
}

body.docs-density-ultra-compact .docs-continue-reading {
  max-width: min(360px, calc(100vw - 24px));
  padding: 7px 9px;
  gap: 6px;
  border-radius: 9px;
}

body.docs-density-ultra-compact .docs-continue-reading__title {
  font-size: 0.72rem;
}

body.docs-density-ultra-compact .docs-continue-reading__btn {
  font-size: 0.68rem;
  padding: 2px 7px;
}

@keyframes docs-quick-actions-enter {
  from {
    opacity: 0;
    transform: translateY(16px) scale(0.975);
    filter: blur(2px);
  }

  65% {
    opacity: 1;
    transform: translateY(-2px) scale(1.003);
    filter: blur(0);
  }

  to {
    opacity: 1;
    transform: translateY(0) scale(1);
    filter: blur(0);
  }
}

@media (prefers-reduced-motion: reduce) {
  .docs-quick-actions__panel {
    animation: none;
  }

  .docs-quick-actions__list a,
  .docs-quick-actions__list button {
    transition: border-color 0.01ms linear, box-shadow 0.01ms linear;
  }

  .docs-quick-actions__list a:hover,
  .docs-quick-actions__list button:hover,
  .docs-quick-actions__list a.docs-quick-actions__item--active,
  .docs-quick-actions__list button.docs-quick-actions__item--active {
    transform: none;
  }
}

/* Reading mode: focus content by reducing surrounding chrome. */
body.docs-reading-mode .docs-page-actions,
body.docs-reading-mode .docs-inpage-toc,
body.docs-reading-mode .docs-hotkey-tip,
body.docs-reading-mode .docs-continue-reading,
body.docs-reading-mode .docs-site-footer {
  display: none !important;
}

body.docs-reading-mode .docs-reading-progress {
  opacity: 0.25;
}

body.docs-reading-mode #docs-top-nav .docs-breadcrumbs,
body.docs-reading-mode #docs-top-nav .top-nav__groups,
body.docs-reading-mode #docs-top-nav .docs-search {
  display: none !important;
}

body.docs-reading-mode #docs-top-nav .top-nav {
  margin-bottom: 8px;
}

body.docs-reading-mode main.container,
body.docs-reading-mode main.container.docs-page-layout {
  max-width: min(900px, calc(100% - 20px));
}

body.docs-reading-mode .docs-page-layout__inner,
body.docs-reading-mode .docs-page-layout__inner--single {
  grid-template-columns: minmax(0, 1fr) !important;
  gap: 1rem;
}

body.docs-reading-mode .docs-page-layout__article {
  order: 1;
}

body.docs-reading-mode main.container p,
body.docs-reading-mode main.container li {
  line-height: 1.72;
}

@media (max-width: 520px) {
  .docs-quick-actions {
    padding: 0;
    align-items: end;
  }

  .docs-quick-actions__panel {
    width: 100%;
    max-width: none;
    max-height: min(78dvh, 720px);
    border-radius: 16px 16px 0 0;
    padding: 12px 12px max(12px, env(safe-area-inset-bottom, 0px));
    box-shadow: var(--shadow-premium-md), 0 -18px 44px rgba(2, 6, 23, 0.18);
  }

  .docs-quick-actions__list a,
  .docs-quick-actions__list button {
    padding: 10px 11px;
    font-size: 0.92rem;
  }

  .docs-quick-actions__item-pill {
    font-size: 0.63rem;
    padding: 2px 7px;
  }

  .docs-quick-actions__item-keycaps {
    margin-top: 6px;
    gap: 4px;
  }

  .docs-quick-actions__item-keycap {
    font-size: 0.64rem;
    padding: 1px 5px;
  }
}

@media (max-width: 960px) {
  .docs-page-layout__inner {
    grid-template-columns: 1fr;
  }

  .docs-inpage-toc {
    position: static;
    order: 1;
  }
}

/* Back to top — shown when viewport is near the document bottom (see docs-nav.js). */
.docs-back-to-top {
  position: fixed;
  right: max(1.25rem, env(safe-area-inset-right, 0px));
  bottom: max(1.25rem, env(safe-area-inset-bottom, 0px));
  z-index: 40;
  width: 44px;
  height: 44px;
  margin: 0;
  padding: 0;
  display: flex;
  align-items: center;
  justify-content: center;
  border-radius: 999px;
  border: 1px solid var(--line);
  background: var(--card);
  color: var(--accent);
  box-shadow: var(--card-shadow);
  cursor: pointer;
  opacity: 0;
  visibility: hidden;
  pointer-events: none;
  transform: translateY(10px);
  transition:
    opacity 0.22s ease,
    transform 0.22s ease,
    visibility 0.22s ease;
}

.docs-back-to-top.docs-back-to-top--visible {
  opacity: 1;
  visibility: visible;
  pointer-events: auto;
  transform: translateY(0);
}

.docs-back-to-top:hover {
  border-color: var(--accent);
  color: var(--accent);
}

.docs-back-to-top.docs-back-to-top--launching {
  opacity: 1;
  visibility: visible;
  pointer-events: none;
  animation-duration: 1.52s;
  animation-timing-function: cubic-bezier(0.22, 0.58, 0.22, 1);
  animation-fill-mode: forwards;
}

.docs-back-to-top.docs-back-to-top--launching.docs-back-to-top--launch-right {
  animation-name: docs-rocket-launch-right;
}

.docs-back-to-top.docs-back-to-top--launching.docs-back-to-top--launch-left {
  animation-name: docs-rocket-launch-left;
}

.docs-back-to-top:focus-visible {
  outline: 2px solid var(--accent);
  outline-offset: 2px;
}

.docs-feedback-card__form {
  margin-top: 0.75rem;
  display: grid;
  gap: 0.65rem;
}

.docs-feedback-card {
  position: relative;
  border-color: color-mix(in srgb, var(--line) 72%, var(--accent) 28%);
  background:
    linear-gradient(180deg, color-mix(in srgb, var(--card) 92%, #ffffff 8%) 0%, var(--card) 100%);
  box-shadow: var(--card-shadow), 0 10px 24px rgba(15, 23, 42, 0.08);
}

.docs-feedback-card__label {
  font-weight: 600;
}

.docs-feedback-card__textarea {
  width: 100%;
  min-height: 96px;
  resize: vertical;
  border: 1px solid var(--line);
  border-radius: 10px;
  padding: 0.65rem 0.75rem;
  font: inherit;
  background: var(--card);
  color: inherit;
}

.docs-feedback-card__select {
  width: 100%;
  border: 1px solid var(--line);
  border-radius: 10px;
  padding: 0.6rem 0.75rem;
  font: inherit;
  background: var(--card);
  color: inherit;
}

.docs-feedback-card__textarea:focus-visible,
.docs-feedback-card__select:focus-visible {
  outline: none;
  border-color: var(--accent);
  box-shadow: 0 0 0 3px color-mix(in srgb, var(--accent) 20%, transparent);
}

.docs-feedback-card__actions {
  display: flex;
  align-items: center;
  gap: 0.75rem;
  flex-wrap: wrap;
}

.docs-feedback-card__actions .docs-page-actions__button {
  border-color: color-mix(in srgb, var(--accent) 44%, var(--line) 56%);
}

.docs-feedback-card__btn-spinner {
  display: none;
  width: 0.9rem;
  height: 0.9rem;
  border-radius: 999px;
  border: 2px solid currentColor;
  border-right-color: transparent;
}

.docs-feedback-card__btn--loading {
  display: inline-flex;
  align-items: center;
  gap: 0.5rem;
  opacity: 0.92;
}

.docs-feedback-card__btn--loading .docs-feedback-card__btn-text {
  opacity: 0.95;
}

.docs-feedback-card__btn--loading .docs-feedback-card__btn-spinner {
  display: inline-block;
  animation: docs-feedback-spinner 0.75s linear infinite;
}

@keyframes docs-feedback-spinner {
  to {
    transform: rotate(360deg);
  }
}

.docs-feedback-card__status {
  margin: 0;
  font-size: 0.92rem;
  color: var(--muted);
  min-height: 1.2em;
}

.docs-feedback-card__status--error {
  color: #b91c1c;
}

.docs-feedback-card__status--success {
  color: #166534;
}

.docs-feedback-card__toast {
  position: absolute;
  right: 14px;
  top: 12px;
  z-index: 1;
  padding: 0.42rem 0.62rem;
  border-radius: 999px;
  border: 1px solid color-mix(in srgb, var(--accent) 40%, var(--line) 60%);
  background: color-mix(in srgb, var(--card) 84%, #ffffff 16%);
  color: color-mix(in srgb, var(--accent) 76%, #111827 24%);
  font-size: 0.8rem;
  font-weight: 600;
  opacity: 0;
  transform: translateY(-4px);
  pointer-events: none;
  transition:
    opacity 0.2s ease,
    transform 0.2s ease;
}

.docs-feedback-card__toast--visible {
  opacity: 1;
  transform: translateY(0);
}

@media (max-width: 640px) {
  .docs-feedback-card__toast {
    position: static;
    margin-bottom: 0.15rem;
    width: fit-content;
  }
}

.docs-back-to-top__rocket-wrap {
  position: relative;
  display: inline-flex;
  align-items: center;
  justify-content: center;
  width: 30px;
  height: 30px;
}

.docs-back-to-top__rocket {
  transform-origin: 50% 62%;
  animation: docs-rocket-hover 1.7s ease-in-out infinite;
  filter: drop-shadow(0 3px 4px rgba(37, 99, 235, 0.22));
}

.docs-back-to-top__flame {
  position: absolute;
  left: 50%;
  top: calc(100% - 1px);
  width: 12px;
  height: 18px;
  border-radius: 50% 50% 70% 70%;
  transform: translateX(-50%) scaleY(0.75);
  transform-origin: 50% 0%;
  opacity: 0;
  background:
    radial-gradient(circle at 50% 18%, rgba(255, 255, 255, 0.95) 0 24%, rgba(255, 255, 255, 0) 54%),
    linear-gradient(180deg, #fde68a 0%, #fb923c 55%, #f97316 100%);
  filter: blur(0.2px) drop-shadow(0 0 8px rgba(251, 146, 60, 0.45));
}

.docs-back-to-top__trail {
  position: absolute;
  left: 50%;
  top: calc(100% + 1px);
  width: 15px;
  height: 34px;
  border-radius: 999px;
  opacity: 0;
  transform: translateX(-50%) scaleY(0.52);
  transform-origin: 50% 0%;
  background:
    radial-gradient(ellipse at 50% 0%, rgba(255, 250, 230, 0.66) 0%, rgba(255, 250, 230, 0.1) 46%, rgba(255, 250, 230, 0) 78%),
    linear-gradient(180deg, rgba(251, 146, 60, 0.5) 0%, rgba(96, 165, 250, 0.26) 58%, rgba(59, 130, 246, 0) 100%);
  filter: blur(0.92px);
}

.docs-back-to-top__smoke {
  position: absolute;
  left: 50%;
  top: 100%;
  width: 7px;
  height: 7px;
  border-radius: 999px;
  background: color-mix(in srgb, var(--card) 42%, white 58%);
  opacity: 0;
  transform: translate(-50%, -2px) scale(0.5);
}

.docs-back-to-top__smoke--left {
  margin-left: -6px;
  animation: docs-rocket-smoke-left 1.3s ease-out infinite;
}

.docs-back-to-top__smoke--mid {
  animation: docs-rocket-smoke-mid 1.15s ease-out infinite 0.12s;
}

.docs-back-to-top__smoke--right {
  margin-left: 6px;
  animation: docs-rocket-smoke-right 1.25s ease-out infinite 0.24s;
}

.docs-back-to-top:hover .docs-back-to-top__rocket,
.docs-back-to-top:focus-visible .docs-back-to-top__rocket {
  animation-duration: 1s;
}

.docs-back-to-top.docs-back-to-top--launching .docs-back-to-top__rocket {
  animation: docs-rocket-thrust 0.72s ease-in-out infinite;
}

.docs-back-to-top.docs-back-to-top--launching .docs-back-to-top__rocket-wrap {
  animation: docs-rocket-grow-near-top 1.52s ease-out forwards;
}

.docs-back-to-top.docs-back-to-top--launching .docs-back-to-top__flame {
  opacity: 1;
  animation:
    docs-rocket-flame 0.4s ease-in-out infinite,
    docs-rocket-flame-grow-near-top 1.52s ease-out forwards;
}

.docs-back-to-top.docs-back-to-top--launching .docs-back-to-top__trail {
  opacity: 0.82;
  animation: docs-rocket-trail 0.9s ease-in-out infinite;
}

.docs-back-to-top.docs-back-to-top--launching .docs-back-to-top__smoke--left,
.docs-back-to-top.docs-back-to-top--launching .docs-back-to-top__smoke--mid,
.docs-back-to-top.docs-back-to-top--launching .docs-back-to-top__smoke--right {
  animation-duration: 0.9s;
}

@keyframes docs-rocket-hover {
  0%,
  100% {
    transform: translateY(0) rotate(0deg);
  }
  50% {
    transform: translateY(-2px) rotate(-3deg);
  }
}

@keyframes docs-rocket-launch-right {
  0% {
    transform: translate(0, 0) scale(1) rotate(0deg);
    opacity: 1;
  }
  24% {
    transform: translate(0, -14vh) scale(1.03) rotate(0deg);
    opacity: 1;
  }
  52% {
    transform: translate(0, -38vh) scale(1.09) rotate(0deg);
    opacity: 1;
  }
  76% {
    transform: translate(0, -62vh) scale(1.15) rotate(0deg);
    opacity: 0.95;
  }
  92% {
    transform: translate(0, -76vh) scale(1.2) rotate(0deg);
    opacity: 0.4;
  }
  100% {
    transform: translate(0, -82vh) scale(1.24) rotate(0deg);
    opacity: 0;
  }
}

@keyframes docs-rocket-launch-left {
  0% {
    transform: translate(0, 0) scale(1) rotate(0deg);
    opacity: 1;
  }
  24% {
    transform: translate(0, -14vh) scale(1.03) rotate(0deg);
    opacity: 1;
  }
  52% {
    transform: translate(0, -38vh) scale(1.09) rotate(0deg);
    opacity: 1;
  }
  76% {
    transform: translate(0, -62vh) scale(1.15) rotate(0deg);
    opacity: 0.95;
  }
  92% {
    transform: translate(0, -76vh) scale(1.2) rotate(0deg);
    opacity: 0.4;
  }
  100% {
    transform: translate(0, -82vh) scale(1.24) rotate(0deg);
    opacity: 0;
  }
}

@keyframes docs-rocket-grow-near-top {
  0% {
    transform: scale(1);
  }
  55% {
    transform: scale(1.08);
  }
  82% {
    transform: scale(1.18);
  }
  100% {
    transform: scale(1.28);
  }
}

@keyframes docs-rocket-thrust {
  0%,
  100% {
    transform: translateY(-0.18px) rotate(-0.24deg);
  }
  50% {
    transform: translateY(0.18px) rotate(0.24deg);
  }
}

@keyframes docs-rocket-flame {
  0%,
  100% {
    transform: translateX(-50%) scale(0.9, 0.92);
    filter: blur(0.2px) drop-shadow(0 0 8px rgba(251, 146, 60, 0.45));
  }
  50% {
    transform: translateX(-50%) scale(0.98, 1.04);
    filter: blur(0.3px) drop-shadow(0 0 12px rgba(251, 146, 60, 0.62));
  }
}

@keyframes docs-rocket-flame-grow-near-top {
  0% {
    transform: translateX(-50%) scale(0.95, 0.9);
  }
  55% {
    transform: translateX(-50%) scale(1.12, 1.18);
  }
  82% {
    transform: translateX(-50%) scale(1.28, 1.42);
  }
  100% {
    transform: translateX(-50%) scale(1.36, 1.54);
  }
}

@keyframes docs-rocket-trail {
  0%,
  100% {
    transform: translateX(-50%) scale(0.82, 0.56);
    opacity: 0.54;
  }
  50% {
    transform: translateX(-50%) scale(0.95, 0.98);
    opacity: 0.82;
  }
}

@keyframes docs-rocket-smoke-left {
  0% {
    opacity: 0;
    transform: translate(-50%, -2px) scale(0.45);
  }
  22% {
    opacity: 0.26;
  }
  100% {
    opacity: 0;
    transform: translate(-7px, 10px) scale(1.12);
  }
}

@keyframes docs-rocket-smoke-mid {
  0% {
    opacity: 0;
    transform: translate(-50%, -2px) scale(0.42);
  }
  18% {
    opacity: 0.3;
  }
  100% {
    opacity: 0;
    transform: translate(-50%, 12px) scale(1.2);
  }
}

@keyframes docs-rocket-smoke-right {
  0% {
    opacity: 0;
    transform: translate(-50%, -2px) scale(0.45);
  }
  26% {
    opacity: 0.26;
  }
  100% {
    opacity: 0;
    transform: translate(7px, 10px) scale(1.12);
  }
}

@media (prefers-reduced-motion: reduce) {
  .docs-back-to-top,
  .docs-back-to-top:hover {
    transform: translateY(0);
  }

  .docs-back-to-top__rocket,
  .docs-back-to-top__smoke,
  .docs-back-to-top__flame,
  .docs-back-to-top__trail {
    animation: none;
  }

  .docs-back-to-top.docs-back-to-top--launching {
    animation: none;
  }
}

/* Page editors block (docs-internal-meta.js) — must work without internal-layout.css (e.g. ADR pages) */
.docs-page-meta {
  margin-bottom: 1.25rem;
  padding: 16px 18px;
}

.docs-page-meta--premium {
  margin: 0 0 1rem;
  padding: 0;
  border: 0;
  background: transparent;
  box-shadow: none;
  display: flex;
  align-items: center;
  flex-wrap: wrap;
  gap: 8px 12px;
}

.docs-page-meta__title {
  margin: 0 0 10px;
  font-size: 1.05rem;
}

.docs-page-meta--premium .docs-page-meta__title {
  margin: 0;
  font-size: 0.78rem;
  line-height: 1.2;
  text-transform: uppercase;
  letter-spacing: 0.05em;
  color: var(--muted, #64748b);
}

.docs-page-meta__toggle {
  border: 0;
  background: transparent;
  padding: 0;
  cursor: pointer;
  text-decoration: none;
}

.docs-page-meta__toggle:hover {
  color: var(--accent, #2563eb);
}

.docs-page-meta__toggle:focus-visible {
  outline: none;
  box-shadow: var(--focus-ring);
  border-radius: 6px;
}

.docs-page-meta__stack {
  display: inline-flex;
  align-items: center;
  margin-right: 8px;
}

.docs-page-meta__stack-item {
  margin-left: -6px;
  border-radius: 999px;
  box-shadow: 0 0 0 2px var(--card, #fff);
}

.docs-page-meta__stack-item:first-child {
  margin-left: 0;
}

.docs-page-meta__stack-avatar {
  width: 34px;
  height: 34px;
  border-radius: 50%;
  display: block;
}

.docs-page-meta__stack-extra {
  margin-left: 6px;
  font-size: 0.74rem;
  color: var(--muted, #64748b);
}

.docs-page-meta__label {
  font-weight: 600;
  color: var(--muted, #64748b);
  margin-right: 6px;
}

.docs-page-meta__editors {
  list-style: none;
  margin: 0 0 14px;
  padding: 0;
  display: flex;
  flex-wrap: wrap;
  gap: 12px 20px;
}

.docs-page-meta--premium .docs-page-meta__editors {
  margin: 0;
  gap: 8px;
}

.docs-page-meta--premium .docs-page-meta__editors[hidden] {
  display: none;
}

.docs-page-meta--premium .docs-page-meta__editor+.docs-page-meta__editor {
  position: relative;
}

.docs-page-meta--premium .docs-page-meta__editor+.docs-page-meta__editor::before {
  content: "·";
  position: absolute;
  left: -9px;
  top: 50%;
  transform: translateY(-50%);
  color: var(--muted, #64748b);
  font-weight: 600;
}

.docs-page-meta__editor {
  display: flex;
  align-items: center;
  gap: 10px;
  flex-wrap: wrap;
}

.docs-page-meta--premium .docs-page-meta__editor {
  gap: 6px;
  padding: 3px 9px 3px 3px;
  border: 1px solid var(--line, #dbe3ef);
  border-radius: 999px;
  background: var(--card, #fff);
  transition: border-color 150ms ease, box-shadow 150ms ease, transform 150ms ease;
}

.docs-page-meta__avatar-link {
  flex-shrink: 0;
  line-height: 0;
}

.docs-page-meta__editor-name-link {
  font-weight: 600;
  text-decoration: none;
  color: var(--text, #0f172a);
}

.docs-page-meta--premium .docs-page-meta__editor-name-link {
  font-size: 0.84rem;
}

.docs-page-meta--premium .docs-page-meta__editor:hover {
  border-color: color-mix(in srgb, var(--accent, #2563eb) 35%, var(--line, #dbe3ef));
  box-shadow: 0 1px 4px rgba(15, 23, 42, 0.08);
  transform: translateY(-1px);
}

.docs-page-meta--premium .docs-page-meta__editor:focus-within {
  border-color: var(--accent, #2563eb);
  box-shadow: 0 0 0 2px color-mix(in srgb, var(--accent, #2563eb) 18%, transparent);
}

.docs-page-meta__editor-name-link:hover {
  text-decoration: underline;
}

.docs-page-meta__avatar {
  width: 40px;
  height: 40px;
  aspect-ratio: 1;
  border-radius: 50%;
  object-fit: cover;
  object-position: center;
  flex-shrink: 0;
  border: 1px solid var(--line, #dbe3ef);
  display: block;
}

.docs-page-meta--premium .docs-page-meta__avatar {
  width: 38px;
  height: 38px;
  transition: filter 150ms ease, transform 150ms ease, box-shadow 150ms ease;
}

.docs-page-meta--premium .docs-page-meta__editor:hover .docs-page-meta__avatar {
  filter: saturate(1.06) contrast(1.03);
  transform: translateY(-0.5px);
  box-shadow: 0 0 0 1px color-mix(in srgb, var(--accent, #2563eb) 28%, transparent);
}

.docs-page-meta--premium .docs-page-meta__editor:focus-within .docs-page-meta__avatar {
  box-shadow: 0 0 0 1px color-mix(in srgb, var(--accent, #2563eb) 38%, transparent);
}

.docs-page-meta__warn {
  margin: 0;
  color: #b45309;
}

.portal-skeleton-grid {
  display: grid;
  grid-template-columns: repeat(3, minmax(0, 1fr));
  gap: 12px;
}

.portal-skeleton-grid>span,
.portal-skeleton-list>li {
  display: block;
  border-radius: 10px;
  background: linear-gradient(90deg,
      color-mix(in srgb, var(--card, #fff) 80%, var(--line, #dbe3ef)) 20%,
      color-mix(in srgb, var(--card, #fff) 92%, var(--line, #dbe3ef)) 55%,
      color-mix(in srgb, var(--card, #fff) 80%, var(--line, #dbe3ef)) 100%);
  background-size: 220% 100%;
  animation: docs-skeleton-sweep 1.2s linear infinite;
}

.portal-skeleton-grid>span {
  height: 82px;
}

.portal-skeleton-list {
  list-style: none;
  margin: 0;
  padding: 0;
  display: grid;
  gap: 8px;
}

.portal-skeleton-list>li {
  height: 18px;
}

@keyframes docs-skeleton-sweep {
  from {
    background-position: 200% 0;
  }

  to {
    background-position: -20% 0;
  }
}

@media (max-width: 700px) {
  .docs-page-meta--premium {
    gap: 6px 10px;
    align-items: flex-start;
  }

  .docs-page-meta--premium .docs-page-meta__title {
    order: 1;
    flex-basis: auto;
    text-align: left;
  }

  .docs-page-meta--premium .docs-page-meta__stack {
    order: 2;
    margin-right: 0;
  }

  .docs-page-meta--premium .docs-page-meta__stack-item {
    margin-left: 0;
    margin-right: 6px;
  }

  .docs-page-meta--premium .docs-page-meta__editors {
    order: 3;
    flex-basis: 100%;
    width: 100%;
  }

  .docs-page-meta--premium .docs-page-meta__editor+.docs-page-meta__editor::before {
    left: -8px;
  }
}

.docs-page-history td a {
  color: var(--accent, #2563eb);
  text-decoration: none;
}

.docs-page-history td a:hover {
  text-decoration: underline;
}

/* Breadcrumb trail (docs-nav.js) — first child inside #docs-top-nav */
.docs-breadcrumbs {
  margin: 0 0 12px;
  font-size: 0.82rem;
  line-height: 1.45;
  color: var(--muted);
}

.docs-breadcrumbs__list {
  display: flex;
  flex-wrap: wrap;
  align-items: center;
  gap: 0.25rem 0.35rem;
  list-style: none;
  margin: 0;
  padding: 0;
}

.docs-breadcrumbs__item {
  display: inline-flex;
  align-items: center;
  gap: 0.35rem;
}

.docs-breadcrumbs__item+.docs-breadcrumbs__item::before {
  content: "/";
  color: var(--line);
  font-weight: 500;
  margin-right: 0.15rem;
  user-select: none;
}

.docs-breadcrumbs a {
  color: var(--accent);
  text-decoration: none;
}

.docs-breadcrumbs a:hover {
  text-decoration: underline;
}

.docs-breadcrumbs__current {
  color: var(--text);
  font-weight: 600;
}

.docs-breadcrumbs__text {
  color: var(--muted);
}

@media (max-width: 760px) {
  .docs-breadcrumbs {
    margin-bottom: 8px;
  }
}

@media (max-width: 520px) {
  .docs-breadcrumbs__item:not(:first-child):not(:last-child) {
    display: none;
  }

  .docs-breadcrumbs__item:last-child::before {
    content: "… /";
    color: var(--line);
    font-weight: 500;
    margin-right: 0.15rem;
    user-select: none;
  }

}

/* Site footer (docs-nav.js initDocsSiteFooter) — “tile” + subtle finish line above (pairs with dot veil). */
.docs-site-footer {
  position: relative;
  margin-top: 2.5rem;
  padding: 1.25rem 0 2rem;
  border-top: 1px solid var(--line);
  box-shadow: 0 -1px 0 0 color-mix(in srgb, var(--accent) 16%, transparent);
  background: linear-gradient(180deg,
      color-mix(in srgb, var(--card) 82%, transparent) 0%,
      color-mix(in srgb, var(--card) 62%, transparent) 100%);
}

/* Soft glow wash behind footer text (opacity-only keyframes — interpolates everywhere). */
.docs-site-footer::after {
  content: "";
  position: absolute;
  inset: 0;
  z-index: 0;
  pointer-events: none;
  background: radial-gradient(ellipse 100% 70% at 50% 0%,
      color-mix(in srgb, var(--accent) 22%, transparent) 0%,
      transparent 62%);
  opacity: 0.28;
}

@media (prefers-reduced-motion: no-preference) {
  .docs-site-footer::after {
    animation: docs-site-footer-glow-pulse 6.5s ease-in-out infinite;
  }
}

@media (prefers-reduced-motion: reduce) {
  .docs-site-footer::after {
    animation: none;
    opacity: 0.22;
  }
}

@keyframes docs-site-footer-glow-pulse {

  0%,
  100% {
    opacity: 0.18;
  }

  50% {
    opacity: 0.42;
  }
}

.docs-site-footer::before {
  content: "";
  position: absolute;
  left: 0;
  right: 0;
  top: 0;
  height: 3px;
  pointer-events: none;
  border-radius: 0 0 2px 2px;
  z-index: 1;
  background: linear-gradient(90deg,
      transparent 0%,
      color-mix(in srgb, var(--accent) 52%, transparent) 50%,
      transparent 100%);
  background-size: 220% 100%;
  opacity: 0.65;
}

@media (prefers-reduced-motion: no-preference) {
  .docs-site-footer::before {
    animation: docs-site-footer-accent-sweep 11s ease-in-out infinite;
  }
}

@media (prefers-reduced-motion: reduce) {
  .docs-site-footer::before {
    animation: none;
    opacity: 0.5;
  }
}

@keyframes docs-site-footer-accent-sweep {

  0%,
  100% {
    background-position: 0% 50%;
    opacity: 0.45;
  }

  50% {
    background-position: 100% 50%;
    opacity: 0.95;
  }
}

.docs-site-footer__inner {
  position: relative;
  z-index: 2;
  padding-bottom: 0.5rem;
}

.docs-site-footer__links {
  display: flex;
  flex-wrap: wrap;
  align-items: center;
  gap: 0.35rem 0;
  margin: 0 0 0.65rem;
  font-size: 0.88rem;
}

.docs-site-footer__links>a {
  color: var(--accent);
  text-decoration: none;
}

.docs-site-footer__links>a:hover {
  text-decoration: underline;
}

.docs-site-footer__links>a+a::before {
  content: "·";
  margin-right: 0.65rem;
  margin-left: 0.15rem;
  color: var(--muted);
  font-weight: 600;
  pointer-events: none;
}

.docs-site-footer__meta {
  margin: 0;
  font-size: 0.8rem;
  line-height: 1.5;
  color: var(--muted);
  max-width: 52rem;
}

/*
 * Narrow viewports: comfortable reading width, safe areas (notched phones), slightly smaller type.
 * Wider layout rules: docs-site-nav.css (720px), .docs-page-layout (960px), ADR tracks (640px).
 */
@media (max-width: 520px) {

  main.container,
  .container {
    padding-top: max(20px, env(safe-area-inset-top, 0px));
    padding-left: max(14px, env(safe-area-inset-left, 0px));
    padding-right: max(14px, env(safe-area-inset-right, 0px));
    padding-bottom: max(72px, env(safe-area-inset-bottom, 0px));
  }

  h1 {
    font-size: 1.65rem;
    overflow-wrap: break-word;
  }

  h2 {
    font-size: 1.2rem;
  }

  h3 {
    font-size: 1rem;
  }

  .card {
    padding: 14px 14px;
    border-radius: 12px;
  }

  pre {
    padding: 12px 12px;
    font-size: 0.85rem;
  }

  ul,
  ol {
    margin-left: 18px;
  }
}

@media (max-width: 380px) {
  h1 {
    font-size: 1.45rem;
  }
}

/* Touch / stylus: larger tap targets; 16px input text avoids iOS zoom-on-focus in Safari. */
@media (hover: none) and (pointer: coarse) {
  .docs-search__input {
    min-height: 44px;
    font-size: 16px;
  }

  .top-nav__links a {
    padding-top: 8px;
    padding-bottom: 8px;
  }

  .top-nav__toggle,
  .top-nav__theme-btn {
    min-height: 40px;
    padding-left: 12px;
    padding-right: 12px;
  }

  .docs-inpage-toc nav a {
    padding-top: 6px;
    padding-bottom: 6px;
  }
}

/* internal/api/conspectus — paper cue sheet vs cue_sheet JSON walkthrough */
.cue-sheet-walkthrough {
  display: grid;
  grid-template-columns: minmax(0, 1fr) minmax(0, 1fr);
  gap: 1.25rem 1.5rem;
  margin: 1.25rem 0 0.75rem;
  align-items: start;
}

@media (max-width: 800px) {
  .cue-sheet-walkthrough {
    grid-template-columns: 1fr;
  }
}

.cue-sheet-walkthrough__label {
  margin: 0 0 0.5rem;
  font-size: 0.92rem;
  font-weight: 600;
  color: var(--text);
}

.cue-sheet-walkthrough__cap {
  caption-side: top;
  text-align: left;
  font-size: 0.8rem;
  font-weight: 500;
  color: var(--muted);
  padding: 0 0 0.5rem;
  line-height: 1.35;
}

.cue-sheet-walkthrough__paper {
  width: 100%;
  border-collapse: collapse;
  font-size: 0.88rem;
  line-height: 1.4;
  background: var(--card);
}

.cue-sheet-walkthrough__paper th,
.cue-sheet-walkthrough__paper td {
  border: 1px solid var(--line);
  padding: 8px 10px;
  vertical-align: top;
  text-align: left;
}

.cue-sheet-walkthrough__paper thead th {
  background: rgba(37, 99, 235, 0.08);
  font-weight: 600;
  font-size: 0.78rem;
  text-transform: uppercase;
  letter-spacing: 0.04em;
  color: var(--muted);
}

.cue-sheet-walkthrough__pre {
  margin: 0;
  padding: 12px 14px;
  font-size: 0.78rem;
  line-height: 1.45;
  overflow-x: auto;
  border-radius: 8px;
  border: 1px solid var(--line);
  background: rgba(15, 23, 42, 0.04);
}

[data-theme="dark"] .cue-sheet-walkthrough__pre {
  background: rgba(248, 250, 252, 0.06);
}

.cue-sheet-walkthrough__legend {
  margin: 0.75rem 0 0;
  padding-left: 1.1rem;
  max-width: 58rem;
}

/* -------------------------------------------------------------------------- */
/* Glossary / definition tooltips (hover + keyboard focus; no extra JS)        */
/* Usage: <span class="docs-tooltip" tabindex="0" data-tooltip="…">term</span> */
/* -------------------------------------------------------------------------- */

.docs-tooltip {
  position: relative;
  display: inline;
  cursor: help;
  text-decoration: underline dotted;
  text-decoration-color: color-mix(in srgb, var(--accent) 55%, var(--text));
  text-underline-offset: 0.15em;
  outline: none;
}

.docs-tooltip::after {
  content: attr(data-tooltip);
  position: absolute;
  z-index: 200;
  left: 0;
  bottom: calc(100% + 8px);
  min-width: 12rem;
  max-width: min(22rem, calc(100vw - 2rem));
  padding: 0.55rem 0.65rem;
  border-radius: 8px;
  border: 1px solid var(--docs-tooltip-border);
  background: var(--docs-tooltip-bg);
  color: var(--docs-tooltip-fg);
  font-size: 0.82rem;
  font-weight: 400;
  line-height: 1.4;
  text-align: left;
  text-decoration: none;
  white-space: normal;
  box-shadow: var(--docs-tooltip-shadow);
  opacity: 0;
  visibility: hidden;
  pointer-events: none;
  transition:
    opacity var(--motion-fast) var(--motion-ease-premium),
    visibility var(--motion-fast) var(--motion-ease-premium);
}

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

.docs-tooltip:hover::after,
.docs-tooltip:focus-visible::after {
  opacity: 1;
  visibility: visible;
}

.docs-tooltip:focus-visible {
  box-shadow: var(--focus-ring);
  border-radius: 2px;
}

.docs-tooltip.docs-tooltip--etr::after {
  content: var(--docs-tooltip-etr-text);
}

/* Nested glossary spans inside links/buttons: show hint when the control is focused (keyboard). */
a:focus-within .docs-tooltip::after,
button:focus-within .docs-tooltip::after {
  opacity: 1;
  visibility: visible;
}