/* ═══════════════════════════════════════════════════════════════════════
   LynxNodes Docs — style.css
   v2 · Rediseño visual completo

   Dirección de diseño
   ────────────────────
   Paleta:  se conserva el ámbar/oro de marca (#FFC100 → #FF8C00, presente
            en logo y CTA) como acento único — no es un default genérico,
            es la identidad ya existente del hoster — pero se profundiza el
            resto de la paleta (negros más "sala de servidores", jerarquía
            de grises más rica) para que el acento respire más.
   Tipo:    Outfit (display/cuerpo) + JetBrains Mono (código/datos), las
            mismas dos familias ya cargadas — la distinción se construye
            con escala, peso y tracking, no con fuentes nuevas.
   Firma:   los bloques de código se tratan como ventanas de terminal reales
            (semáforo de puntos, gutter de nº de línea, copiado línea a
            línea) — coherente con que esto es documentación de acceso SSH,
            configs de servidor y variables de entorno.
   Motion:  restringido a micro-interacciones (hover/focus) + un único
            elemento animado ambiental (el punto de estado "online" junto
            al logo). Nada de animaciones decorativas sueltas.
   ═══════════════════════════════════════════════════════════════════════ */

:root {
  /* ── Superficies (fondo casi sin tocar respecto al original) ── */
  --bg: #08090d;
  --bg-elevated: #0a0c11;
  --bg-card: #0e1018;
  --bg-card2: #13161f;
  --bg-inset: #0a0b10;

  /* ── Bordes ── */
  --border: rgba(255,255,255,0.07);
  --border-strong: rgba(255,255,255,0.14);
  --border-hover: rgba(255,193,0,0.45);

  /* ── Marca (sin tocar) ── */
  --gold: #FFC100;
  --gold-soft: #FFDA6A;
  --gold2: #FF8C00;
  --gold-dim: rgba(255,193,0,0.1);
  --gold-dim2: rgba(255,193,0,0.18);

  /* ── Semánticos ── */
  --cyan: #00e5ff;
  --purple: #7c3aed;
  --green: #22c55e;
  --red: #ef4444;
  --amber-warn: #f59e0b;

  /* ── Texto ── */
  --text: #f5f6f8;
  --muted: #6b7280;
  --muted2: #9aa1ad;
  --muted3: #545a67;

  /* ── Tipografía ── */
  --font: 'Outfit', sans-serif;
  --mono: 'JetBrains Mono', monospace;

  /* ── Forma ── */
  --radius-sm: 8px;
  --radius: 12px;
  --radius-lg: 20px;
  --radius-xl: 26px;

  /* ── Gradientes de marca ── */
  --grad-gold: linear-gradient(135deg, var(--gold), var(--gold2));
  --grad-hairline: linear-gradient(90deg, transparent, rgba(255,193,0,0.55) 50%, transparent);

  --shadow-sm: 0 2px 10px rgba(0,0,0,0.25);
  --shadow-md: 0 10px 30px rgba(0,0,0,0.35);
  --shadow-gold: 0 10px 26px rgba(255,193,0,0.22);
}

