/* ============================================================
   beava docs kit — component styles
   Ported from beava-design-system/project/examples/docs-page.html
   plus the older comp-* prototypes.
   ============================================================ */

/* ============================================================
   Top nav  (docs-page.html .topnav)
   ============================================================ */
.bv-topnav {
  position: sticky; top: 0; z-index: 50;
  background: rgba(253,250,244,0.92);
  backdrop-filter: blur(10px);
  border-bottom: 1px solid var(--border);
  height: 60px;
  display: flex; align-items: center;
  padding: 0 28px;
  gap: 28px;
}
.bv-brand {
  display: flex; align-items: center; gap: 9px;
  font-family: var(--font-serif); font-weight: 700;
  font-size: 21px; letter-spacing: -0.01em;
  color: var(--fg1); text-decoration: none;
}
.bv-brand img { width: 26px; height: 26px; }
.bv-brand-v {
  font-family: var(--font-mono); font-size: 11px; font-weight: 500;
  color: var(--accent); background: var(--beava-orange-wash);
  padding: 2px 6px; border-radius: 999px; margin-left: 4px;
  transform: translateY(-2px);
}
.bv-search {
  flex: 1; max-width: 460px; margin: 0 auto;
  display: flex; align-items: center; gap: 8px;
  height: 34px; padding: 0 12px;
  background: #fff; border: 1px solid var(--border); border-radius: 10px;
  color: var(--fg3); font-family: var(--font-sans); font-size: 13.5px;
  cursor: text;
  transition: border-color 150ms var(--ease-out);
}
.bv-search:hover { border-color: var(--border-strong); }
.bv-search-ic { color: var(--fg3); flex-shrink: 0; }
.bv-search-placeholder { flex: 1; }
.bv-kbd {
  font-family: var(--font-mono); font-size: 11px;
  color: var(--fg3); background: var(--beava-paper);
  border: 1px solid var(--border); border-radius: 5px;
  padding: 1px 6px;
}
.bv-nav-links { display: flex; gap: 22px; align-items: center; }
.bv-nav-links a {
  font-family: var(--font-sans); font-size: 14px;
  color: var(--fg2); text-decoration: none; font-weight: 500;
  display: inline-flex; align-items: center; gap: 6px;
}
.bv-nav-links a:hover { color: var(--accent); }
.bv-nav-links a.active { color: var(--fg1); }
.bv-nav-links a.active::after {
  content: ""; display: block; width: 4px; height: 4px; border-radius: 999px;
  background: var(--accent); margin-left: 4px;
}

/* ============================================================
   3-column docs shell
   ============================================================ */
.bv-docs-shell {
  display: grid;
  grid-template-columns: 252px minmax(0, 1fr) 220px;
  max-width: 1400px;
  margin: 0 auto;
  padding: 0 28px;
  align-items: start;
}
.bv-docs-shell.no-toc {
  grid-template-columns: 252px minmax(0, 1fr);
}

/* ============================================================
   Left sidebar — expanding groups
   ============================================================ */
.bv-side {
  position: sticky; top: 60px;
  align-self: start;
  height: calc(100vh - 60px);
  overflow-y: auto;
  padding: 28px 18px 28px 0;
  border-right: 1px solid var(--border);
  margin-right: 32px;
}
.bv-side-group { margin-bottom: 4px; }
.bv-side-head {
  display: flex; align-items: center; justify-content: space-between;
  padding: 7px 10px;
  font-family: var(--font-sans); font-weight: 600; font-size: 13.5px;
  color: var(--fg1);
  cursor: pointer; user-select: none;
  border-radius: 6px;
  transition: background 120ms var(--ease-out);
}
.bv-side-head:hover { background: var(--beava-paper); }
.bv-side-group.empty .bv-side-head { cursor: default; opacity: 0.62; }
.bv-side-group.empty .bv-side-head:hover { background: transparent; }
.bv-side-chev {
  color: var(--fg3);
  transition: transform 200ms var(--ease-out);
}
.bv-side-group.open .bv-side-chev { transform: rotate(90deg); }
.bv-side ul {
  list-style: none; padding: 0; margin: 4px 0 8px 6px;
  display: none;
}
.bv-side-group.open ul { display: block; }
.bv-side li a {
  display: block;
  padding: 6px 12px;
  font-family: var(--font-sans); font-size: 13px;
  color: var(--fg3); text-decoration: none;
  border-radius: 6px;
  margin: 1px 0;
  transition: color 120ms var(--ease-out), background 120ms var(--ease-out);
}
.bv-side li a:hover { color: var(--fg1); background: var(--beava-paper); }
.bv-side li.active a {
  background: var(--beava-orange-wash);
  color: var(--accent);
  font-weight: 600;
}

