/* ════════════════════════════════════════════════════════════════════
   Fieldcraft — buyer documentation site
   Styled with the theme's own tokens (assets/css/tokens.css, imported
   in every page before this file). Docs-only layout rules live here;
   no design value is hardcoded — everything traces back to a token.
   ════════════════════════════════════════════════════════════════════ */

@font-face {
  font-family: "Big Shoulders";
  src: url("../fonts/big-shoulders-latin.woff2") format("woff2");
  font-weight: 400 800;
  font-display: swap;
}
@font-face {
  font-family: "IBM Plex Sans";
  src: url("../fonts/ibm-plex-sans-latin.woff2") format("woff2");
  font-weight: 400;
  font-display: swap;
}
@font-face {
  font-family: "IBM Plex Mono";
  src: url("../fonts/ibm-plex-mono-400-latin.woff2") format("woff2");
  font-weight: 400;
  font-display: swap;
}
@font-face {
  font-family: "IBM Plex Mono";
  src: url("../fonts/ibm-plex-mono-500-latin.woff2") format("woff2");
  font-weight: 500;
  font-display: swap;
}

* { box-sizing: border-box; }
html { scroll-behavior: smooth; }

body {
  margin: 0;
  background: var(--iron);
  color: var(--bone);
  font-family: "IBM Plex Sans", sans-serif;
  font-size: 1rem;
  line-height: var(--leading-body, 1.6);
  -webkit-font-smoothing: antialiased;
}

a { color: var(--amber); text-decoration-color: var(--amber-outline); }
a:hover { color: var(--amber-hot); }
a:focus-visible, button:focus-visible, summary:focus-visible {
  outline: var(--focus-outline) solid var(--amber);
  outline-offset: var(--focus-offset);
}

h1, h2, h3, h4 {
  font-family: "Big Shoulders", sans-serif;
  font-weight: 700;
  text-transform: uppercase;
  letter-spacing: 0.01em;
  line-height: 0.98;
  margin: 0 0 var(--gap-md) 0;
}

code, pre, kbd, .mono {
  font-family: "IBM Plex Mono", monospace;
}

p { margin: 0 0 1.1em 0; max-width: var(--measure-reading); }

/* ── skip link ─────────────────────────────────────────────────── */
.skip-link {
  position: absolute;
  left: -999px;
  top: 0;
  z-index: var(--z-skip);
  background: var(--amber);
  color: var(--iron);
  padding: 0.6em 1em;
  font-family: "IBM Plex Mono", monospace;
  text-transform: uppercase;
  font-size: 0.75rem;
}
.skip-link:focus { left: 1rem; top: 1rem; }

/* ── top bar ───────────────────────────────────────────────────── */
.docs-topbar {
  position: sticky;
  top: 0;
  z-index: var(--z-header);
  display: flex;
  align-items: center;
  justify-content: space-between;
  gap: var(--nav-gap);
  padding: 1rem clamp(1.25rem, 4vw, 3rem);
  background: var(--scrim-header);
  backdrop-filter: blur(var(--blur-header));
  border-bottom: var(--rule-1) solid var(--hairline);
}
.docs-brand {
  font-family: "Big Shoulders", sans-serif;
  font-weight: 800;
  text-transform: uppercase;
  font-size: clamp(1.1rem, 2vw, 1.4rem);
  letter-spacing: 0.02em;
  color: var(--bone);
  text-decoration: none;
  display: flex;
  align-items: baseline;
  gap: 0.5ch;
}
.docs-brand span { color: var(--amber); }
.docs-brand small {
  font-family: "IBM Plex Mono", monospace;
  font-weight: 400;
  text-transform: none;
  font-size: 0.7rem;
  color: var(--mute);
  letter-spacing: 0;
}
.docs-topbar nav { display: flex; gap: clamp(0.75rem, 2vw, 1.5rem); flex-wrap: wrap; }
.docs-topbar nav a {
  font-family: "IBM Plex Mono", monospace;
  font-size: 0.75rem;
  text-transform: uppercase;
  letter-spacing: 0.06em;
  color: var(--bone-soft);
  text-decoration: none;
  padding: 0.4em 0;
  border-bottom: var(--rule-1) solid transparent;
}
.docs-topbar nav a:hover,
.docs-topbar nav a[aria-current="page"] {
  color: var(--amber);
  border-bottom-color: var(--amber);
}
.docs-topbar .search-hint {
  font-family: "IBM Plex Mono", monospace;
  font-size: 0.7rem;
  color: var(--mute);
  display: none;
}
@media (min-width: 860px) { .docs-topbar .search-hint { display: inline; } }

