/* ============================================================
   DOCUMENTACIÓN — sitio multipágina (sidebar + buscador).
   Cada sección es su PROPIA página (/documentacion/<slug>/) con
   su propio <title> y <h1>. El sidebar es un include compartido;
   el enlace activo lo marca docs-site.js por la URL. Reutiliza los
   tokens de :root de styles.css y la tipografía de docs.css
   (.doc-prose). Premium, sobrio, Vaucai. Mobile-first.
   ============================================================ */

.docsite {
    max-width: 1200px;
    margin: 0 auto;
    padding: 0 20px;
}
/* El footer vive DENTRO de la columna del artículo (lo pone así cada página):
   en el ordenador los dos índices están fijos y un footer a todo el ancho les
   pasaba por encima y los cortaba por la mitad al final de la página. En el
   móvil se sale del padding de .docsite y queda a sangre, como en el resto de
   la web. */
.docsite-main > .site-footer { margin: 96px -20px 0; }
/* En el ordenador sólo se mueve el artículo: la nav (logo + hamburguesa, fija
   por `<body class="nav-fija">`, en styles.css), el índice de la izquierda y
   el «En esta página» de la derecha quedan FIJOS. --docsite-top es donde
   empiezan los dos índices: la nav y 28 px de aire. */
@media (min-width: 1000px) {
    :root { --docsite-top: calc(var(--nav-fija-alto) + 28px); }
    .docsite {
        display: grid;
        grid-template-columns: 260px minmax(0, 1fr);
        gap: 56px;
        align-items: start;
        padding-top: 28px;
    }
}

/* ---------- BARRA MÓVIL ---------- */
.docsite-topbar {
    display: flex;
    align-items: center;
    gap: 12px;
    position: sticky;
    top: 0;
    z-index: 40;
    padding: 14px 0;
    margin-bottom: 4px;
    background: linear-gradient(var(--bg) 70%, transparent);
    backdrop-filter: blur(6px);
}
.docsite-menu-btn {
    display: inline-flex;
    align-items: center;
    gap: 10px;
    font: inherit;
    font-size: 15px;
    font-weight: 650;
    color: var(--fg);
    background: var(--surface);
    border: 1px solid var(--border-light);
    border-radius: 12px;
    padding: 10px 16px;
    cursor: pointer;
}
.docsite-menu-btn svg { width: 18px; height: 18px; }
@media (min-width: 1000px) {
    .docsite-topbar { display: none; }
}

/* ---------- SIDEBAR ---------- */
.docsite-sidebar {
    display: flex;
    flex-direction: column;
    gap: 18px;
}
@media (min-width: 1000px) {
    /* FIJO, no sticky: con sticky el índice subía al empezar a bajar y al
       final el footer lo empujaba hacia arriba. Su `left` es el borde de la
       rejilla (1200 px de máximo y 20 px de padding; 1280 con el índice
       derecho, abajo), medido como el `right` del .docsite-toc. Al salir de
       la rejilla, el contenido va a su columna a mano. */
    .docsite-sidebar {
        position: fixed;
        top: var(--docsite-top);
        left: max(20px, calc(50% - 580px));
        width: 260px;
        max-height: calc(100vh - var(--docsite-top) - 24px);
        overflow-y: auto;
        padding-right: 6px;
        padding-bottom: 24px;
        scrollbar-width: thin;
    }
}
@media (max-width: 999px) {
    .docsite-sidebar {
        display: none;
        padding: 6px 0 18px;
        border-bottom: 1px solid var(--border);
        margin-bottom: 24px;
    }
    .docsite-sidebar.is-open { display: flex; }
}

.docsite-brand {
    display: block;
    font-family: 'Inter', 'Inter Fallback', 'Inter Fallback Roboto', -apple-system, BlinkMacSystemFont, system-ui, sans-serif;
    font-size: 19px;
    font-weight: 800;
    letter-spacing: -0.02em;
    color: var(--fg);
    text-decoration: none;
    padding-left: 12px;
}
.docsite-brand:hover { color: var(--accent-hover); }

#docs-search {
    width: 100%;
    font: inherit;
    font-size: 14.5px;
    color: var(--fg);
    background: var(--surface);
    border: 1px solid var(--border-light);
    border-radius: 11px;
    padding: 10px 44px 10px 36px;
    outline: none;
    transition: border-color .18s ease, background .18s ease;
}
#docs-search::placeholder { color: var(--muted-soft); }
#docs-search:focus { border-color: var(--accent); background: var(--surface-soft); }

.docsite-nav {
    /* Reset de lo que se filtra del selector de elemento `nav {}` de
       styles.css (navbar principal): align-items:center centraba cada
       grupo y desalineaba EMPEZAR/REFERENCIA; padding/max-width/margin
       también se heredaban. Aquí mandamos columna estirada a la izquierda. */
    display: flex;
    flex-direction: column;
    align-items: stretch;
    justify-content: flex-start;
    gap: 22px;
    padding: 0;
    margin: 0;
    max-width: none;
    width: auto;
}
.docsite-navgroup { display: flex; flex-direction: column; gap: 1px; }
.docsite-navlabel {
    font-size: 11px;
    font-weight: 700;
    text-transform: uppercase;
    letter-spacing: 0.11em;
    color: var(--muted-soft);
    margin: 0 0 8px;
    padding-left: 12px;
    text-decoration: underline;
    text-underline-offset: 3px;
    text-decoration-thickness: 1px;
}
.docsite-nav a {
    display: block;
    position: relative;
    padding: 8px 12px;
    border-radius: 9px;
    color: var(--muted);
    text-decoration: none;
    font-size: 14.5px;
    line-height: 1.35;
    transition: color .15s ease, background .15s ease;
}
.docsite-nav a:hover { color: var(--fg); background: var(--surface); }
.docsite-nav a.is-active {
    color: var(--accent-hover);
    background: rgba(0, 127, 255, 0.08);
    font-weight: 600;
}
.docsite-nav a.is-active::before {
    content: "";
    position: absolute;
    left: 0;
    top: 6px;
    bottom: 6px;
    width: 2px;
    border-radius: 2px;
    background: var(--accent);
}
.docsite-nav a.is-hidden { display: none; }
.docsite-navgroup.is-empty { display: none; }
.docsite-noresults {
    display: none;
    color: var(--muted-soft);
    font-size: 14px;
    padding: 8px 12px;
}
.docsite-noresults.is-shown { display: block; }

