/*
 * doc.css — layout de la documentación.
 *
 * Usa SÓLO los tokens de styles.css (--accent, --bg-card, --text-muted…).
 * Nada de hexes propios: el sitio ya tiene una identidad y la documentación
 * tiene que verse parte de ella, no un anexo con otro diseño. Además así los
 * dos temas funcionan sin escribir una sola regla extra — los tokens ya
 * cambian solos.
 */

/* ── Estructura ───────────────────────────────────────────────────────── */
.doc-layout {
  display: grid;
  grid-template-columns: 232px minmax(0, 1fr);
  gap: 48px;
  max-width: 1140px;
  margin: 0 auto;
  padding: 48px 24px 96px;
}

/* ── Barra lateral ────────────────────────────────────────────────────── */
.doc-aside {
  position: sticky;
  top: 88px;                    /* deja pasar el header fijo */
  align-self: start;
  max-height: calc(100vh - 112px);
  overflow-y: auto;
  scrollbar-width: thin;
}

.doc-nav-grupo + .doc-nav-grupo { margin-top: 22px; }

.doc-nav-grupo h4 {
  margin: 0 0 8px;
  font-size: 11px;
  font-weight: 700;
  letter-spacing: .09em;
  text-transform: uppercase;
  color: var(--text-muted);
}

.doc-nav-grupo ul { list-style: none; margin: 0; padding: 0; }

.doc-nav-grupo a {
  display: block;
  padding: 7px 12px;
  margin-left: -12px;
  border-radius: 8px;
  font-size: 14px;
  line-height: 1.35;
  color: var(--text-muted);
  text-decoration: none;
  /* El borde va SIEMPRE presente y transparente: si sólo apareciera en el
     estado activo, el texto saltaría 3px al navegar. */
  border-left: 2px solid transparent;
  transition: color .15s, background .15s, border-color .15s;
}

.doc-nav-grupo a:hover { color: var(--text); background: var(--bg-card); }

.doc-nav-grupo a.activo {
  color: var(--accent);
  font-weight: 600;
  border-left-color: var(--accent);
  background: var(--bg-card);
}

/* ── Contenido ────────────────────────────────────────────────────────── */
.doc-main { min-width: 0; }     /* sin esto, una tabla ancha estira el grid */

.doc-main h1 {
  margin: 0 0 6px;
  font-size: clamp(28px, 4vw, 38px);
  line-height: 1.15;
  color: var(--text-heading);
  text-wrap: balance;
}

.doc-lede {
  margin: 0 0 8px;
  font-size: 17px;
  line-height: 1.6;
  color: var(--text-muted);
  max-width: 62ch;
}

.doc-sello {
  display: inline-block;
  margin-bottom: 34px;
  font-family: var(--font-mono);
  font-size: 12px;
  color: var(--text-muted);
}

.doc-main h2 {
  margin: 44px 0 14px;
  padding-top: 22px;
  border-top: 1px solid var(--border);
  font-size: 21px;
  color: var(--text-heading);
}

.doc-main h3 {
  margin: 28px 0 8px;
  font-size: 16px;
  color: var(--text-heading);
}

.doc-main p,
.doc-main li { font-size: 15px; line-height: 1.68; color: var(--text); }
.doc-main p  { max-width: 68ch; }
.doc-main ul { max-width: 68ch; padding-left: 20px; }
.doc-main li { margin: 5px 0; }

.doc-main code {
  font-family: var(--font-mono);
  font-size: .88em;
  padding: 1px 5px;
  border-radius: 5px;
  background: var(--bg-card);
  border: 1px solid var(--border);
}

/* ── Tablas ───────────────────────────────────────────────────────────── */
/* El contenedor scrollea, no la página: una tabla ancha en móvil no puede
   arrastrar el body entero de costado. */
.doc-tabla { overflow-x: auto; margin: 18px 0; }

.doc-tabla table { width: 100%; border-collapse: collapse; font-size: 14px; }

.doc-tabla th,
.doc-tabla td {
  padding: 10px 14px;
  text-align: left;
  border-bottom: 1px solid var(--border);
  vertical-align: top;
}