/* ── docs search ───────────────────────────────────────────────── */
.docs-search {
  position: relative;
  flex: 0 1 240px;
  min-width: 0;
}
.docs-search-input-wrap {
  position: relative;
  display: flex;
  align-items: center;
}
.docs-search-icon {
  position: absolute;
  left: 0.7em;
  width: 14px;
  height: 14px;
  color: var(--mute);
  pointer-events: none;
}
.docs-search-input {
  width: 100%;
  background: var(--iron-2);
  border: var(--rule-1) solid var(--hairline);
  border-radius: var(--radius-pill);
  color: var(--bone);
  font-family: "IBM Plex Mono", monospace;
  font-size: 0.78rem;
  padding: 0.5em 0.9em 0.5em 2.1em;
}
.docs-search-input::placeholder { color: var(--mute); }
.docs-search-input:focus {
  border-color: var(--amber);
}
.docs-search-input:focus-visible {
  outline: var(--focus-outline) solid var(--amber);
  outline-offset: var(--focus-offset);
}
.docs-search-kbd {
  position: absolute;
  right: 0.6em;
  font-family: "IBM Plex Mono", monospace;
  font-size: 0.65rem;
  color: var(--mute);
  border: var(--rule-1) solid var(--hairline);
  border-radius: var(--radius-sm);
  padding: 0.1em 0.4em;
  pointer-events: none;
}
@media (max-width: 700px) { .docs-search-kbd { display: none; } }

.docs-search-results {
  display: none;
  position: absolute;
  top: calc(100% + 0.5em);
  left: 0;
  right: 0;
  max-height: min(70vh, 520px);
  overflow-y: auto;
  background: var(--iron-2);
  border: var(--rule-1) solid var(--hairline);
  border-radius: var(--radius-md);
  box-shadow: 0 12px 32px rgba(0,0,0,0.45);
  z-index: var(--z-header, 40);
  padding: 0.4em;
}
.docs-search.is-open .docs-search-results { display: block; }
@media (max-width: 700px) {
  .docs-search { position: static; flex-basis: auto; }
  .docs-search-results { left: 1rem; right: 1rem; top: calc(100% + 0.35em); }
}

.docs-search-result {
  display: block;
  text-decoration: none;
  padding: 0.6em 0.75em;
  border-radius: var(--radius-sm);
}
.docs-search-result:hover,
.docs-search-result.is-active {
  background: var(--iron);
}
.docs-search-result .dsr-page {
  font-family: "IBM Plex Mono", monospace;
  font-size: 0.66rem;
  text-transform: uppercase;
  letter-spacing: 0.06em;
  color: var(--amber);
  display: block;
  margin-bottom: 0.15em;
}
.docs-search-result .dsr-heading {
  color: var(--bone);
  font-weight: 600;
  font-size: 0.92rem;
  display: block;
}
.docs-search-result .dsr-snippet {
  color: var(--bone-soft);
  font-size: 0.82rem;
  display: block;
  margin-top: 0.15em;
}
.docs-search-result mark {
  background: transparent;
  color: var(--amber);
  font-weight: 600;
}
.docs-search-empty {
  padding: 0.9em 0.75em;
  color: var(--mute);
  font-size: 0.85rem;
  font-family: "IBM Plex Mono", monospace;
}
.docs-search-count {
  padding: 0.5em 0.75em 0.3em;
  color: var(--mute);
  font-family: "IBM Plex Mono", monospace;
  font-size: 0.65rem;
  text-transform: uppercase;
  letter-spacing: 0.06em;
}