/* ============================================================
   Main content
   ============================================================ */
.bv-content {
  padding: 36px 32px 120px 8px;
  max-width: 720px;
  min-width: 0;
}
.bv-crumbs {
  font-family: var(--font-sans); font-size: 12.5px; color: var(--fg3);
  margin-bottom: 14px;
  display: flex; align-items: center; flex-wrap: wrap; gap: 0;
}
.bv-crumbs a { color: var(--fg3); text-decoration: none; }
.bv-crumbs a:hover { color: var(--accent); }
.bv-crumbs .bv-crumb-sep { margin: 0 6px; color: var(--border-strong); }
.bv-crumbs .bv-crumb-cur { color: var(--fg1); font-weight: 500; }

.bv-content h1 {
  font-family: var(--font-serif); font-weight: 700;
  font-size: 44px; line-height: 1.05; letter-spacing: -0.02em;
  margin: 0 0 14px; color: var(--fg1);
}
.bv-lede {
  font-family: var(--font-sans); font-size: 16px; line-height: 1.65;
  color: var(--fg2); margin: 0 0 30px; max-width: 60ch;
}
.bv-content h2 {
  font-family: var(--font-serif); font-weight: 600;
  font-size: 28px; line-height: 1.15; letter-spacing: -0.015em;
  margin: 48px 0 14px; color: var(--fg1);
  padding-top: 24px;
  border-top: 1px solid var(--border);
  scroll-margin-top: 80px;
}
.bv-content h2:first-of-type { border-top: 0; padding-top: 0; margin-top: 36px; }
.bv-content h3 {
  font-family: var(--font-sans); font-weight: 600;
  font-size: 17px; margin: 28px 0 8px; color: var(--fg1);
  scroll-margin-top: 80px;
}
.bv-content p, .bv-content li {
  font-family: var(--font-sans); font-size: 15.5px; line-height: 1.7;
  color: var(--fg1); margin: 0 0 14px; text-wrap: pretty;
}
.bv-content ul { padding-left: 22px; margin: 0 0 18px; }
.bv-content li { margin: 0 0 6px; }
.bv-content li::marker { color: var(--fg3); }
.bv-content a {
  color: var(--accent);
  text-decoration: underline;
  text-decoration-color: color-mix(in oklab, var(--accent) 35%, transparent);
  text-underline-offset: 3px;
}
.bv-content a:hover { text-decoration-color: currentColor; }
.bv-content code {
  font-family: var(--font-mono); font-size: 0.9em;
  background: var(--beava-paper); border: 1px solid var(--border-inset);
  padding: 1px 5px; border-radius: 4px; color: var(--fg1);
}
.bv-content strong { color: var(--fg1); font-weight: 600; }

/* Tables — markdown-rendered tables in .bv-content (operator catalog, comparison
   matrices, etc). Mirrors the legacy .docs-prose table look but tuned for the
   warmer .bv-content palette. */
.bv-content table {
  width: 100%;
  border-collapse: collapse;
  margin: 0 0 22px;
  font-family: var(--font-sans);
  font-size: 14px;
  line-height: 1.55;
  background: #fff;
  border: 1px solid var(--border);
  border-radius: 10px;
  overflow: hidden;
}
.bv-content table th,
.bv-content table td {
  padding: 10px 14px;
  text-align: left;
  vertical-align: top;
  border-bottom: 1px solid var(--border);
}
.bv-content table th + th,
.bv-content table td + td {
  border-left: 1px solid var(--border);
}
.bv-content table thead th {
  background: var(--beava-cream-deep);
  font-weight: 600;
  font-size: 12.5px;
  text-transform: uppercase;
  letter-spacing: 0.04em;
  color: var(--fg2);
  border-bottom: 1px solid var(--border-strong);
}
.bv-content table tbody tr:last-child td { border-bottom: 0; }
.bv-content table tbody tr:hover { background: var(--beava-paper); }
.bv-content table code {
  font-size: 12.5px;
  background: var(--beava-paper);
  border: 1px solid var(--border-inset);
}