/* ═══ RESET / BASE ═══ */
*, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; }
html { scroll-behavior: smooth; width: 100%; }
body {
  font-family: var(--font);
  background: var(--bg);
  color: var(--text);
  line-height: 1.6;
  -webkit-font-smoothing: antialiased;
  text-rendering: optimizeLegibility;
  width: 100%;
  overflow-x: hidden;
}
a { text-decoration: none; color: inherit; }
::selection { background: rgba(255,193,0,0.28); color: #fff; }
::-webkit-scrollbar { width: 8px; height: 8px; }
::-webkit-scrollbar-track { background: transparent; }
::-webkit-scrollbar-thumb { background: #23262f; border-radius: 8px; border: 2px solid var(--bg); }
::-webkit-scrollbar-thumb:hover { background: #33384a; }

@media (prefers-reduced-motion: reduce) {
  html { scroll-behavior: auto; }
  *, *::before, *::after { animation-duration: 0.001ms !important; transition-duration: 0.001ms !important; }
}

/* ═══════════════════════════════════════════════════════════
   NAVBAR — rediseñada para que se note el cambio a simple vista:
   línea inferior degradada en vez de borde plano, logo con chip
   de fondo, indicador "online" pulsante, pill de búsqueda con
   icono animado, CTA con brillo direccional al hover.
   ═══════════════════════════════════════════════════════════ */
.docs-navbar {
  position: sticky;
  top: 0;
  z-index: 200;
  background: rgba(6,7,10,0.78);
  backdrop-filter: blur(20px) saturate(180%);
  -webkit-backdrop-filter: blur(20px) saturate(180%);
  border-bottom: 1px solid var(--border);
  height: 68px;
  display: flex;
  align-items: center;
  position: relative;
  transition: background 0.25s ease, border-color 0.25s ease;
}
.docs-navbar::after {
  content: '';
  position: absolute;
  left: 0; right: 0; bottom: -1px;
  height: 1px;
  background: var(--grad-hairline);
  opacity: 0.9;
}
.docs-navbar.is-scrolled {
  background: rgba(6,7,10,0.94);
  box-shadow: 0 10px 30px rgba(0,0,0,0.35);
}

.docs-navbar-inner {
  max-width: 1400px;
  width: 100%;
  margin: 0 auto;
  padding: 0 1.5rem;
  display: flex;
  align-items: center;
  justify-content: space-between;
  gap: 1.5rem;
}

.docs-logo { display: flex; align-items: center; gap: 0.7rem; flex-shrink: 0; }
.docs-logo img {
  width: 32px; height: 32px;
  object-fit: cover;
}
.docs-logo:hover img { filter: brightness(1.08); }
.docs-logo span { font-size: 1.06rem; font-weight: 800; color: var(--text); letter-spacing: -0.01em; }
.docs-logo .pipe { color: var(--muted3); font-weight: 300; margin: 0 0.2rem; }
.docs-logo .tag {
  font-size: 0.95rem;
  font-weight: 700;
  color: var(--muted2);
}

.docs-nav-links { display: flex; align-items: center; gap: 1.75rem; font-size: 0.9rem; font-weight: 600; color: var(--muted2); }
.docs-nav-links a { position: relative; transition: color 0.2s; padding-bottom: 4px; }
.docs-nav-links a::after {
  content: ''; position: absolute; left: 0; right: 100%; bottom: 0; height: 2px;
  background: var(--grad-gold); border-radius: 2px; transition: right 0.2s ease;
}
.docs-nav-links a:hover { color: var(--text); }
.docs-nav-links a:hover::after { right: 0; }
.docs-nav-links a.active { color: var(--gold); }
.docs-nav-links a.active::after { right: 0; }

.docs-search {
  font-family: var(--font);
  appearance: none; -webkit-appearance: none;
  display: flex; align-items: center; gap: 0.6rem;
  background: rgba(255,255,255,0.035);
  border: 1px solid var(--border);
  border-radius: 999px;
  padding: 0.55rem 0.5rem 0.55rem 0.9rem;
  color: var(--muted2);
  font-size: 0.85rem;
  width: 230px;
  cursor: pointer;
  transition: border-color 0.2s, background 0.2s, box-shadow 0.2s;
}
.docs-search i { color: var(--muted3); transition: color 0.2s, transform 0.2s; }
.docs-search:hover, .docs-search:focus-visible {
  border-color: var(--border-hover);
  background: rgba(255,193,0,0.05);
  box-shadow: 0 0 0 3px rgba(255,193,0,0.08);
}
.docs-search:hover i { color: var(--gold); transform: scale(1.08); }
.docs-search kbd {
  margin-left: auto;
  font-family: var(--mono); font-size: 0.68rem;
  color: var(--muted2);
  background: rgba(255,255,255,0.07);
  border: 1px solid var(--border-strong);
  border-radius: 5px;
  padding: 0.15rem 0.4rem;
}

.docs-cta {
  position: relative;
  display: inline-flex; align-items: center; gap: 0.45rem;
  background: var(--grad-gold);
  color: #0a0800; font-weight: 800; font-size: 0.85rem;
  padding: 0.55rem 1.15rem; border-radius: 999px;
  transition: transform 0.2s ease, box-shadow 0.2s ease, filter 0.2s ease;
  flex-shrink: 0;
  box-shadow: 0 1px 0 rgba(255,255,255,0.35) inset, 0 6px 16px rgba(255,140,0,0.16);
}
.docs-cta i { transition: transform 0.25s ease; }
.docs-cta:hover { transform: translateY(-1px); box-shadow: 0 1px 0 rgba(255,255,255,0.35) inset, var(--shadow-gold); filter: brightness(1.04); }
.docs-cta:hover i { transform: translateX(2px) rotate(8deg); }
.docs-cta:active { transform: translateY(0); }

.docs-hamburger {
  display: none;
  width: 40px; height: 40px;
  align-items: center; justify-content: center;
  border: 1px solid var(--border); border-radius: var(--radius-sm);
  background: rgba(255,255,255,0.03); color: var(--muted2); cursor: pointer;
  flex-shrink: 0;
  transition: border-color 0.2s, color 0.2s;
}
.docs-hamburger:hover { border-color: var(--border-hover); color: var(--gold); }

@media(max-width: 900px) {
  .docs-nav-links, .docs-search { display: none; }
  .docs-hamburger { display: flex; }
}
@media(max-width: 520px) {
  .docs-cta { padding: 0.5rem 0.65rem; font-size: 0.78rem; gap: 0.3rem; }
  .docs-logo span { font-size: 0.95rem; }
  .docs-logo .tag { display: none; }
  .docs-navbar-inner { padding: 0 0.85rem; gap: 0.6rem; }
}

/* ═══ LAYOUT ═══ */
.docs-shell { max-width: 1400px; margin: 0 auto; display: flex; align-items: flex-start; }

/* Sidebar */
.docs-sidebar {
  width: 280px;
  flex-shrink: 0;
  position: sticky;
  top: 68px;
  height: calc(100vh - 68px);
  overflow-y: auto;
  padding: 1.85rem 1.25rem 3rem;
  border-right: 1px solid var(--border);
}
.docs-sidebar::-webkit-scrollbar { width: 5px; }

.sb-group { margin-bottom: 1.75rem; }
.sb-group-title {
  display: flex; align-items: center; gap: 0.5rem;
  font-size: 0.72rem; font-weight: 800; text-transform: uppercase; letter-spacing: 0.07em;
  color: var(--muted3); margin-bottom: 0.7rem; padding: 0 0.6rem;
}
.sb-group-title i { font-size: 0.72rem; color: var(--gold); opacity: 0.75; width: 13px; text-align: center; }
.sb-links { display: flex; flex-direction: column; gap: 0.05rem; position: relative; }
.sb-links a {
  position: relative;
  display: block;
  font-size: 0.88rem; font-weight: 500; color: var(--muted2);
  padding: 0.5rem 0.7rem 0.5rem 0.85rem;
  border-radius: 8px;
  transition: color 0.15s, background 0.15s;
}
.sb-links a::before {
  content: '';
  position: absolute; left: 0; top: 12%; bottom: 12%;
  width: 2px; border-radius: 2px;
  background: transparent;
  transition: background 0.15s;
}
.sb-links a:hover { color: var(--text); background: rgba(255,255,255,0.035); }
.sb-links a.active {
  color: var(--gold); font-weight: 700;
  background: linear-gradient(90deg, rgba(255,193,0,0.1), rgba(255,193,0,0.02));
}
.sb-links a.active::before { background: var(--grad-gold); }

/* Contenido principal */
.docs-content {
  flex: 1;
  min-width: 0;
  padding: 2.75rem 3rem 5rem;
  max-width: 880px;
}
@media(max-width: 1100px) { .docs-content { padding: 2rem 2rem 4rem; } }

.docs-breadcrumb { display: flex; align-items: center; gap: 0.5rem; font-size: 0.8rem; color: var(--muted); margin-bottom: 1.25rem; font-weight: 500; }
.docs-breadcrumb a { transition: color 0.15s; }
.docs-breadcrumb a:hover { color: var(--gold); }
.docs-breadcrumb i { font-size: 0.6rem; color: var(--muted3); }

.docs-content h1 {
  font-size: clamp(1.9rem, 3.6vw, 2.55rem);
  font-weight: 900;
  letter-spacing: -0.025em;
  color: var(--text);
  margin-bottom: 0.7rem;
  background: linear-gradient(180deg, #ffffff, #d8dae0 130%);
  -webkit-background-clip: text;
  background-clip: text;
  -webkit-text-fill-color: transparent;
}
.docs-lede { font-size: 1.08rem; color: var(--muted2); margin-bottom: 2.5rem; line-height: 1.7; max-width: 62ch; }

.docs-content h2 {
  font-size: 1.4rem; font-weight: 800; color: var(--text);
  margin: 3rem 0 1.1rem;
  padding-top: 0.25rem;
  scroll-margin-top: 90px;
  display: flex;
  align-items: center;
  gap: 0.6rem;
}
.docs-content h2::before {
  content: '';
  width: 5px; height: 1.05em;
  border-radius: 3px;
  background: var(--grad-gold);
  flex-shrink: 0;
}
.docs-content h2:first-of-type { margin-top: 0; }
.docs-content h3 { font-size: 1.06rem; font-weight: 700; color: var(--text); margin: 1.6rem 0 0.75rem; scroll-margin-top: 90px; }
.docs-content p { font-size: 0.97rem; color: var(--muted2); line-height: 1.8; margin-bottom: 1rem; }
.docs-content p:last-child { margin-bottom: 0; }
.docs-content strong { color: var(--text); font-weight: 700; }
.docs-content a:not(.docs-cta):not(.sb-links a) {
  color: var(--gold-soft);
  border-bottom: 1px solid rgba(255,193,0,0.32);
  transition: border-color 0.2s, color 0.2s;
}
.docs-content a:not(.docs-cta):not(.sb-links a):hover { border-color: var(--gold); color: var(--gold); }

.docs-list { display: flex; flex-direction: column; gap: 0.65rem; color: var(--muted2); font-size: 0.95rem; margin-bottom: 1.3rem; list-style: none; }
.docs-list li { position: relative; padding-left: 1.3rem; line-height: 1.75; }
.docs-list li::before { content: '•'; color: var(--gold); font-weight: 700; position: absolute; left: 0; top: 0; }
.docs-list.numbered { counter-reset: step; }
.docs-list.numbered li { counter-increment: step; padding-left: 1.8rem; }
.docs-list.numbered li::before {
  content: counter(step); color: var(--gold); font-weight: 800; font-size: 0.76rem;
  width: 19px; height: 19px; border-radius: 50%;
  background: var(--gold-dim); border: 1px solid rgba(255,193,0,0.28);
  display: flex; align-items: center; justify-content: center; top: 0.05rem;
}

/* ═══ CALLOUTS ═══ */
.callout {
  position: relative;
  background: var(--bg-card2);
  border: 1px solid var(--border);
  border-left: 3px solid var(--gold);
  border-radius: var(--radius);
  padding: 1.15rem 1.4rem;
  margin: 1.6rem 0;
  font-size: 0.93rem;
  color: var(--muted2);
  overflow: hidden;
}
.callout::before {
  content: '';
  position: absolute; inset: 0;
  background: linear-gradient(120deg, rgba(255,193,0,0.06), transparent 45%);
  pointer-events: none;
}
/* chip circular para el icono, en vez de un icono suelto en la línea de texto */
.callout-title { display: flex; align-items: center; gap: 0.55rem; font-weight: 700; color: var(--text); margin-bottom: 0.45rem; font-size: 0.91rem; }
.callout-title i {
  flex-shrink: 0;
  width: 26px; height: 26px;
  border-radius: 8px;
  display: flex; align-items: center; justify-content: center;
  background: var(--gold-dim);
  border: 1px solid rgba(255,193,0,0.25);
  color: var(--gold);
  font-size: 0.78rem;
}
.callout.tip { border-left-color: var(--cyan); }
.callout.tip .callout-title { color: var(--cyan); }
.callout.tip .callout-title i { background: rgba(0,229,255,0.1); border-color: rgba(0,229,255,0.28); color: var(--cyan); }
.callout.tip::before { background: linear-gradient(120deg, rgba(0,229,255,0.06), transparent 45%); }
.callout.warn { border-left-color: var(--amber-warn); }
.callout.warn .callout-title { color: var(--amber-warn); }
.callout.warn .callout-title i { background: rgba(245,158,11,0.1); border-color: rgba(245,158,11,0.28); color: var(--amber-warn); }
.callout.danger { border-left-color: var(--red); }
.callout.danger .callout-title { color: var(--red); }
.callout.danger .callout-title i { background: rgba(239,68,68,0.1); border-color: rgba(239,68,68,0.28); color: var(--red); }
.callout.success { border-left-color: var(--green); }
.callout.success .callout-title { color: var(--green); }
.callout.success .callout-title i { background: rgba(34,197,94,0.1); border-color: rgba(34,197,94,0.28); color: var(--green); }

/* ═══════════════════════════════════════════════════════════
   BLOQUES DE CÓDIGO — inspirados en documentación técnica clásica
   (Pterodactyl, VuePress): cabecera limpia y minimal, SIN chrome
   decorativo de ventana. Etiqueta a la izquierda, lenguaje +
   copiar a la derecha. Gutter de nº de línea + copiado por línea
   individual en bloques de configuración multi-línea.
   ═══════════════════════════════════════════════════════════ */
.code-block {
  background: var(--bg-inset);
  border: 1px solid var(--border);
  border-radius: var(--radius);
  margin: 1.4rem 0;
  overflow: hidden;
  box-shadow: var(--shadow-sm);
}
.code-block-head {
  display: flex; align-items: center; gap: 0.6rem;
  padding: 0.55rem 0.6rem 0.55rem 0.95rem;
  border-bottom: 1px solid var(--border);
  font-family: var(--mono); font-size: 0.74rem; color: var(--muted);
  background: var(--bg-elevated);
}
.code-block-head span:first-of-type { color: var(--muted2); font-weight: 600; letter-spacing: 0.01em; }
.code-block-head span:nth-of-type(2) {
  margin-left: auto;
  text-transform: uppercase;
  letter-spacing: 0.07em;
  font-size: 0.64rem;
  font-weight: 700;
  color: var(--gold);
  background: var(--gold-dim);
  border: 1px solid rgba(255,193,0,0.22);
  padding: 0.15rem 0.5rem;
  border-radius: 5px;
}
.code-block pre { padding: 1.05rem 1.1rem; overflow-x: auto; font-family: var(--mono); font-size: 0.83rem; color: #d7dbe3; line-height: 1.7; }
.code-block code { font-family: var(--mono); }
/* resaltado ligero por tipo de token — los comentarios siempre en verde */
.tok-comment { color: var(--green); opacity: 0.8; }
.tok-cmd { color: var(--cyan); font-weight: 600; }
.tok-key { color: var(--gold-soft); }
.tok-string { color: #5eead4; }
.tok-flag { color: var(--purple); opacity: 0.95; }
.inline-code {
  font-family: var(--mono); font-size: 0.85em;
  background: rgba(255,255,255,0.06);
  border: 1px solid var(--border);
  border-radius: 5px;
  padding: 0.16rem 0.42rem;
  color: var(--gold-soft);
  cursor: pointer;
  transition: border-color 0.15s, background 0.15s;
}
.inline-code:hover { border-color: var(--border-hover); background: rgba(255,193,0,0.08); }

/* líneas individuales dentro de un bloque multi-línea (inyectadas por JS) */
.code-lines { counter-reset: codeline; }
.code-line-row {
  counter-increment: codeline;
  display: flex;
  align-items: flex-start;
  gap: 0.75rem;
  padding: 0.06rem 0;
  border-radius: 5px;
  transition: background 0.12s;
}
.code-line-row:hover { background: rgba(255,255,255,0.035); }
.code-line-row::before {
  content: counter(codeline);
  flex-shrink: 0;
  width: 1.6em;
  text-align: right;
  color: var(--muted3);
  font-size: 0.76rem;
  user-select: none;
  padding-top: 0.05em;
}
/* las líneas en blanco también llevan su número, igual que en cualquier editor de código */
.code-line-txt { flex: 1; min-width: 0; white-space: pre; overflow-x: auto; }
.code-line-copy {
  flex-shrink: 0;
  width: 22px; height: 22px;
  border-radius: 5px;
  border: 1px solid transparent;
  background: transparent;
  color: var(--muted3);
  display: flex; align-items: center; justify-content: center;
  cursor: pointer;
  opacity: 0;
  transition: opacity 0.12s, color 0.12s, border-color 0.12s, background 0.12s;
  user-select: none;
  font-size: 0.68rem;
}
.code-line-row:hover .code-line-copy { opacity: 1; }
.code-line-copy:hover { color: var(--gold); border-color: var(--border-hover); background: rgba(255,193,0,0.08); }
.code-line-copy:focus-visible { opacity: 1; }
.code-line-copy.copied { color: var(--green); opacity: 1; }

/* ═══ CARD GRID ═══ */
.docs-card-grid { display: grid; grid-template-columns: 1fr 1fr; gap: 1rem; margin: 1.6rem 0; }
@media(max-width: 640px) { .docs-card-grid { grid-template-columns: 1fr; } }
.docs-card {
  position: relative;
  display: block;
  background: var(--bg-card2);
  border: 1px solid var(--border);
  border-radius: var(--radius);
  padding: 1.3rem;
  overflow: hidden;
  transition: border-color 0.2s, transform 0.2s, box-shadow 0.2s;
}
.docs-card::before {
  content: '';
  position: absolute; inset: 0;
  opacity: 0;
  background: radial-gradient(120px 90px at 15% 0%, rgba(255,193,0,0.16), transparent 70%);
  transition: opacity 0.25s;
}
.docs-card:hover { border-color: var(--border-hover); transform: translateY(-3px); box-shadow: var(--shadow-md); }
.docs-card:hover::before { opacity: 1; }
.docs-card i.card-icon {
  font-size: 1.05rem; color: var(--gold); margin-bottom: 0.7rem;
  display: flex; align-items: center; justify-content: center;
  width: 34px; height: 34px; border-radius: 9px;
  background: var(--gold-dim); border: 1px solid rgba(255,193,0,0.22);
  position: relative;
  transition: transform 0.25s ease, border-color 0.25s ease;
}
.docs-card:hover i.card-icon { transform: rotate(-6deg) scale(1.06); border-color: rgba(255,193,0,0.4); }
/* variedad de color por tarjeta, para que la rejilla no sea el mismo icono dorado repetido */
.docs-card:nth-of-type(4n+2) i.card-icon { color: var(--cyan); background: rgba(0,229,255,0.1); border-color: rgba(0,229,255,0.24); }
.docs-card:nth-of-type(4n+2)::before { background: radial-gradient(120px 90px at 15% 0%, rgba(0,229,255,0.14), transparent 70%); }
.docs-card:nth-of-type(4n+2):hover i.card-icon { border-color: rgba(0,229,255,0.45); }
.docs-card:nth-of-type(4n+3) i.card-icon { color: var(--purple); background: rgba(124,58,237,0.12); border-color: rgba(124,58,237,0.28); }
.docs-card:nth-of-type(4n+3)::before { background: radial-gradient(120px 90px at 15% 0%, rgba(124,58,237,0.16), transparent 70%); }
.docs-card:nth-of-type(4n+3):hover i.card-icon { border-color: rgba(124,58,237,0.5); }
.docs-card:nth-of-type(4n+4) i.card-icon { color: var(--green); background: rgba(34,197,94,0.1); border-color: rgba(34,197,94,0.24); }
.docs-card:nth-of-type(4n+4)::before { background: radial-gradient(120px 90px at 15% 0%, rgba(34,197,94,0.14), transparent 70%); }
.docs-card:nth-of-type(4n+4):hover i.card-icon { border-color: rgba(34,197,94,0.45); }
.docs-card h4 { font-size: 0.96rem; font-weight: 700; color: var(--text); margin-bottom: 0.4rem; position: relative; display: flex; align-items: center; justify-content: space-between; gap: 0.5rem; }
/* pequeña flecha que aparece indicando que la tarjeta es un enlace */
.docs-card h4::after {
  content: '\f061'; /* fa-arrow-right */
  font-family: 'Font Awesome 6 Free'; font-weight: 900;
  font-size: 0.72rem; color: var(--muted3);
  opacity: 0; transform: translateX(-4px);
  transition: opacity 0.2s ease, transform 0.2s ease, color 0.2s ease;
}
.docs-card:hover h4::after { opacity: 1; transform: translateX(0); color: var(--gold); }
.docs-card p { font-size: 0.84rem; color: var(--muted); margin-bottom: 0; position: relative; }

/* ═══════════════════════════════════════════════════════════
   STEPS — dos variantes para que no sea siempre el mismo patrón:
   por defecto un estilo compacto (número pequeño + línea fina),
   y ".step-primary" — reservado para el flujo de compra
   ("Contratar el servidor") — con el círculo grande y la línea
   conectora, para darle más peso justo donde más importa.
   ═══════════════════════════════════════════════════════════ */
.step {
  display: flex; gap: 0.85rem;
  padding: 0.85rem 0;
  border-top: 1px solid var(--border);
}
.step:first-child { padding-top: 0; border-top: none; }
.step:last-child { padding-bottom: 0; }
.step-num {
  flex-shrink: 0;
  width: 22px; height: 22px;
  border-radius: 6px;
  background: var(--gold-dim);
  border: 1px solid rgba(255,193,0,0.25);
  color: var(--gold); font-weight: 800; font-size: 0.74rem;
  display: flex; align-items: center; justify-content: center;
  margin-top: 0.1rem;
}
.step-body { flex: 1; min-width: 0; padding-top: 0.05rem; }
.step-body h3 { margin: 0 0 0.35rem; font-size: 0.98rem; }
.step-body p { margin-bottom: 0.5rem; }
.step-body .code-block { margin: 0.75rem 0 0.15rem; }

/* variante destacada — solo para el flujo de compra */
.step.step-primary {
  position: relative;
  gap: 1.15rem;
  padding: 0 0 1.75rem;
  border-top: none;
}
.step.step-primary::before {
  content: '';
  position: absolute;
  left: 16px; top: 34px; bottom: 0;
  width: 2px;
  background: linear-gradient(180deg, rgba(255,193,0,0.35), rgba(255,193,0,0.03));
}
.step.step-primary:last-child { padding-bottom: 0; }
.step.step-primary:last-child::before { display: none; }
.step.step-primary .step-num {
  position: relative;
  z-index: 1;
  width: 33px; height: 33px; border-radius: 50%;
  background: var(--bg-card2);
  border: 1px solid rgba(255,193,0,0.35);
  font-size: 0.9rem;
  box-shadow: 0 0 0 4px var(--bg), 0 0 0 5px var(--border);
  margin-top: 0;
}
.step.step-primary .step-body { padding-top: 0.15rem; }
.step.step-primary .step-body h3 { margin: 0 0 0.45rem; font-size: 1.06rem; }
.step-body .code-block { margin: 0.85rem 0 0.25rem; }

/* ═══ TABLA ═══ */
.docs-table-wrap { overflow-x: auto; margin: 1.4rem 0; border-radius: var(--radius); border: 1px solid var(--border); box-shadow: var(--shadow-sm); }
.docs-table { width: 100%; border-collapse: collapse; font-size: 0.88rem; }
.docs-table th {
  position: relative;
  background: var(--bg-card2); color: var(--gold); font-weight: 700; text-align: left;
  padding: 0.75rem 1.05rem; border-bottom: 1px solid var(--border);
  text-transform: uppercase; font-size: 0.76rem; letter-spacing: 0.04em;
}
.docs-table td { padding: 0.75rem 1.05rem; color: var(--muted2); border-bottom: 1px solid var(--border); }
.docs-table tr:last-child td { border-bottom: none; }
.docs-table tbody tr:nth-child(even) td { background: rgba(255,255,255,0.014); }
.docs-table tr:hover td { background: var(--gold-dim); color: var(--text); }
.docs-table td:first-child, .docs-table th:first-child { font-weight: 600; color: var(--text); }
.docs-table code, .docs-table .inline-code { font-size: 0.82em; }

/* ═══ PAGER ═══ */
.docs-pager { display: flex; justify-content: space-between; gap: 1rem; margin-top: 3.25rem; padding-top: 1.85rem; border-top: 1px solid var(--border); }
.pager-link {
  flex: 1; max-width: 48%;
  border: 1px solid var(--border); border-radius: var(--radius);
  padding: 0.95rem 1.15rem;
  transition: border-color 0.2s, background 0.2s, transform 0.2s;
}
.pager-link:hover { border-color: var(--border-hover); background: rgba(255,193,0,0.045); transform: translateY(-2px); }
.pager-link.next { text-align: right; margin-left: auto; }
.pager-label { font-size: 0.72rem; color: var(--muted); text-transform: uppercase; letter-spacing: 0.05em; display: flex; align-items: center; gap: 0.35rem; font-weight: 700; }
.pager-label i { transition: transform 0.2s ease; }
.pager-link:hover .pager-label i { color: var(--gold); }
.pager-link:not(.next):hover .pager-label i { transform: translateX(-3px); }
.pager-link.next:hover .pager-label i { transform: translateX(3px); }
.pager-link.next .pager-label { justify-content: flex-end; }
.pager-title { font-size: 0.94rem; font-weight: 700; color: var(--text); margin-top: 0.3rem; }

/* ═══ SIDEBAR MÓVIL ═══ */
.docs-sidebar-overlay { position: fixed; inset: 0; background: rgba(0,0,0,0.75); backdrop-filter: blur(4px); z-index: 250; opacity: 0; visibility: hidden; transition: all 0.25s; }
.docs-sidebar-overlay.open { opacity: 1; visibility: visible; }

@media(max-width: 1100px) {
  .docs-sidebar {
    position: fixed; top: 0; left: 0; height: 100vh;
    width: 280px; max-width: 82vw;
    background: var(--bg);
    z-index: 260;
    transform: translateX(-100%);
    transition: transform 0.3s cubic-bezier(0.4,0,0.2,1);
    padding-top: 1.25rem;
  }
  .docs-sidebar.open { transform: translateX(0); }
  .docs-content { max-width: 100%; }
}

/* ═══ FAQ ═══ */
.faq-q {
  font-size: 1.02rem; font-weight: 700; color: var(--text);
  margin: 2.1rem 0 0.75rem;
  display: flex; align-items: center; gap: 0.75rem;
}
.faq-q:first-of-type { margin-top: 0; }
/* marca de contorno, distinta del chip relleno de los callouts/tarjetas */
.faq-q i {
  flex-shrink: 0;
  width: 26px; height: 26px;
  border-radius: 50%;
  display: flex; align-items: center; justify-content: center;
  background: transparent;
  border: 1.5px solid var(--gold);
  color: var(--gold); font-size: 0.68rem;
}
/* separa visualmente cada pregunta de la siguiente sin tocar el HTML */
.faq-q + p { padding-left: 2.15rem; }
.faq-q + p + .faq-q { border-top: 1px solid var(--border); padding-top: 1.6rem; margin-top: 1.6rem; }

/* ═══════════════════════════════════════════════════════════
   MEJORAS AÑADIDAS EN LA REMODELACIÓN
   (buscador funcional, copiar código, progreso de lectura, etc.)
   ═══════════════════════════════════════════════════════════ */

/* Barra de progreso de lectura */
.reading-progress {
  position: fixed;
  top: 0; left: 0;
  height: 2.5px;
  width: 0%;
  background: var(--grad-gold);
  z-index: 300;
  transition: width 0.1s ease-out;
  box-shadow: 0 0 8px rgba(255,193,0,0.5);
}

/* ─── MODAL DE BÚSQUEDA ─── */
.search-overlay {
  position: fixed;
  inset: 0;
  background: rgba(4,5,8,0.82);
  backdrop-filter: blur(10px);
  -webkit-backdrop-filter: blur(10px);
  z-index: 500;
  display: flex;
  align-items: flex-start;
  justify-content: center;
  padding: 10vh 1.25rem 2rem;
  opacity: 0;
  visibility: hidden;
  transition: opacity 0.18s ease, visibility 0.18s ease;
}
.search-overlay.open { opacity: 1; visibility: visible; }

.search-modal {
  position: relative;
  width: 100%;
  max-width: 620px;
  background: var(--bg-card);
  border: 1px solid var(--border-strong);
  border-radius: var(--radius-lg);
  box-shadow: 0 30px 70px rgba(0,0,0,0.55), 0 0 0 1px rgba(255,255,255,0.03);
  overflow: hidden;
  transform: translateY(-12px) scale(0.98);
  transition: transform 0.18s ease;
  max-height: 72vh;
  display: flex;
  flex-direction: column;
}
.search-overlay.open .search-modal { transform: translateY(0) scale(1); }

.search-modal-head {
  display: flex;
  align-items: center;
  gap: 0.7rem;
  padding: 0.85rem 1.05rem;
  border-bottom: 1px solid var(--border);
  flex-shrink: 0;
}
.search-modal-head-icon {
  flex-shrink: 0;
  width: 26px; height: 26px;
  border-radius: 7px;
  display: flex; align-items: center; justify-content: center;
  background: var(--gold-dim);
  border: 1px solid rgba(255,193,0,0.25);
}
.search-modal-head-icon i { color: var(--gold); font-size: 0.78rem; }
.search-modal-input {
  flex: 1;
  min-width: 0;
  background: transparent;
  border: none;
  outline: none;
  color: var(--text);
  font-family: var(--font);
  font-size: 1rem;
  font-weight: 500;
}
.search-modal-input::placeholder { color: var(--muted); }
.search-modal-esc {
  font-family: var(--mono);
  font-size: 0.7rem;
  color: var(--muted2);
  background: rgba(255,255,255,0.06);
  border: 1px solid var(--border-strong);
  border-radius: 5px;
  padding: 0.18rem 0.45rem;
  flex-shrink: 0;
}

.search-modal-body {
  overflow-y: auto;
  padding: 0.5rem;
}
.search-modal-body::-webkit-scrollbar { width: 6px; }
.search-modal-body::-webkit-scrollbar-thumb { background: #23262f; border-radius: 4px; }

.search-group-label {
  display: flex; align-items: center; gap: 0.45rem;
  font-size: 0.68rem;
  font-weight: 800;
  text-transform: uppercase;
  letter-spacing: 0.07em;
  color: var(--muted3);
  padding: 0.85rem 0.65rem 0.4rem;
}
.search-group-label:not(:first-child) { margin-top: 0.15rem; border-top: 1px solid var(--border); }
.search-group-label::before {
  content: '';
  width: 5px; height: 5px;
  border-radius: 50%;
  background: var(--gold);
  opacity: 0.7;
}

.search-result {
  position: relative;
  display: flex;
  align-items: flex-start;
  gap: 0.7rem;
  padding: 0.6rem 0.7rem 0.6rem 0.85rem;
  margin: 0 0 0.1rem;
  border-radius: 9px;
  cursor: pointer;
  transition: background 0.12s ease;
}
.search-result::before {
  content: '';
  position: absolute;
  left: 0; top: 14%; bottom: 14%;
  width: 2.5px;
  border-radius: 2px;
  background: transparent;
  transition: background 0.12s ease;
}
.search-result:hover,
.search-result.active {
  background: var(--gold-dim);
}
.search-result:hover::before,
.search-result.active::before {
  background: var(--grad-gold);
}
.search-result i {
  flex-shrink: 0;
  width: 30px; height: 30px;
  border-radius: 8px;
  display: flex; align-items: center; justify-content: center;
  background: rgba(255,255,255,0.045);
  border: 1px solid var(--border);
  color: var(--gold);
  font-size: 0.82rem;
  margin-top: 0.05rem;
  transition: background 0.12s ease, border-color 0.12s ease;
}
.search-result > div { min-width: 0; flex: 1; }
.search-result:hover i,
.search-result.active i {
  background: var(--gold-dim);
  border-color: rgba(255,193,0,0.3);
}
.search-result-title { font-size: 0.92rem; font-weight: 700; color: var(--text); line-height: 1.3; }
.search-result-title mark {
  background: rgba(255,193,0,0.35);
  color: var(--text);
  border-radius: 3px;
  padding: 0 1px;
}
.search-result-desc {
  font-size: 0.8rem;
  color: var(--muted2);
  margin-top: 0.2rem;
  line-height: 1.45;
  display: -webkit-box;
  -webkit-line-clamp: 2;
  -webkit-box-orient: vertical;
  overflow: hidden;
}
/* resultados que apuntan a una sección concreta dentro de una página */
.search-result-page {
  display: inline-flex;
  align-items: center;
  gap: 0.3rem;
  font-size: 0.68rem;
  color: var(--muted3);
  margin-top: 0.4rem;
  font-family: var(--mono);
  background: rgba(255,255,255,0.04);
  border: 1px solid var(--border);
  border-radius: 5px;
  padding: 0.1rem 0.4rem;
}
.search-result-section i { color: var(--muted2); background: rgba(255,255,255,0.03); }
.search-result-section:hover i,
.search-result-section.active i { color: var(--gold); }

.search-empty {
  padding: 2.75rem 1rem;
  text-align: center;
  color: var(--muted2);
  font-size: 0.9rem;
}
.search-empty-icon {
  width: 44px; height: 44px;
  margin: 0 auto 0.9rem;
  border-radius: 11px;
  display: flex; align-items: center; justify-content: center;
  background: rgba(255,255,255,0.04);
  border: 1px solid var(--border);
}
.search-empty-icon i { color: var(--muted3); font-size: 1.1rem; }

.search-modal-foot {
  display: flex;
  align-items: center;
  gap: 1.2rem;
  padding: 0.6rem 1.05rem;
  border-top: 1px solid var(--border);
  font-size: 0.72rem;
  color: var(--muted);
  background: var(--bg-elevated);
  flex-shrink: 0;
}
.search-modal-foot span { display: flex; align-items: center; gap: 0.35rem; }
.search-modal-foot kbd {
  font-family: var(--mono);
  background: rgba(255,255,255,0.07);
  border: 1px solid var(--border-strong);
  border-radius: 4px;
  padding: 0.08rem 0.38rem;
  font-size: 0.68rem;
  color: var(--muted2);
}

/* ─── BOTÓN COPIAR CÓDIGO (bloque completo) ─── */
.code-copy-btn {
  display: inline-flex;
  align-items: center;
  gap: 0.35rem;
  background: rgba(255,255,255,0.05);
  border: 1px solid var(--border);
  color: var(--muted2);
  font-family: var(--font);
  font-size: 0.72rem;
  font-weight: 600;
  padding: 0.28rem 0.6rem;
  border-radius: 6px;
  cursor: pointer;
  transition: all 0.15s;
}
.code-copy-btn:hover { color: var(--text); border-color: var(--border-hover); background: rgba(255,193,0,0.09); }
.code-copy-btn:active { transform: scale(0.96); }
.code-copy-btn.copied { color: var(--green); border-color: rgba(34,197,94,0.4); background: rgba(34,197,94,0.09); }
.code-copy-btn i { font-size: 0.72rem; }

/* ─── TOAST DE NOTIFICACIÓN ─── */
.toast-stack {
  position: fixed;
  bottom: 1.5rem;
  left: 50%;
  transform: translateX(-50%);
  z-index: 600;
  display: flex;
  flex-direction: column;
  gap: 0.5rem;
  align-items: center;
}
.toast {
  display: flex;
  align-items: center;
  gap: 0.5rem;
  background: var(--bg-card2);
  border: 1px solid var(--border-strong);
  border-left: 3px solid var(--green);
  color: var(--text);
  font-size: 0.85rem;
  font-weight: 600;
  padding: 0.6rem 1rem;
  border-radius: 9px;
  box-shadow: 0 10px 30px rgba(0,0,0,0.4);
  opacity: 0;
  transform: translateY(8px);
  transition: all 0.25s ease;
}
.toast.show { opacity: 1; transform: translateY(0); }
.toast i { color: var(--green); }

/* ─── BOTÓN VOLVER ARRIBA ─── */
.back-to-top {
  position: fixed;
  bottom: 1.75rem;
  right: 1.75rem;
  width: 44px;
  height: 44px;
  border-radius: 50%;
  background: var(--bg-card2);
  border: 1px solid var(--border-strong);
  color: var(--muted2);
  display: flex;
  align-items: center;
  justify-content: center;
  cursor: pointer;
  z-index: 150;
  opacity: 0;
  visibility: hidden;
  transform: translateY(8px);
  transition: all 0.2s;
  box-shadow: var(--shadow-md);
}
.back-to-top.show { opacity: 1; visibility: visible; transform: translateY(0); }
.back-to-top:hover { color: var(--gold); border-color: var(--border-hover); }

/* ─── FOCO ACCESIBLE ─── */
a:focus-visible,
button:focus-visible,
.docs-search:focus-visible,
input:focus-visible {
  outline: 2px solid var(--gold);
  outline-offset: 2px;
  border-radius: 4px;
}

/* Resalte temporal al llegar a un encabezado via enlace directo (#ancla):
   parpadea de verdad (3 ciclos) durante ~2s, luego se queda limpio,
   para que quede claro dónde ha aterrizado el usuario sin quedarse iluminado. */
:target { scroll-margin-top: 90px; }
h2:target, h3:target { animation: target-flash 2s ease-in-out 1; border-radius: 6px; }
@keyframes target-flash {
  0%, 100% { background: transparent; }
  10%, 37%, 64% { background: rgba(255,193,0,0.24); }
  23%, 50%, 78% { background: transparent; }
}

@media (max-width: 640px) {
  .search-overlay { padding: 4vh 0.75rem 2rem; }
  .back-to-top { right: 1rem; bottom: 1rem; }
}

/* ═══════════════════════════════════════════════════════════
   CAPTURAS DEL PANEL
   - .docs-screenshot-slot: placeholder visible mientras no hay
     imagen real todavía (ver CAPTURAS-PENDIENTES.md).
   - .docs-screenshot: estilo ya listo para cuando la imagen real
     sustituya al placeholder (ver CAMBIOS.md para el marcado).
   ═══════════════════════════════════════════════════════════ */
.docs-screenshot-slot {
  display: flex;
  align-items: center;
  gap: 0.9rem;
  background: var(--bg-card2);
  border: 1.5px dashed var(--border-strong);
  border-radius: var(--radius);
  padding: 1.1rem 1.3rem;
  margin: 1.6rem 0;
  color: var(--muted2);
}
.docs-screenshot-slot-icon {
  flex-shrink: 0;
  width: 40px; height: 40px;
  border-radius: 9px;
  display: flex; align-items: center; justify-content: center;
  background: var(--gold-dim);
  border: 1px solid rgba(255,193,0,0.25);
  color: var(--gold);
  font-size: 1rem;
}
.docs-screenshot-slot-text { font-size: 0.86rem; line-height: 1.55; }
.docs-screenshot-slot-text strong { color: var(--text); display: block; margin-bottom: 0.15rem; }
.docs-screenshot-slot-text span { display: block; font-family: var(--mono); font-size: 0.72rem; color: var(--muted3); margin-top: 0.3rem; }

.docs-screenshot {
  display: block;
  width: 100%;
  height: auto;
  border-radius: var(--radius);
  border: 1px solid var(--border);
  box-shadow: var(--shadow-md);
  margin: 1.6rem 0;
  transition: border-color 0.2s ease, transform 0.2s ease;
}
.docs-screenshot.is-zoomable { cursor: zoom-in; }
.docs-screenshot.is-zoomable:hover { border-color: var(--border-hover); transform: translateY(-2px); }
.docs-screenshot-caption {
  display: block;
  text-align: center;
  font-size: 0.8rem;
  color: var(--muted);
  margin-top: -1.1rem;
  margin-bottom: 1.6rem;
}

/* ─── LIGHTBOX (ampliar capturas de pantalla) ─── */
.lightbox-overlay {
  position: fixed;
  inset: 0;
  background: rgba(4,5,8,0.92);
  backdrop-filter: blur(6px);
  -webkit-backdrop-filter: blur(6px);
  z-index: 700;
  display: flex;
  align-items: center;
  justify-content: center;
  padding: 4vh 4vw;
  opacity: 0;
  visibility: hidden;
  transition: opacity 0.2s ease, visibility 0.2s ease;
}
.lightbox-overlay.open { opacity: 1; visibility: visible; }
.lightbox-img {
  max-width: 100%;
  max-height: 92vh;
  border-radius: var(--radius);
  border: 1px solid var(--border-strong);
  box-shadow: 0 30px 80px rgba(0,0,0,0.6);
  transform: scale(0.97);
  transition: transform 0.2s ease;
  cursor: zoom-out;
}
.lightbox-overlay.open .lightbox-img { transform: scale(1); }
.lightbox-close {
  position: fixed;
  top: 1.5rem;
  right: 1.5rem;
  width: 42px;
  height: 42px;
  border-radius: 50%;
  background: var(--bg-card2);
  border: 1px solid var(--border-strong);
  color: var(--text);
  display: flex;
  align-items: center;
  justify-content: center;
  cursor: pointer;
  font-size: 1rem;
  transition: border-color 0.2s, color 0.2s;
}
.lightbox-close:hover { border-color: var(--border-hover); color: var(--gold); }

/* ═══════════════════════════════════════════════════════════
   RESPONSIVE — pasada dedicada para que se vea bien en
   cualquier dispositivo, no solo que "no se rompa".
   ═══════════════════════════════════════════════════════════ */

/* Tablet / pantallas medianas: algo más de aire ya cubierto arriba
   (.docs-content padding a 1100px). Aquí afinamos el resto. */
@media (max-width: 900px) {
  .docs-navbar-inner { padding: 0 1.1rem; }
}

@media (max-width: 640px) {
  .docs-content { padding: 1.5rem 1.15rem 3rem; }
  .docs-content h1 { font-size: 1.65rem; }
  .docs-lede { font-size: 1rem; margin-bottom: 1.75rem; }
  .docs-content h2 { font-size: 1.2rem; margin: 2.25rem 0 0.9rem; }

  /* el paginador pasa de 2 columnas a apilado, si no las tarjetas
     quedan demasiado estrechas para el título en pantallas pequeñas */
  .docs-pager { flex-direction: column; }
  .pager-link { max-width: 100%; }
  .pager-link.next { text-align: left; margin-left: 0; }
  .pager-link.next .pager-label { justify-content: flex-start; }

  /* cabecera de los bloques de código: permite que la etiqueta baje
     de línea en vez de comprimir el botón de copiar */
  .code-block-head { flex-wrap: wrap; row-gap: 0.4rem; }
  .code-block-head span:nth-of-type(2) { margin-left: 0; }
  .code-copy-btn span { display: none; }
  .code-copy-btn { padding: 0.32rem; }

  /* callouts e imágenes con menos aire lateral para aprovechar el ancho */
  .callout { padding: 1rem 1.1rem; }
  .docs-card-grid { gap: 0.75rem; }

  /* pasos: menos separación para que quepa bien el número + texto */
  .step { gap: 0.7rem; }
  .step.step-primary { gap: 0.85rem; }
}

@media (max-width: 480px) {
  .docs-breadcrumb { font-size: 0.74rem; }
  .docs-content h1 { font-size: 1.45rem; }

  /* buscador: el pie con los atajos no cabe con las 3 etiquetas completas */
  .search-modal-foot span:not(:last-child) span,
  .search-modal-foot { gap: 0.7rem; font-size: 0.68rem; }
  .search-overlay { padding: 6vh 0.6rem 1rem; }
  .search-modal { max-height: 80vh; }

  /* lightbox: menos margen para aprovechar la pantalla pequeña */
  .lightbox-overlay { padding: 2vh 2vw; }
  .lightbox-close { top: 0.75rem; right: 0.75rem; width: 38px; height: 38px; }

  .docs-table th, .docs-table td { padding: 0.6rem 0.75rem; font-size: 0.82rem; }
}

/* Pantallas muy anchas: evita que el contenido se quede perdido en
   monitores grandes mientras el sidebar sigue a 280px fijos */
@media (min-width: 1600px) {
  .docs-shell { max-width: 1560px; }
  .docs-content { max-width: 960px; }
}