/* ── layout: sidebar + article ────────────────────────────────── */
.docs-shell {
  display: grid;
  grid-template-columns: 1fr;
  max-width: var(--container-content);
  margin: 0 auto;
}
@media (min-width: 960px) {
  .docs-shell { grid-template-columns: 260px minmax(0, 1fr); gap: var(--gap-lg); }
}

.docs-side {
  padding: var(--gap-md) clamp(1.25rem, 3vw, 2rem) var(--gap-lg);
  border-right: var(--rule-1) solid var(--hairline);
}
@media (max-width: 959px) {
  .docs-side { border-right: none; border-bottom: var(--rule-1) solid var(--hairline); }
}
.docs-side h2 {
  font-size: 0.75rem;
  font-family: "IBM Plex Mono", monospace;
  text-transform: uppercase;
  letter-spacing: 0.08em;
  color: var(--mute);
  margin: 1.5em 0 0.6em;
}
.docs-side h2:first-child { margin-top: 0; }
.docs-side ul { list-style: none; margin: 0; padding: 0; }
.docs-side li { margin: 0; }
.docs-side a {
  display: block;
  padding: 0.35em 0;
  font-size: 0.9rem;
  color: var(--bone-soft);
  text-decoration: none;
  border-left: var(--rule-2) solid transparent;
  padding-left: 0.75em;
  margin-left: -0.77em;
}
.docs-side a:hover { color: var(--amber); }
.docs-side a[aria-current="page"] {
  color: var(--amber);
  border-left-color: var(--amber);
  font-weight: 600;
}

.docs-main {
  padding: var(--gap-lg) clamp(1.25rem, 4vw, 3rem) calc(var(--gap-2xl) * 1.4);
  min-width: 0;
}

.docs-kicker {
  font-family: "IBM Plex Mono", monospace;
  text-transform: uppercase;
  font-size: 0.75rem;
  letter-spacing: 0.1em;
  color: var(--amber);
  display: flex;
  align-items: center;
  gap: 0.6ch;
  margin-bottom: 0.75em;
}
.docs-kicker::before {
  content: "";
  width: var(--size-kicker-square);
  height: var(--size-kicker-square);
  background: var(--amber);
  display: inline-block;
}

.docs-main h1 { font-size: clamp(2rem, 5vw, 3.2rem); }
.docs-main h2 {
  font-size: clamp(1.35rem, 2.6vw, 1.8rem);
  margin-top: var(--gap-lg);
  padding-top: var(--gap-md);
  border-top: var(--rule-1) solid var(--hairline);
}
.docs-main h2:first-of-type { border-top: none; padding-top: 0; }
.docs-main h3 {
  font-size: 1.15rem;
  text-transform: none;
  font-family: "IBM Plex Sans", sans-serif;
  font-weight: 700;
  margin-top: 1.6em;
}
.lede {
  font-size: 1.15rem;
  color: var(--bone-soft);
  max-width: var(--measure-lede);
}

.docs-main ul, .docs-main ol { padding-left: 1.3em; max-width: var(--measure-reading); }
.docs-main li { margin-bottom: 0.5em; }
.fine {
  font-size: var(--text-small);
  color: var(--bone-soft);
  max-width: var(--measure-reading);
}