/* ---------- "EN ESTA PÁGINA" (índice derecha, lo monta docs-site.js) ---------- */
.docsite-toc { display: none; }
@media (min-width: 1200px) {
    .docsite.has-toc {
        max-width: 1280px;
        grid-template-columns: 260px minmax(0, 1fr) 196px;
    }
    .docsite.has-toc .docsite-sidebar { left: max(20px, calc(50% - 620px)); }
    /* Fijo como el de la izquierda. Su columna es la última de la rejilla
       (1280 px de máximo y 20 px de padding): el % de `right` se mide sobre el
       viewport SIN la barra de scroll, así que cuadra con la rejilla al
       píxel; 100vw la incluiría y lo descolocaría en Windows. */
    .docsite-toc {
        display: block;
        position: fixed;
        top: var(--docsite-top);
        right: max(20px, calc(50% - 620px));
        width: 196px;
        max-height: calc(100vh - var(--docsite-top) - 24px);
        overflow-y: auto;
        scrollbar-width: thin;
    }
}
/* ---------- NOVEDADES: tarjeta destacada por mejora ---------- */
.docsite-update {
    background: var(--surface);
    border: 1px solid var(--border-light);
    border-left: 3px solid var(--accent);
    border-radius: 12px;
    padding: 15px 18px;
    margin: 0 0 4px;
    color: var(--muted);
    line-height: 1.6;
}
.docsite-update strong { color: var(--fg); font-weight: 700; }

/* ---------- CONTENIDO ---------- */
.docsite-main { min-width: 0; }
/* Donde aterriza un apartado al saltar desde el índice o con un #enlace.
   docs-site.js lo lee de aquí para Lenis y para el resaltado. En el
   ordenador la nav fija ya la descuenta el scroll-padding-top de la página
   (styles.css): aquí va sólo el aire, el mismo que encima de los índices. */
.docsite-article .doc-prose h3 { scroll-margin-top: 2rem; }
@media (min-width: 1000px) {
    .docsite-main { grid-column: 2; }
    .docsite-article .doc-prose h3 { scroll-margin-top: calc(var(--docsite-top) - var(--nav-fija-alto)); }
    .docsite-main > .site-footer { margin-inline: 0; }
}

.docsite-article {
    padding-top: 6px;
    max-width: 760px;
    animation: docsite-fade .3s ease;
}
@keyframes docsite-fade {
    from { opacity: 0; transform: translateY(6px); }
    to   { opacity: 1; transform: none; }
}

.docsite-title {
    font-family: 'Inter', 'Inter Fallback', 'Inter Fallback Roboto', -apple-system, BlinkMacSystemFont, system-ui, sans-serif;
    font-size: clamp(28px, 4.8vw, 40px);
    font-weight: 800;
    letter-spacing: -0.03em;
    line-height: 1.1;
    color: var(--fg);
    margin: 0 0 16px;
}
.docsite-deck {
    font-size: clamp(16px, 2.3vw, 19px);
    color: var(--fg-soft);
    line-height: 1.55;
    margin: 0 0 32px;
    max-width: 62ch;
}

/* El cuerpo reutiliza .doc-prose de docs.css (h3/p/ul/li/strong/a/code). */
.docsite-article .doc-prose code {
    font-family: ui-monospace, SFMono-Regular, Menlo, monospace;
    font-size: 0.86em;
    background: var(--surface-soft);
    color: var(--fg);
    padding: 2px 7px;
    border-radius: 6px;
    border: 1px solid var(--border-soft);
    white-space: nowrap;
}

/* Bloque de código (curl, respuestas JSON). Preserva los saltos de línea y
   scrollea en horizontal DENTRO de la caja: sin esto, el `code` inline hereda
   white-space:nowrap y colapsa el curl multilínea en una sola línea que se sale
   de la página. */
.docsite-article .doc-prose pre {
    background: var(--surface-soft);
    border: 1px solid var(--border-soft);
    border-radius: 12px;
    padding: 16px 18px;
    margin: 0 0 18px;
    max-width: 100%;
    overflow-x: auto;
    -webkit-overflow-scrolling: touch;
}
.docsite-article .doc-prose pre code {
    display: block;
    background: none;
    border: 0;
    padding: 0;
    border-radius: 0;
    font-size: 13.5px;
    line-height: 1.6;
    color: var(--fg-soft);
    white-space: pre;
}

.pro-tag {
    display: inline-block;
    margin-left: 8px;
    font-size: 10.5px;
    font-weight: 700;
    text-transform: uppercase;
    letter-spacing: 0.06em;
    color: var(--accent-hover);
    vertical-align: middle;
}
/* Scrollbar fina del sidebar (webkit) */
.docsite-sidebar::-webkit-scrollbar { width: 8px; }
.docsite-sidebar::-webkit-scrollbar-thumb { background: var(--border-light); border-radius: 8px; }