/* Inline call-outs (note / tip / warn) */
.bv-note {
  background: var(--beava-info-wash);
  border: 1px solid #cadae4;
  border-left: 3px solid var(--beava-info);
  padding: 14px 16px; border-radius: 10px;
  margin: 0 0 22px;
  font-family: var(--font-sans); font-size: 14.5px; line-height: 1.6;
  color: var(--fg1);
}
.bv-note strong { color: var(--beava-info); }
.bv-note.tip {
  background: var(--beava-success-wash);
  border-color: #cfdcbd;
  border-left-color: var(--beava-success);
}
.bv-note.tip strong { color: var(--beava-success); }
.bv-note.warn {
  background: var(--beava-warn-wash);
  border-color: #ecd89a;
  border-left-color: var(--beava-warn);
}
.bv-note.warn strong { color: #8b6312; }

/* Markdown blockquotes inside .bv-content — `> **Tip:** ...` / `> **Note:** ...`
   / `> **Warn:** ...` / plain `> quote`. Markdown-renderered pages can't apply
   the React `.bv-note` class so we lean on `:has(strong)` + the leading word
   to color-cue tip / warn / note variants. Plain blockquotes (no leading
   strong) fall through to a neutral cream callout. */
.bv-content blockquote {
  background: var(--beava-paper);
  border: 1px solid var(--border);
  border-left: 3px solid var(--border-strong);
  padding: 14px 16px; border-radius: 10px;
  margin: 0 0 22px;
  font-family: var(--font-sans); font-size: 14.5px; line-height: 1.6;
  color: var(--fg1);
}
.bv-content blockquote > p { margin: 0; }
.bv-content blockquote > p + p { margin-top: 8px; }
.bv-content blockquote strong:first-child { color: var(--fg1); font-weight: 600; }

/* Variant cues — selector matches `> **Tip:** ...`, `> **Note:** ...`,
   `> **Warn:** ...` / `> **Warning:** ...` based on the first child's text. */
.bv-content blockquote:has(> p:first-child > strong:first-child[data-variant="tip"]),
.bv-content blockquote.tip {
  background: var(--beava-success-wash);
  border-color: #cfdcbd;
  border-left-color: var(--beava-success);
}
.bv-content blockquote.tip > p > strong:first-child { color: var(--beava-success); }
.bv-content blockquote:has(> p:first-child > strong:first-child[data-variant="warn"]),
.bv-content blockquote.warn {
  background: var(--beava-warn-wash);
  border-color: #ecd89a;
  border-left-color: var(--beava-warn);
}
.bv-content blockquote.warn > p > strong:first-child { color: #8b6312; }
.bv-content blockquote:has(> p:first-child > strong:first-child[data-variant="note"]),
.bv-content blockquote.note {
  background: var(--beava-info-wash);
  border-color: #cadae4;
  border-left-color: var(--beava-info);
}
.bv-content blockquote.note > p > strong:first-child { color: var(--beava-info); }

/* ============================================================
   Right TOC
   ============================================================ */
.bv-toc {
  position: sticky; top: 88px;
  align-self: start;
  padding: 36px 0 40px;
  max-height: calc(100vh - 88px);
  overflow-y: auto;
}
.bv-toc-kicker {
  font-family: var(--font-sans); font-weight: 600; font-size: 13px;
  color: var(--fg1); margin: 0 0 14px;
}
.bv-toc ul { list-style: none; padding: 0; margin: 0; display: flex; flex-direction: column; gap: 1px; }
.bv-toc li a {
  display: block;
  padding: 5px 0 5px 12px;
  font-family: var(--font-sans); font-size: 13px;
  color: var(--fg3); text-decoration: none;
  border-left: 2px solid transparent;
  margin-left: -2px;
  transition: color 120ms var(--ease-out), border-color 120ms var(--ease-out);
}
.bv-toc li a:hover { color: var(--fg1); }
.bv-toc li.sub a { padding-left: 24px; font-size: 12.5px; }
.bv-toc li.active a {
  color: var(--accent); font-weight: 600;
  border-left-color: var(--accent);
}
.bv-toc-foot {
  margin-top: 22px; padding-top: 16px;
  border-top: 1px solid var(--border);
  display: flex; flex-direction: column; gap: 8px;
  font-family: var(--font-sans); font-size: 12.5px;
}
.bv-toc-foot a {
  color: var(--fg3); text-decoration: none;
  display: inline-flex; align-items: center; gap: 6px;
}
.bv-toc-foot a:hover { color: var(--accent); }

/* ============================================================
   Prev/Next pager (end of doc page)
   ============================================================ */
.bv-pager {
  display: grid; grid-template-columns: 1fr 1fr; gap: 14px;
  margin-top: 56px; padding-top: 32px;
  border-top: 1px solid var(--border);
}
.bv-pager a {
  display: block; padding: 14px 18px;
  background: #fff; border: 1px solid var(--border); border-radius: 12px;
  text-decoration: none;
  transition: border-color 200ms var(--ease-out);
}
.bv-pager a:hover { border-color: var(--accent); }
.bv-pager .bv-pager-dir {
  font-family: var(--font-sans); font-size: 11.5px; font-weight: 700;
  text-transform: uppercase; letter-spacing: 0.08em;
  color: var(--fg3); margin-bottom: 4px;
}
.bv-pager .bv-pager-ttl {
  font-family: var(--font-serif); font-weight: 600; font-size: 16px;
  color: var(--fg1); text-decoration: none;
}
.bv-pager a.next { text-align: right; }
.bv-pager .bv-pager-spacer { /* empty placeholder for prev OR next slot */ }

/* ============================================================
   Marketing-shaped page (community, etc.) — when no docs sidebar
   ============================================================ */
.bv-marketing {
  max-width: 1000px;
  margin: 0 auto;
  padding: 48px 28px 80px;
}

/* ============================================================
   Footer (slim, consistent across all pages)
   ============================================================ */
.bv-footer {
  background: var(--bg-alt);
  border-top: 1px solid var(--border);
  padding: 28px 28px;
  margin-top: 0;
}
.bv-footer-inner {
  max-width: 1400px; margin: 0 auto;
  display: flex; align-items: center; justify-content: space-between;
  gap: 16px; flex-wrap: wrap;
  font-family: var(--font-sans); font-size: 12.5px; color: var(--fg3);
}
.bv-footer-inner a { color: var(--fg3); text-decoration: none; }
.bv-footer-inner a:hover { color: var(--accent); }
.bv-footer-left { display: flex; align-items: center; gap: 10px; flex-wrap: wrap; }
.bv-footer-left .bv-foot-sep { color: var(--border-strong); }
.bv-footer-status {
  display: inline-flex; align-items: center; gap: 6px;
  font-family: var(--font-mono); font-size: 11.5px;
  color: var(--beava-success);
  padding: 3px 9px; border-radius: 999px;
  background: var(--beava-success-wash); border: 1px solid #cfdcbd;
}
.bv-footer-status .bv-status-dot {
  width: 6px; height: 6px; border-radius: 999px;
  background: var(--beava-success);
  box-shadow: 0 0 0 0 var(--beava-success);
  animation: bv-pulse 1.6s ease-out infinite;
}
@keyframes bv-pulse {
  0% { box-shadow: 0 0 0 0 rgba(74,122,58,0.4); }
  100% { box-shadow: 0 0 0 8px rgba(74,122,58,0); }
}
.bv-footer-right { display: flex; align-items: center; gap: 14px; }

/* ============================================================
   Component shims (for the 10 prototypes — kept for pages that use them)
   ============================================================ */

/* Card */
.bv-card {
  display: block;
  padding: 18px 20px;
  background: #fff;
  border: 1px solid var(--border);
  border-radius: 14px;
  text-decoration: none;
  box-shadow: 0 1px 2px rgba(26,23,20,0.04);
  transition: border-color 200ms var(--ease-out), transform 200ms var(--ease-out);
  position: relative;
  color: inherit;
}
.bv-card:hover { border-color: var(--border-strong); transform: translateY(-1px); }
.bv-card .bv-card-title {
  font-family: var(--font-serif); font-weight: 600;
  font-size: 18px; line-height: 1.25; color: var(--fg1); margin: 0 0 4px;
}
.bv-card .bv-card-desc {
  font-family: var(--font-sans); font-size: 13px; line-height: 1.5;
  color: var(--fg3); margin: 0;
}
.bv-card .bv-card-kicker {
  font-family: var(--font-sans); font-size: 11px; font-weight: 700;
  text-transform: uppercase; letter-spacing: 0.08em;
  color: var(--fg3); margin: 0 0 8px;
}
.bv-card .bv-card-kicker.accent { color: var(--accent); }
.bv-card.compact { padding: 14px 16px; border-radius: 12px; }
.bv-card.compact .bv-card-title { font-family: var(--font-sans); font-size: 14px; font-weight: 600; }
.bv-card.compact .bv-card-desc { font-size: 12.5px; }
.bv-card-grid { display: grid; grid-template-columns: 1fr 1fr; gap: 12px; margin: 0 0 22px; }
.bv-card .bv-card-arrow { display: none; }
@media (max-width: 720px) { .bv-card-grid { grid-template-columns: 1fr; } }

/* StatGrid */
.bv-stat-grid {
  display: grid; grid-template-columns: repeat(3, 1fr);
  gap: 0;
  background: #fff;
  border: 1px solid var(--border);
  border-radius: 14px;
  overflow: hidden;
  margin: 0 0 22px;
}
.bv-stat-grid .bv-stat {
  padding: 18px 20px;
  border-right: 1px solid var(--border);
  display: flex; flex-direction: column; gap: 4px;
}
.bv-stat-grid .bv-stat:last-child { border-right: 0; }
.bv-stat .bv-stat-label {
  font-family: var(--font-sans); font-size: 11px; font-weight: 700;
  text-transform: uppercase; letter-spacing: 0.08em;
  color: var(--fg3);
}
.bv-stat .bv-stat-num {
  font-family: var(--font-serif); font-weight: 600;
  font-size: 32px; line-height: 1.05; letter-spacing: -0.02em;
  color: var(--fg1); font-feature-settings: "tnum" on, "lnum" on;
}
.bv-stat .bv-stat-unit { font-family: var(--font-sans); font-size: 13px; color: var(--fg3); font-weight: 500; margin-left: 4px; }
.bv-stat-grid.lg .bv-stat .bv-stat-num { font-size: 38px; }
@media (max-width: 720px) {
  .bv-stat-grid { grid-template-columns: 1fr 1fr; }
  .bv-stat-grid .bv-stat { border-right: 0; border-bottom: 1px solid var(--border); }
}

/* RFC list (lighter, for inside docs content) */
.bv-rfc-list {
  background: #fff;
  border: 1px solid var(--border);
  border-radius: 12px;
  overflow: hidden;
  margin: 0 0 22px;
}
.bv-rfc-row {
  display: grid; grid-template-columns: 92px 1fr auto;
  gap: 16px; align-items: center;
  padding: 12px 16px;
  border-bottom: 1px solid var(--border);
  text-decoration: none;
  transition: background 150ms var(--ease-out);
  color: inherit;
}
.bv-rfc-row:last-child { border-bottom: 0; }
.bv-rfc-row:hover { background: var(--beava-paper); }
.bv-rfc-row .bv-rfc-id {
  font-family: var(--font-mono); font-weight: 600; font-size: 12px;
  color: var(--fg3); letter-spacing: 0.02em;
}
.bv-rfc-row .bv-rfc-title {
  font-family: var(--font-sans); font-weight: 600; font-size: 14px;
  color: var(--fg1); margin: 0 0 2px;
}
.bv-rfc-row .bv-rfc-desc {
  font-family: var(--font-sans); font-size: 12.5px; line-height: 1.45;
  color: var(--fg3); margin: 0;
}
.bv-rfc-status {
  font-family: var(--font-sans); font-weight: 500; font-size: 11px;
  padding: 3px 9px; border-radius: 999px;
  background: var(--beava-paper); border: 1px solid var(--border);
  color: var(--fg3); white-space: nowrap;
}
.bv-rfc-status.draft   { background: var(--beava-warn-wash); border-color: #ecd89a; color: #8b6312; }
.bv-rfc-status.review  { background: var(--beava-info-wash); border-color: #cadae4; color: var(--beava-info); }
.bv-rfc-status.shipped { background: var(--beava-orange-wash); border-color: color-mix(in oklab, var(--accent) 30%, transparent); color: var(--accent); }
@media (max-width: 720px) {
  .bv-rfc-row { grid-template-columns: 1fr; }
  .bv-rfc-row .bv-rfc-id { color: var(--accent); font-weight: 700; }
}

/* Anti-claim badge — preserved for hero use */
.bv-anti-row { display: flex; flex-wrap: wrap; gap: 8px 14px; align-items: baseline; margin: 0 0 22px; }
.bv-anti {
  display: inline-flex; align-items: baseline; gap: 5px;
  font-family: var(--font-sans);
  font-size: 13px; line-height: 1;
  color: var(--fg1); white-space: nowrap;
  padding: 5px 10px;
  background: #fff;
  border-radius: 999px;
  box-shadow: 0 0 0 1px var(--border-inset);
}
.bv-anti .bv-anti-pre { font-style: italic; font-weight: 400; color: var(--accent); }
.bv-anti .bv-anti-word { font-weight: 600; color: var(--fg1); }
.bv-anti .bv-anti-word.mono { font-family: var(--font-mono); font-weight: 500; font-size: 12px; }

/* Code block (kept compatible with CodeBlock.jsx) */
.bv-codeblock {
  position: relative;
  margin: 18px 0 22px;
}
.bv-codeblock pre {
  font-family: var(--font-mono); font-size: 13.5px; line-height: 1.65;
  background: var(--code-bg); color: var(--code-fg);
  padding: 16px 18px; padding-top: 32px;
  border-radius: 10px; border: 1px solid var(--border);
  margin: 0; overflow-x: auto;
}
.bv-codeblock-meta {
  position: absolute; top: 8px; right: 10px;
  display: flex; align-items: center; gap: 8px;
}
.bv-codeblock-lang {
  font-family: var(--font-mono); font-size: 11px; color: var(--fg3);
  text-transform: uppercase; letter-spacing: 0.05em;
}
.bv-codeblock-copy {
  display: inline-flex; align-items: center; gap: 5px;
  background: #fff; border: 1px solid var(--border); border-radius: 6px;
  padding: 3px 8px; cursor: pointer;
  color: var(--fg2); font-family: var(--font-sans); font-size: 11px;
}

/* Responsive: collapse to single column under 1000px */
@media (max-width: 1000px) {
  .bv-docs-shell { grid-template-columns: 1fr; padding: 0 16px; }
  .bv-side { display: none; }
  .bv-toc { display: none; }
  .bv-content { padding: 24px 0 80px; }
}

/* ─── Code blocks ────────────────────────────────────────────
   Used by the <Code> component in DocsShared.jsx. The hljs.*
   classes below map highlight.js tokens to the warm code
   palette declared in colors_and_type.css. */
.bv-code {
  font-family: var(--font-mono);
  font-size: 13.5px;
  line-height: 1.65;
  background: var(--code-bg);
  color: var(--code-fg);
  padding: 16px 18px;
  border-radius: 10px;
  border: 1px solid var(--border);
  margin: 18px 0 22px;
  overflow-x: auto;
}
.bv-code code,
.bv-code .hljs {
  background: transparent;
  color: var(--code-fg);
  padding: 0;
  font: inherit;
}
.bv-code .hljs-comment,
.bv-code .hljs-quote                       { color: var(--code-comment); font-style: italic; }
.bv-code .hljs-keyword,
.bv-code .hljs-selector-tag,
.bv-code .hljs-meta,
.bv-code .hljs-meta .hljs-keyword          { color: var(--code-keyword); }
.bv-code .hljs-string,
.bv-code .hljs-doctag,
.bv-code .hljs-attr,
.bv-code .hljs-template-variable           { color: var(--code-string); }
.bv-code .hljs-number,
.bv-code .hljs-literal,
.bv-code .hljs-symbol,
.bv-code .hljs-bullet                      { color: var(--code-number); }
.bv-code .hljs-title.function_,
.bv-code .hljs-title.invoke__,
.bv-code .hljs-function .hljs-title        { color: var(--code-fn); }
.bv-code .hljs-built_in,
.bv-code .hljs-type,
.bv-code .hljs-title.class_,
.bv-code .hljs-class .hljs-title           { color: var(--code-type); }
.bv-code .hljs-params,
.bv-code .hljs-property,
.bv-code .hljs-variable                    { color: var(--code-fg); }
.bv-code .hljs-punctuation                 { color: var(--code-punctuation); }
.bv-code .hljs-tag,
.bv-code .hljs-name,
.bv-code .hljs-selector-id,
.bv-code .hljs-selector-class              { color: var(--code-keyword); }
.bv-code .hljs-attribute,
.bv-code .hljs-section                     { color: var(--code-fn); }
.bv-code .hljs-emphasis                    { font-style: italic; }
.bv-code .hljs-strong                      { font-weight: 600; }
.bv-code .hljs-link                        { color: var(--accent); text-decoration: underline; }
.bv-code .hljs-addition                    { color: var(--code-string); background: rgba(74,122,58,0.08); }
.bv-code .hljs-deletion                    { color: var(--code-keyword); background: rgba(184,92,32,0.08); }

/* ─── Copy-link icon on H2/H3 with id ─────────────────────────
   Same affordance as docs.css. Injected by /scripts/docs-headings.js. */
.heading-anchor-link {
  display: inline-flex;
  align-items: center;
  margin-left: 10px;
  vertical-align: 2px;
  width: 18px;
  height: 18px;
  padding: 2px;
  border-radius: 5px;
  color: var(--fg3);
  opacity: 0;
  transition: opacity 120ms ease-out, color 120ms ease-out, background 120ms ease-out;
  text-decoration: none;
}
.heading-anchor-link svg { width: 14px; height: 14px; display: block; }
.bv-content h1:hover .heading-anchor-link,
.bv-content h2:hover .heading-anchor-link,
.bv-content h3:hover .heading-anchor-link,
.bv-content h4:hover .heading-anchor-link { opacity: 0.55; }
.heading-anchor-link:hover { opacity: 1 !important; color: var(--accent); background: var(--beava-orange-wash); }
.heading-anchor-link.copied { opacity: 1 !important; color: var(--beava-success); background: var(--beava-success-wash); }
.heading-anchor-link.copied::after {
  content: "Copied";
  margin-left: 6px;
  font-family: var(--font-sans);
  font-size: 11px;
  font-weight: 600;
}

/* ─── Mascot-led help callout (mirrors docs.css for React docs) ─── */
.docs-help-callout {
  margin: 48px 0 8px;
  padding: 18px 22px;
  background: var(--beava-paper);
  border: 1px solid var(--border);
  border-radius: 14px;
  display: flex; gap: 18px; align-items: center;
  position: relative; overflow: hidden;
}
.docs-help-mascot { flex-shrink: 0; align-self: flex-end; margin-bottom: -6px; }
.docs-help-body { flex: 1; min-width: 0; }
.docs-help-kicker {
  font-family: var(--font-accent);
  font-size: 18px; font-weight: 700;
  color: var(--accent);
  transform: rotate(-2deg); transform-origin: left center;
  display: inline-block; margin-bottom: 4px;
}
.docs-help-text {
  font-family: var(--font-sans);
  font-size: 14px; line-height: 1.55;
  color: var(--fg2); margin: 0 0 12px; text-wrap: pretty;
}
.docs-help-actions { display: flex; gap: 8px; flex-wrap: wrap; }
.bv-content .docs-help-cta-primary,
.docs-help-cta-primary {
  display: inline-flex; align-items: center; gap: 6px;
  padding: 8px 16px; border-radius: 8px;
  background: var(--accent) !important; color: #fff !important;
  border: 1px solid var(--accent);
  font-family: var(--font-sans); font-size: 13px; font-weight: 600;
  text-decoration: none !important;
  transition: background 150ms ease-out;
}
.bv-content .docs-help-cta-primary:hover,
.docs-help-cta-primary:hover { background: var(--accent-hover) !important; }
.bv-content .docs-help-cta-ghost,
.docs-help-cta-ghost {
  display: inline-flex; align-items: center; gap: 6px;
  padding: 8px 16px; border-radius: 8px;
  background: #fff; color: var(--fg1) !important;
  border: 1px solid var(--border);
  font-family: var(--font-sans); font-size: 13px; font-weight: 500;
  text-decoration: none !important;
  transition: border-color 150ms ease-out;
}
.bv-content .docs-help-cta-ghost:hover,
.docs-help-cta-ghost:hover { border-color: var(--accent); color: var(--accent) !important; }