/* ── callouts ──────────────────────────────────────────────────── */
.callout {
  border: var(--rule-1) solid var(--hairline);
  border-left: var(--rule-4) solid var(--amber);
  background: var(--iron-2);
  padding: 1em 1.25em;
  margin: 1.5em 0;
  border-radius: var(--radius-sm);
}
.callout p:last-child { margin-bottom: 0; }
.callout.warn { border-left-color: var(--amber-hot); }
.callout .callout-label {
  font-family: "IBM Plex Mono", monospace;
  text-transform: uppercase;
  font-size: 0.7rem;
  letter-spacing: 0.08em;
  color: var(--amber);
  display: block;
  margin-bottom: 0.4em;
}

/* ── tables ────────────────────────────────────────────────────── */
.docs-main table {
  width: 100%;
  border-collapse: collapse;
  margin: 1.25em 0 2em;
  font-size: 0.92rem;
}
.docs-main th, .docs-main td {
  text-align: left;
  padding: 0.6em 0.8em;
  border-bottom: var(--rule-1) solid var(--hairline);
  vertical-align: top;
}
.docs-main th {
  font-family: "IBM Plex Mono", monospace;
  text-transform: uppercase;
  font-size: 0.7rem;
  letter-spacing: 0.06em;
  color: var(--mute);
  border-bottom: var(--rule-2) solid var(--hairline);
}
.docs-main tr:last-child td { border-bottom: none; }

/* ── code blocks ───────────────────────────────────────────────── */
.docs-main pre {
  background: var(--iron-2);
  border: var(--rule-1) solid var(--hairline);
  border-radius: var(--radius-sm);
  padding: 1em 1.25em;
  overflow-x: auto;
  font-size: 0.85rem;
  line-height: 1.5;
  margin: 1.25em 0;
}
.docs-main code {
  background: var(--iron-2);
  padding: 0.15em 0.4em;
  border-radius: var(--radius-sm);
  font-size: 0.85em;
}
.docs-main pre code { background: none; padding: 0; }

/* ── live example snippets (render + code) ────────────────────────
   Each documented example gets a two-panel block: a live rendered copy
   of the real markup on top, in an isolated iframe that loads the
   theme's own real compiled stylesheet — so it reflects each example's
   true default appearance (most components are dark-first on --iron,
   only .paper-classed sections switch to the light skin themselves,
   exactly like the real template) rather than a forced skin invented
   for the docs site. The --iron-2 wrapper padding below is a shade
   removed from that --iron canvas so the panel still reads as a
   distinct "frame" holding the render, without contradicting any
   individual example's own real background. Below it, the existing
   escaped code panel, with a copy-to-clipboard affordance in its
   corner. Structure only — no rule here reuses another product's CSS
   values. */
.docs-snippet {
  border: var(--rule-1) solid var(--hairline);
  border-radius: var(--radius-md);
  margin: 1.25em 0;
  overflow: hidden;
}
.docs-snippet-render {
  background: var(--iron-2);
  padding: var(--gap-md) 1.25em;
}
.docs-snippet-render iframe {
  display: block;
  width: 100%;
  border: 0;
}
.docs-snippet-code {
  position: relative;
  border-top: var(--rule-1) solid var(--hairline);
}
.docs-snippet-code pre {
  margin: 0;
  border: 0;
  border-radius: 0;
}
.docs-snippet-copy {
  position: absolute;
  top: 0.6em;
  right: 0.6em;
  width: 2rem;
  height: 2rem;
  display: flex;
  align-items: center;
  justify-content: center;
  background: var(--iron);
  border: var(--rule-1) solid var(--hairline);
  border-radius: var(--radius-sm);
  color: var(--bone-soft);
  cursor: pointer;
}
.docs-snippet-copy svg { width: 15px; height: 15px; }
.docs-snippet-copy:hover { color: var(--amber); border-color: var(--amber-outline); }
.docs-snippet-copy.is-copied { color: var(--amber); border-color: var(--amber); }
.docs-snippet-copy .copy-label {
  position: absolute;
  top: calc(100% + 0.4em);
  right: 0;
  font-family: "IBM Plex Mono", monospace;
  font-size: 0.65rem;
  text-transform: uppercase;
  letter-spacing: 0.05em;
  color: var(--amber);
  background: var(--iron);
  border: var(--rule-1) solid var(--hairline);
  border-radius: var(--radius-sm);
  padding: 0.2em 0.5em;
  white-space: nowrap;
  opacity: 0;
  pointer-events: none;
  transition: opacity var(--duration-fast, 0.2s);
}
.docs-snippet-copy.is-copied .copy-label { opacity: 1; }

