/* reference.css — additive component kit for the English reference pages.
   Introduces only new .ref-* classes, so existing pages and other locales are unaffected. */

:root {
  --ref-void: #080b0c;
  --ref-deep: #101517;
  --ref-stone: #171d1f;
  --ref-card: #1d2426;
  --ref-text: #f4f2ea;
  --ref-muted: #aaafae;
  --ref-dim: #7a8080;
  --ref-green: #63a636;
  --ref-green-bright: #7bc44a;
  --ref-amber: #e5a348;
  --ref-purple: #9b5de5;
  --ref-cyan: #35d6d0;
  --ref-border: rgba(155, 93, 229, 0.2);
  --ref-max: 1240px;
  --ref-narrow: 780px;
}

/* ---------- layout ---------- */

.ref-section {
  padding: clamp(2.75rem, 6vw, 4.5rem) 1.25rem;
  background: var(--ref-void);
  color: var(--ref-text);
  font-family: var(--font-body, "IBM Plex Sans", system-ui, sans-serif);
}

.ref-section--deep { background: var(--ref-deep); }
.ref-section--stone { background: var(--ref-stone); }

.ref-wrap {
  max-width: var(--ref-max);
  margin-inline: auto;
}

.ref-wrap--narrow { max-width: var(--ref-narrow); }

.ref-kicker {
  font-size: 0.6875rem;
  letter-spacing: 0.22em;
  text-transform: uppercase;
  color: var(--ref-cyan);
  margin: 0 0 0.625rem;
}

.ref-title {
  font-family: var(--font-display, "Russo One", sans-serif);
  font-size: clamp(1.35rem, 3vw, 2rem);
  line-height: 1.2;
  color: var(--ref-text);
  margin: 0 0 0.875rem;
  text-transform: uppercase;
  letter-spacing: 0.01em;
}

.ref-subtitle {
  font-family: var(--font-display, "Russo One", sans-serif);
  font-size: 1.0625rem;
  color: var(--ref-text);
  margin: 2rem 0 0.75rem;
  text-transform: uppercase;
  letter-spacing: 0.03em;
}

.ref-lead {
  font-size: 1rem;
  line-height: 1.7;
  color: var(--ref-muted);
  margin: 0 0 1.25rem;
  max-width: 68ch;
}

.ref-prose p {
  font-size: 0.9375rem;
  line-height: 1.75;
  color: var(--ref-muted);
  margin: 0 0 0.875rem;
}

.ref-prose p:last-child { margin-bottom: 0; }
.ref-prose strong { color: var(--ref-text); font-weight: 600; }

.ref-answer {
  font-size: 1.0625rem;
  line-height: 1.7;
  color: var(--ref-text);
  border-left: 4px solid var(--ref-green);
  padding: 0 0 0 1.125rem;
  margin: 0 0 1.5rem;
  max-width: 72ch;
}

/* ---------- evidence labels ---------- */

.ref-badge {
  display: inline-flex;
  align-items: center;
  gap: 0.375rem;
  font-size: 0.625rem;
  font-weight: 600;
  letter-spacing: 0.12em;
  text-transform: uppercase;
  padding: 0.2rem 0.45rem;
  border: 1px solid currentColor;
  white-space: nowrap;
  vertical-align: middle;
}

.ref-badge--verified { color: var(--ref-green-bright); }
.ref-badge--varies { color: var(--ref-amber); }
.ref-badge--community { color: var(--ref-cyan); }
.ref-badge--upcoming { color: var(--ref-purple); }

.ref-legend {
  display: grid;
  gap: 0.75rem;
  grid-template-columns: repeat(auto-fit, minmax(240px, 1fr));
  margin: 0 0 1.75rem;
  padding: 1.125rem;
  background: var(--ref-card);
  border: 1px solid var(--ref-border);
}

.ref-legend > div {
  font-size: 0.8125rem;
  line-height: 1.6;
  color: var(--ref-muted);
}

.ref-legend .ref-badge { margin-bottom: 0.4rem; }

.ref-source {
  display: block;
  font-size: 0.75rem;
  line-height: 1.65;
  color: var(--ref-dim);
  margin: 0.5rem 0 0;
}

.ref-source a {
  color: var(--ref-green-bright);
  text-decoration: underline;
  text-underline-offset: 2px;
}

.ref-source a:hover { color: var(--ref-cyan); }

.ref-updated {
  display: inline-block;
  font-size: 0.6875rem;
  letter-spacing: 0.1em;
  text-transform: uppercase;
  color: var(--ref-dim);
  border-top: 1px solid var(--ref-border);
  padding-top: 0.5rem;
  margin-top: 1.5rem;
}

/* ---------- tables ---------- */

.ref-table-wrap {
  overflow-x: auto;
  border: 1px solid var(--ref-border);
  background: var(--ref-deep);
  margin: 0 0 0.75rem;
}