.doc-tabla th {
  font-size: 11px;
  font-weight: 700;
  letter-spacing: .07em;
  text-transform: uppercase;
  color: var(--text-muted);
  white-space: nowrap;
}

.doc-tabla td { color: var(--text); }
.doc-tabla tr:last-child td { border-bottom: none; }

/* ── Nota destacada ───────────────────────────────────────────────────── */
.doc-nota {
  margin: 22px 0;
  padding: 14px 18px;
  border-left: 3px solid var(--accent);
  border-radius: 0 var(--radius) var(--radius) 0;
  background: var(--bg-card);
}

.doc-nota p { margin: 0; font-size: 14px; }
.doc-nota p + p { margin-top: 8px; }

/* ── Hub: buscador e índice ───────────────────────────────────────────── */
.doc-buscar-wrap { margin: 0 0 40px; max-width: 460px; }

.doc-buscar-wrap input {
  width: 100%;
  padding: 11px 15px;
  font-family: inherit;
  font-size: 15px;
  color: var(--text);
  background: var(--bg-card);
  border: 1px solid var(--border);
  border-radius: var(--radius);
  transition: border-color .15s;
}

.doc-buscar-wrap input::placeholder { color: var(--text-faint); }
.doc-buscar-wrap input:focus { outline: none; border-color: var(--accent); }

.doc-indice-grupo + .doc-indice-grupo { margin-top: 40px; }

.doc-indice-grupo h2 {
  margin: 0 0 16px;
  font-size: 12px;
  font-weight: 700;
  letter-spacing: .09em;
  text-transform: uppercase;
  color: var(--text-muted);
}

.doc-cards {
  display: grid;
  grid-template-columns: repeat(auto-fill, minmax(268px, 1fr));
  gap: 14px;
}

.doc-card {
  display: block;
  padding: 20px;
  border: 1px solid var(--border);
  border-radius: var(--radius-lg);
  background: var(--bg-card);
  text-decoration: none;
  transition: border-color .15s, transform .15s;
}

.doc-card:hover { border-color: var(--accent); transform: translateY(-2px); }

.doc-card h3 { margin: 0 0 6px; font-size: 16px; color: var(--text-heading); }
.doc-card p  { margin: 0 0 12px; font-size: 14px; line-height: 1.5; color: var(--text-muted); }

.doc-card-fecha {
  font-family: var(--font-mono);
  font-size: 11px;
  color: var(--text-muted);
}

.doc-vacio { font-size: 15px; color: var(--text-muted); }
.doc-vacio a { color: var(--accent); }

@media (prefers-reduced-motion: reduce) {
  .doc-card, .doc-nav-grupo a { transition: none; }
  .doc-card:hover { transform: none; }
}

/* ── Móvil ────────────────────────────────────────────────────────────── */
/* ⚠️ VA AL FINAL DEL ARCHIVO, no arriba junto a la estructura.
 *
 * Un `@media` NO le gana por ser media query: si la regla base tiene la misma
 * especificidad y está escrita después, gana la base. Este bloque estuvo
 * arriba y `position: static` no aplicaba nunca — la barra lateral quedaba
 * pegada arriba en el celular mientras se scrolleaba el contenido. Se vio
 * midiendo en un viewport de 375px, no leyendo el CSS.
 *
 * Al agregar una variante responsive nueva, agregala ACÁ ABAJO. */
@media (max-width: 900px) {
  .doc-layout {
    grid-template-columns: 1fr;
    gap: 28px;
    padding: 32px 20px 72px;
  }

  .doc-aside {
    position: static;
    max-height: none;
    padding-bottom: 20px;
    border-bottom: 1px solid var(--border);
  }

  /* En una sola columna el índice lateral es un preámbulo largo antes del
     contenido. Los grupos van en fila para que ocupe pocas líneas. */
  .doc-nav-grupo ul { display: flex; flex-wrap: wrap; gap: 4px; }
  .doc-nav-grupo a { margin-left: 0; border-left: 0; border-radius: 999px; padding: 6px 12px; }
  .doc-nav-grupo a.activo { border-left: 0; }

  .doc-cards { grid-template-columns: 1fr; }
}