/* ── step list ─────────────────────────────────────────────────── */
.steps { counter-reset: step; list-style: none; padding-left: 0; }
.steps > li {
  counter-increment: step;
  position: relative;
  padding-left: 3rem;
  margin-bottom: 1.5em;
  min-height: 2rem;
}
.steps > li::before {
  content: counter(step);
  position: absolute;
  left: 0;
  top: -0.1em;
  width: 2.1rem;
  height: 2.1rem;
  display: flex;
  align-items: center;
  justify-content: center;
  background: var(--iron-2);
  border: var(--rule-1) solid var(--amber-outline);
  color: var(--amber);
  font-family: "IBM Plex Mono", monospace;
  font-size: 0.9rem;
  border-radius: var(--radius-full);
}

/* ── screenshot placeholder ────────────────────────────────────── */
.shot {
  border: var(--rule-1) dashed var(--hairline);
  background: var(--iron-2);
  border-radius: var(--radius-md);
  padding: var(--gap-md);
  text-align: center;
  margin: 1.5em 0;
  color: var(--mute);
  font-family: "IBM Plex Mono", monospace;
  font-size: 0.8rem;
  text-transform: uppercase;
  letter-spacing: 0.05em;
}

/* ── screenshot placeholder (captioned figure, used inside step
   walkthroughs — data-shot carries the slug the next pass captures
   the real image under) ─────────────────────────────────────────── */
.docs-shot {
  margin: 1.25em 0 1.75em;
  max-width: var(--measure-reading);
}
.docs-shot-pending {
  border: var(--rule-1) dashed var(--amber-outline);
  background: var(--iron-2);
  border-radius: var(--radius-md);
  padding: 1.75em 1.25em;
  text-align: center;
  color: var(--mute);
  font-family: "IBM Plex Mono", monospace;
  font-size: 0.72rem;
  text-transform: uppercase;
  letter-spacing: 0.05em;
}
.docs-shot-pending::before {
  content: "\1F4F7";
  display: block;
  font-size: 1.3rem;
  margin-bottom: 0.4em;
  filter: grayscale(1);
  opacity: 0.6;
}
.docs-shot figcaption {
  margin-top: 0.5em;
  font-size: 0.82rem;
  color: var(--bone-soft);
  text-align: left;
}

/* ── option cards (customizer reference) ──────────────────────── */
.opt-panel { margin: 1.5em 0 2.5em; }
.opt-panel > .opt-panel-title {
  font-family: "IBM Plex Mono", monospace;
  text-transform: uppercase;
  font-size: 0.8rem;
  letter-spacing: 0.06em;
  color: var(--bone);
  border-bottom: var(--rule-1) solid var(--hairline);
  padding-bottom: 0.4em;
  margin-bottom: 0.8em;
}
.opt-grid { display: grid; gap: 1px; background: var(--hairline); border: var(--rule-1) solid var(--hairline); }
.opt-row {
  background: var(--iron);
  padding: 0.85em 1em;
  display: grid;
  grid-template-columns: 1fr;
  gap: 0.3em;
}
@media (min-width: 700px) {
  .opt-row { grid-template-columns: minmax(0,1.3fr) minmax(0,1fr) minmax(0,2fr); align-items: center; gap: 1em; }
}
.opt-row .opt-label { font-weight: 600; color: var(--bone); }
.opt-row .opt-type {
  font-family: "IBM Plex Mono", monospace;
  font-size: 0.72rem;
  color: var(--amber);
  text-transform: uppercase;
}
.opt-row .opt-desc { color: var(--bone-soft); font-size: 0.9rem; }