.ref-table {
  width: 100%;
  border-collapse: collapse;
  font-size: 0.8125rem;
  min-width: 720px;
}

.ref-table caption {
  caption-side: top;
  text-align: left;
  padding: 0.875rem 1rem;
  font-size: 0.8125rem;
  line-height: 1.6;
  color: var(--ref-muted);
  background: var(--ref-card);
  border-bottom: 1px solid var(--ref-border);
}

.ref-table th,
.ref-table td {
  padding: 0.6875rem 0.875rem;
  border-bottom: 1px solid var(--ref-border);
  text-align: left;
  vertical-align: top;
  line-height: 1.55;
}

.ref-table thead th {
  font-family: var(--font-display, "Russo One", sans-serif);
  font-size: 0.6875rem;
  letter-spacing: 0.08em;
  text-transform: uppercase;
  color: var(--ref-text);
  background: var(--ref-stone);
}

.ref-table tbody th {
  color: var(--ref-text);
  font-weight: 600;
}

.ref-table td { color: var(--ref-muted); }
.ref-table tbody tr:last-child th,
.ref-table tbody tr:last-child td { border-bottom: 0; }

.ref-table .yes { color: var(--ref-green-bright); font-weight: 600; }
.ref-table .no { color: #6d7474; }
.ref-table .part { color: var(--ref-amber); }

/* ---------- decision guide ---------- */

.ref-decision {
  display: grid;
  gap: 1rem;
  counter-reset: refstep;
}

.ref-step {
  background: var(--ref-card);
  border: 1px solid var(--ref-border);
  border-left: 4px solid var(--ref-purple);
  padding: 1.125rem 1.25rem;
}

.ref-step__q {
  font-family: var(--font-display, "Russo One", sans-serif);
  font-size: 0.9375rem;
  color: var(--ref-text);
  margin: 0 0 0.625rem;
  text-transform: uppercase;
  letter-spacing: 0.02em;
}

.ref-step__q::before {
  counter-increment: refstep;
  content: counter(refstep) ". ";
  color: var(--ref-purple);
}

.ref-step dl {
  margin: 0;
  display: grid;
  gap: 0.25rem;
}

.ref-step dt {
  font-size: 0.8125rem;
  font-weight: 600;
  color: var(--ref-cyan);
  margin: 0.35rem 0 0;
}

.ref-step dd {
  font-size: 0.8125rem;
  line-height: 1.65;
  color: var(--ref-muted);
  margin: 0 0 0.35rem;
}

.ref-outcomes {
  display: grid;
  gap: 1rem;
  grid-template-columns: repeat(auto-fit, minmax(240px, 1fr));
  margin-top: 1.25rem;
}

.ref-outcome {
  background: var(--ref-deep);
  border: 1px solid var(--ref-border);
  border-top: 4px solid var(--ref-green);
  padding: 1.125rem;
}

.ref-outcome h3 {
  font-family: var(--font-display, "Russo One", sans-serif);
  font-size: 0.875rem;
  color: var(--ref-text);
  margin: 0 0 0.5rem;
  text-transform: uppercase;
  letter-spacing: 0.04em;
}

.ref-outcome p {
  font-size: 0.8125rem;
  line-height: 1.65;
  color: var(--ref-muted);
  margin: 0 0 0.5rem;
}

.ref-outcome p:last-child { margin-bottom: 0; }

/* ---------- cards ---------- */

.ref-grid {
  display: grid;
  gap: 1rem;
  grid-template-columns: repeat(auto-fit, minmax(260px, 1fr));
}

.ref-grid--two { grid-template-columns: repeat(auto-fit, minmax(320px, 1fr)); }

.ref-card {
  background: var(--ref-card);
  border: 1px solid var(--ref-border);
  padding: 1.125rem 1.25rem;
}

.ref-card h3 {
  font-family: var(--font-display, "Russo One", sans-serif);
  font-size: 0.9375rem;
  color: var(--ref-text);
  margin: 0 0 0.625rem;
  text-transform: uppercase;
  letter-spacing: 0.03em;
  line-height: 1.35;
}

.ref-card p {
  font-size: 0.8125rem;
  line-height: 1.7;
  color: var(--ref-muted);
  margin: 0 0 0.625rem;
}

.ref-card p:last-child { margin-bottom: 0; }

.ref-card--warn { border-left: 4px solid #b4553f; }
.ref-card--ok { border-left: 4px solid var(--ref-green); }

/* ---------- lists ---------- */

.ref-check {
  list-style: none;
  margin: 0 0 1rem;
  padding: 0;
  display: grid;
  gap: 0.625rem;
}

.ref-check li {
  position: relative;
  padding-left: 1.75rem;
  font-size: 0.875rem;
  line-height: 1.7;
  color: var(--ref-muted);
}

.ref-check li::before {
  content: "";
  position: absolute;
  left: 0;
  top: 0.4em;
  width: 0.7rem;
  height: 0.7rem;
  border: 2px solid var(--ref-green);
}

.ref-check strong { color: var(--ref-text); font-weight: 600; }

.ref-steps {
  margin: 0 0 1rem;
  padding-left: 1.375rem;
  display: grid;
  gap: 0.5rem;
}

.ref-steps li {
  font-size: 0.875rem;
  line-height: 1.7;
  color: var(--ref-muted);
}

.ref-steps strong { color: var(--ref-text); font-weight: 600; }

.ref-kv {
  margin: 0;
  display: grid;
  gap: 0.75rem;
}

.ref-kv > div {
  display: grid;
  gap: 0.3rem;
  padding-bottom: 0.75rem;
  border-bottom: 1px solid var(--ref-border);
}

.ref-kv > div:last-child { border-bottom: 0; padding-bottom: 0; }

.ref-kv dt {
  font-size: 0.875rem;
  font-weight: 600;
  color: var(--ref-text);
  line-height: 1.5;
}

.ref-kv dd {
  margin: 0;
  font-size: 0.8125rem;
  line-height: 1.7;
  color: var(--ref-muted);
}

/* ---------- callouts ---------- */

.ref-callout {
  background: var(--ref-card);
  border: 1px solid var(--ref-border);
  border-left: 4px solid var(--ref-cyan);
  padding: 1rem 1.25rem;
  margin: 0 0 1.5rem;
}

.ref-callout--warn { border-left-color: var(--ref-amber); }
.ref-callout--stop { border-left-color: #b4553f; }

.ref-callout p {
  font-size: 0.875rem;
  line-height: 1.7;
  color: var(--ref-muted);
  margin: 0 0 0.5rem;
}

.ref-callout p:last-child { margin-bottom: 0; }
.ref-callout strong { color: var(--ref-text); font-weight: 600; }

.ref-callout a,
.ref-prose a,
.ref-card a,
.ref-outcome a,
.ref-check a,
.ref-steps a,
.ref-kv a,
.ref-table a,
.ref-answer a,
.ref-lead a {
  color: var(--ref-green-bright);
  text-decoration: underline;
  text-underline-offset: 2px;
}

.ref-callout a:hover,
.ref-prose a:hover,
.ref-card a:hover,
.ref-outcome a:hover,
.ref-check a:hover,
.ref-steps a:hover,
.ref-kv a:hover,
.ref-table a:hover,
.ref-answer a:hover,
.ref-lead a:hover { color: var(--ref-cyan); }

/* ---------- official destinations ---------- */

.ref-links {
  list-style: none;
  margin: 0;
  padding: 0;
  display: grid;
  gap: 0.5rem;
}

.ref-links li {
  display: flex;
  flex-wrap: wrap;
  gap: 0.25rem 0.625rem;
  align-items: baseline;
  padding: 0.75rem 0.875rem;
  background: var(--ref-deep);
  border: 1px solid var(--ref-border);
  font-size: 0.8125rem;
  line-height: 1.65;
  color: var(--ref-muted);
}

.ref-links b {
  color: var(--ref-text);
  font-weight: 600;
  min-width: 9rem;
}

.ref-links a {
  color: var(--ref-green-bright);
  text-decoration: underline;
  text-underline-offset: 2px;
}

.ref-links a:hover { color: var(--ref-cyan); }

.ref-ext::after {
  content: " \2197";
  font-size: 0.85em;
  color: var(--ref-dim);
}

/* ---------- in-page nav ---------- */

.ref-jump {
  display: flex;
  flex-wrap: wrap;
  gap: 0.5rem;
  margin: 0 0 1.75rem;
  padding: 0;
  list-style: none;
}

.ref-jump a {
  display: inline-block;
  padding: 0.4375rem 0.75rem;
  font-size: 0.75rem;
  letter-spacing: 0.06em;
  text-transform: uppercase;
  color: var(--ref-muted);
  background: var(--ref-card);
  border: 1px solid var(--ref-border);
  text-decoration: none;
}

.ref-jump a:hover {
  color: var(--ref-text);
  border-color: var(--ref-green);
}

/* ---------- scroll offset for anchor links under the fixed header ---------- */

.ref-section[id],
[id^="cat-"],
[id^="q-"] { scroll-margin-top: calc(var(--nav-h, 70px) + 2rem); }

/* ---------- responsive ---------- */

@media (max-width: 640px) {
  .ref-table { min-width: 560px; font-size: 0.75rem; }
  .ref-links b { min-width: 0; display: block; width: 100%; }
  .ref-answer { font-size: 1rem; }
  .ref-section { padding-inline: 1rem; }
}