/* ── cards ─────────────────────────────────────────────────────── */
.card-grid {
  display: grid;
  gap: var(--gap-md);
  grid-template-columns: 1fr;
  margin: 1.5em 0;
}
@media (min-width: 700px) { .card-grid.cols-2 { grid-template-columns: 1fr 1fr; } }
@media (min-width: 860px) { .card-grid.cols-3 { grid-template-columns: repeat(3, 1fr); } }
@media (min-width: 860px) { .card-grid.cols-4 { grid-template-columns: repeat(4, 1fr); } }

.card {
  border: var(--rule-1) solid var(--hairline);
  padding: 1.25em;
  border-radius: var(--radius-sm);
  background: var(--iron-2);
}
.card h3 { margin-top: 0; font-size: 1rem; text-transform: uppercase; font-family: "IBM Plex Mono", monospace; letter-spacing: 0.04em; color: var(--amber); }
.card p:last-child { margin-bottom: 0; }
.card .card-cta {
  display: inline-block;
  margin-top: 0.75em;
  font-family: "IBM Plex Mono", monospace;
  font-size: 0.75rem;
  text-transform: uppercase;
  letter-spacing: 0.05em;
}
.card.card-link {
  display: block;
  color: inherit;
  text-decoration: none;
  transition: border-color var(--duration-fast, 0.2s), background var(--duration-fast, 0.2s);
}
.card.card-link:hover,
.card.card-link:focus-visible {
  border-color: var(--amber);
  background: var(--iron);
}
.card.card-link:hover .card-cta,
.card.card-link:focus-visible .card-cta {
  color: var(--amber-hot);
}

/* ── framework tabs (static, CSS-only via radio pattern) ─────── */
.fw-tabs { border: var(--rule-1) solid var(--hairline); border-radius: var(--radius-sm); overflow: hidden; margin: 1.5em 0; }
.fw-tabs-head { display: flex; flex-wrap: wrap; background: var(--iron-2); border-bottom: var(--rule-1) solid var(--hairline); }
.fw-tabs-head a {
  padding: 0.75em 1.1em;
  font-family: "IBM Plex Mono", monospace;
  font-size: 0.78rem;
  text-transform: uppercase;
  letter-spacing: 0.04em;
  text-decoration: none;
  color: var(--bone-soft);
  border-right: var(--rule-1) solid var(--hairline);
}
.fw-tabs-head a:hover, .fw-tabs-head a[aria-current="true"] { color: var(--amber); background: var(--iron); }
.fw-tab-body { padding: 1.25em 1.4em; }

/* ── FAQ accordion (native <details>) ─────────────────────────── */
.faq-item {
  border-bottom: var(--rule-1) solid var(--hairline);
  padding: 1.1em 0;
}
.faq-item summary {
  cursor: pointer;
  font-weight: 600;
  font-size: 1.02rem;
  list-style: none;
  display: flex;
  justify-content: space-between;
  gap: 1em;
  align-items: baseline;
}
.faq-item summary::-webkit-details-marker { display: none; }
.faq-item summary::after {
  content: "+";
  font-family: "IBM Plex Mono", monospace;
  color: var(--amber);
  flex-shrink: 0;
}
.faq-item[open] summary::after { content: "\2212"; }
.faq-item .faq-a { margin-top: 0.7em; color: var(--bone-soft); }
.faq-item .faq-a p:last-child { margin-bottom: 0; }

/* ── credits table variants ────────────────────────────────────── */
.tag-pill {
  display: inline-block;
  font-family: "IBM Plex Mono", monospace;
  font-size: 0.68rem;
  text-transform: uppercase;
  letter-spacing: 0.04em;
  color: var(--amber);
  border: var(--rule-1) solid var(--amber-outline);
  border-radius: var(--radius-pill);
  padding: 0.15em 0.7em;
}

/* ── changelog ─────────────────────────────────────────────────── */
.changelog-entry { margin-bottom: 1.75em; }
.changelog-entry h3 {
  font-family: "IBM Plex Mono", monospace;
  text-transform: none;
  font-size: 1rem;
  color: var(--amber);
}
.changelog-entry .tag-pill { margin-left: 0.6em; }

/* ── footer ────────────────────────────────────────────────────── */
.docs-footer {
  border-top: var(--rule-1) solid var(--hairline);
  padding: var(--gap-md) clamp(1.25rem, 4vw, 3rem);
  font-family: "IBM Plex Mono", monospace;
  font-size: 0.75rem;
  color: var(--mute);
  display: flex;
  flex-wrap: wrap;
  gap: 1em 2em;
  justify-content: space-between;
}
.docs-footer a { color: var(--mute); }
.docs-footer a:hover { color: var(--amber); }

/* ── prev/next pager ───────────────────────────────────────────── */
.docs-pager {
  display: flex;
  justify-content: space-between;
  gap: 1em;
  margin-top: var(--gap-2xl);
  padding-top: var(--gap-md);
  border-top: var(--rule-1) solid var(--hairline);
  flex-wrap: wrap;
}
.docs-pager a {
  text-decoration: none;
  max-width: 45%;
}
.docs-pager .pager-label {
  display: block;
  font-family: "IBM Plex Mono", monospace;
  font-size: 0.68rem;
  text-transform: uppercase;
  color: var(--mute);
  margin-bottom: 0.2em;
}
.docs-pager .pager-next { text-align: right; margin-left: auto; }

/* ── home/index hero ───────────────────────────────────────────── */
.docs-home-hero {
  padding: clamp(2.5rem, 8vw, 5rem) clamp(1.25rem, 4vw, 3rem);
  max-width: var(--container-content);
  margin: 0 auto;
  border-bottom: var(--rule-1) solid var(--hairline);
}
.docs-home-hero h1 { font-size: clamp(2.4rem, 7vw, 4.5rem); max-width: 16ch; }
.docs-home-hero .lede { font-size: 1.25rem; }
.quicklinks {
  display: flex;
  gap: 0.75em;
  flex-wrap: wrap;
  margin-top: 1.5em;
}
.quicklinks a {
  text-decoration: none;
  font-family: "IBM Plex Mono", monospace;
  text-transform: uppercase;
  font-size: 0.78rem;
  letter-spacing: 0.04em;
  border: var(--rule-1) solid var(--hairline);
  padding: 0.6em 1em;
  color: var(--bone);
}
.quicklinks a:hover { border-color: var(--amber); color: var(--amber); }
.quicklinks a.primary { background: var(--amber); color: var(--iron); border-color: var(--amber); }
.quicklinks a.primary:hover { background: var(--amber-hot); border-color: var(--amber-hot); color: var(--iron); }

.section-index {
  max-width: var(--container-content);
  margin: 0 auto;
  padding: var(--gap-lg) clamp(1.25rem, 4vw, 3rem) var(--gap-2xl);
  display: grid;
  gap: var(--gap-md);
  grid-template-columns: 1fr;
}
@media (min-width: 700px) { .section-index { grid-template-columns: 1fr 1fr; } }
@media (min-width: 1040px) { .section-index { grid-template-columns: repeat(3, 1fr); } }

/* ── product-picker note (docs/index.html only) ───────────────────
   A single explanatory line below the WordPress/HTML product cards on
   the top-level picker page, which has no .docs-shell sidebar to inherit
   .docs-main's max-width/padding from -- reuses the same container/gap
   tokens as .section-index above it so the two stay visually aligned. */
.docs-picker-note {
  max-width: var(--container-content);
  margin: 0 auto var(--gap-2xl);
  padding: 0 clamp(1.25rem, 4vw, 3rem);
}