/* ---------------------------------------------------------------------------
   Documentación de Oktavia: el portal técnico dentro de la Academia.

   Se carga DESPUÉS de docs_style.css y sólo en las páginas del portal. Hereda
   los tokens, la barra superior, las secciones, tablas y la hoja de impresión;
   aquí vive únicamente lo que un portal de documentación tiene y un documento
   largo no: buscador, tarjetas de categoría, barra lateral con el árbol de
   documentos, migas de pan y las etiquetas de estado.

   La jerarquía visual sigue la de un portal de documentación serio: primero
   orientación (portada y buscador), luego lo destacado, después las categorías
   y al final las referencias profundas. Las tarjetas se usan sólo para
   elementos repetidos; el resto son listas, que se escanean más rápido.
   --------------------------------------------------------------------------- */

/* El portal necesita más ancho que un documento: en las páginas con barra
   lateral el contenido conserva ~70ch y la barra ocupa el resto. */
body.docs-portal {
    --doc-width: min(1240px, calc(100% - 40px));
    --docs-side-width: 272px;
}

/* ------------------------------- Buscador --------------------------------- */

.docs-search {
    position: relative;
    max-width: 640px;
}

.docs-search-form {
    display: flex;
    align-items: center;
    gap: 10px;
    padding: 6px 6px 6px 14px;
    border: 1px solid var(--line-strong);
    border-radius: 999px;
    background: var(--bg-deep);
}

.docs-search-form:focus-within {
    border-color: var(--brand);
    box-shadow: 0 0 0 3px rgba(43, 143, 212, 0.22);
}

.docs-search-form .material-symbols-outlined {
    color: var(--text-muted);
    font-size: 22px;
}

.docs-search-form input {
    flex: 1;
    min-width: 0;
    padding: 8px 0;
    border: 0;
    background: transparent;
    color: var(--text-main);
    font: inherit;
    font-size: 1rem;
}

.docs-search-form input:focus {
    outline: none;
}

.docs-search-form input::placeholder {
    color: var(--text-muted);
}

.docs-search-form button {
    padding: 8px 16px;
    border: 0;
    border-radius: 999px;
    background: var(--brand);
    color: #0d1319;
    font: inherit;
    font-weight: 700;
    cursor: pointer;
}

.docs-search-form button:hover,
.docs-search-form button:focus-visible {
    background: var(--brand-strong);
}

.docs-search-results {
    position: absolute;
    z-index: 20;
    top: calc(100% + 8px);
    left: 0;
    right: 0;
    margin: 0;
    padding: 6px;
    list-style: none;
    max-height: 60vh;
    overflow-y: auto;
    border: 1px solid var(--line-strong);
    border-radius: var(--radius-md);
    background: var(--bg-elevated);
    box-shadow: var(--shadow-soft);
}

.docs-search-results[hidden] {
    display: none;
}

.docs-search-results li a,
.docs-search-results li p {
    display: block;
    margin: 0;
    padding: 10px 12px;
    border-radius: 8px;
    color: var(--text-main);
}

.docs-search-results li a:hover,
.docs-search-results li a:focus-visible,
.docs-search-results li.is-active a {
    background: var(--brand-soft);
    text-decoration: none;
}

.docs-search-results .docs-result-title {
    display: block;
    font-weight: 700;
}

.docs-search-results .docs-result-path {
    display: block;
    font-size: 0.8rem;
    color: var(--highlight);
    letter-spacing: 0.04em;
    text-transform: uppercase;
}

.docs-search-results .docs-result-summary {
    display: block;
    font-size: 0.88rem;
    color: var(--text-muted);
}

.docs-search-results li p {
    color: var(--text-muted);
    font-size: 0.9rem;
}

.docs-search-hint {
    margin: 10px 0 0;
    font-size: 0.84rem;
    color: var(--text-muted);
}

.docs-search-hint a {
    color: var(--brand-strong);
}

/* --------------------------- Migas de pan --------------------------------- */

.docs-crumbs {
    margin: 0 0 14px;
    font-size: 0.86rem;
    color: var(--text-muted);
}

.docs-crumbs ol {
    display: flex;
    flex-wrap: wrap;
    gap: 6px;
    margin: 0;
    padding: 0;
    list-style: none;
}

.docs-crumbs li + li::before {
    content: "/";
    margin-right: 6px;
    color: var(--line-strong);
}

.docs-crumbs a {
    color: var(--text-muted);
}

.docs-crumbs a:hover,
.docs-crumbs a:focus-visible {
    color: var(--brand-strong);
}

.docs-crumbs [aria-current] {
    color: var(--text-main);
    font-weight: 600;
}

/* ------------------------- Portada del portal ----------------------------- */

.docs-hero {
    display: grid;
    gap: 18px;
}

.docs-hero .doc-lede {
    margin-bottom: 4px;
}

/* -------------------- Bloques de la página de inicio ---------------------- */

.docs-block {
    margin-top: 30px;
}

.docs-block-head {
    display: flex;
    flex-wrap: wrap;
    align-items: baseline;
    justify-content: space-between;
    gap: 8px 18px;
    margin: 0 0 14px;
}

.docs-block-head h2 {
    margin: 0;
    font-size: 1.35rem;
    line-height: 1.2;
}

.docs-block-head p {
    margin: 0;
    color: var(--text-muted);
    font-size: 0.95rem;
    flex: 1 1 100%;
}

.docs-block-head .docs-block-link {
    font-size: 0.9rem;
    font-weight: 700;
    white-space: nowrap;
}

/* Tarjetas: sólo para lo destacado, que son elementos repetidos del mismo
   tipo. Cuatro por fila en escritorio, dos en tableta, una en móvil. */
.docs-cards {
    display: grid;
    grid-template-columns: repeat(auto-fit, minmax(230px, 1fr));
    gap: 14px;
    margin: 0;
    padding: 0;
    list-style: none;
}

.docs-card {
    display: flex;
    flex-direction: column;
    gap: 8px;
    height: 100%;
    padding: 18px 18px 16px;
    border: 1px solid var(--line-soft);
    border-radius: var(--radius-md);
    background: var(--bg-elevated);
    color: var(--text-main);
    transition: border-color 160ms ease, transform 160ms ease;
}

.docs-card:hover,
.docs-card:focus-visible {
    border-color: var(--brand);
    transform: translateY(-2px);
    text-decoration: none;
}

.docs-card .material-symbols-outlined {
    width: 38px;
    height: 38px;
    display: inline-flex;
    align-items: center;
    justify-content: center;
    border-radius: 10px;
    background: var(--brand-soft);
    color: var(--brand-strong);
    font-size: 22px;
}

.docs-card h3 {
    margin: 4px 0 0;
    font-size: 1.02rem;
    line-height: 1.3;
}

.docs-card p {
    margin: 0;
    font-size: 0.9rem;
    line-height: 1.5;
    color: var(--text-muted);
}

.docs-card .docs-card-kind {
    margin-top: auto;
    padding-top: 6px;
    font-size: 0.76rem;
    font-weight: 700;
    letter-spacing: 0.06em;
    text-transform: uppercase;
    color: var(--highlight);
}

/* Catálogo por categorías: cada categoría es una columna con su lista de
   documentos. Listas, no tarjetas: se leen de arriba abajo de un vistazo. */
.docs-catalog {
    display: grid;
    /* auto-fit: las categorías de un bloque llenan la fila. Con auto-fill
       quedaban dos tarjetas angostas y el resto de la fila vacío. */
    grid-template-columns: repeat(auto-fit, minmax(300px, 1fr));
    gap: 16px;
    margin: 0;
    padding: 0;
    list-style: none;
}

.docs-category {
    padding: 20px 22px 16px;
    border: 1px solid var(--line-soft);
    border-radius: var(--radius-lg);
    background: var(--bg-elevated);
}

.docs-category-head {
    display: flex;
    align-items: center;
    gap: 12px;
    margin: 0 0 6px;
}

.docs-category-head .material-symbols-outlined {
    width: 40px;
    height: 40px;
    display: inline-flex;
    align-items: center;
    justify-content: center;
    border-radius: 11px;
    background: var(--brand-soft);
    color: var(--brand-strong);
    font-size: 22px;
    flex: none;
}

.docs-category-head h3 {
    margin: 0;
    font-size: 1.1rem;
    line-height: 1.25;
}

.docs-category-head h3 a {
    color: var(--text-main);
}

.docs-category > p {
    margin: 0 0 12px;
    font-size: 0.9rem;
    color: var(--text-muted);
}

.docs-category ul {
    margin: 0;
    padding: 0;
    list-style: none;
    /* En una tarjeta ancha los vínculos se reparten en columnas en vez de
       una lista larga y angosta. */
    display: grid;
    grid-template-columns: repeat(auto-fill, minmax(210px, 1fr));
    column-gap: 24px;
}

.docs-category li {
    padding: 7px 0;
    border-top: 1px solid var(--line-soft);
    font-size: 0.94rem;
    display: flex;
    align-items: baseline;
    justify-content: space-between;
    gap: 10px;
}

.docs-category li a {
    color: var(--brand-strong);
    font-weight: 600;
}

.docs-category-more {
    display: inline-block;
    margin-top: 10px;
    font-size: 0.88rem;
    font-weight: 700;
}

/* Lista plana para la introducción: títulos con una línea de resumen. */
.docs-linklist {
    display: grid;
    grid-template-columns: repeat(auto-fill, minmax(280px, 1fr));
    gap: 4px 28px;
    margin: 0;
    padding: 0;
    list-style: none;
}

.docs-linklist li {
    padding: 10px 0;
    border-bottom: 1px solid var(--line-soft);
}

.docs-linklist a {
    display: block;
    font-weight: 700;
    color: var(--brand-strong);
}

.docs-linklist span {
    display: block;
    margin-top: 2px;
    font-size: 0.88rem;
    color: var(--text-muted);
}

/* Etiqueta de estado. Lo que todavía no está documentado se marca, no se
   finge: un lector que encuentra una página vacía no vuelve. */
.docs-badge {
    display: inline-block;
    flex: none;
    padding: 2px 9px;
    border: 1px solid var(--line-strong);
    border-radius: 999px;
    font-size: 0.7rem;
    font-weight: 700;
    letter-spacing: 0.05em;
    text-transform: uppercase;
    color: var(--text-muted);
    white-space: nowrap;
    vertical-align: middle;
}

.docs-badge.is-soon {
    border-color: rgba(251, 191, 36, 0.45);
    color: #fbbf24;
}

.docs-badge.is-ref {
    border-color: rgba(87, 200, 234, 0.45);
    color: var(--highlight);
}

h2 .docs-badge,
h3 .docs-badge {
    margin-left: 8px;
}

/* ------------------- Páginas con barra lateral (secciones) ---------------- */

.docs-layout {
    display: grid;
    grid-template-columns: var(--docs-side-width) minmax(0, 1fr);
    gap: 32px;
    align-items: start;
}

.docs-side {
    position: sticky;
    top: 74px;
    max-height: calc(100vh - 90px);
    overflow-y: auto;
    padding: 4px 4px 24px 0;
    scrollbar-width: thin;
}

.docs-side .docs-search {
    margin-bottom: 16px;
}

.docs-side .docs-search-form {
    padding: 4px 4px 4px 12px;
}

.docs-side .docs-search-form input {
    font-size: 0.92rem;
}

.docs-side .docs-search-form button {
    display: none;
}

.docs-side-toggle {
    display: none;
}

.docs-tree {
    margin: 0;
    padding: 0;
    list-style: none;
    font-size: 0.9rem;
}

.docs-tree > li {
    margin-bottom: 4px;
}

.docs-tree > li > a {
    display: flex;
    align-items: center;
    gap: 8px;
    padding: 7px 10px;
    border-radius: 8px;
    color: var(--text-main);
    font-weight: 700;
}

.docs-tree > li > a .material-symbols-outlined {
    font-size: 18px;
    color: var(--highlight);
}

.docs-tree > li > a:hover,
.docs-tree > li > a:focus-visible {
    background: var(--bg-elevated);
    text-decoration: none;
}

.docs-tree ul {
    margin: 0 0 6px;
    padding: 0 0 0 14px;
    list-style: none;
    border-left: 1px solid var(--line-soft);
    margin-left: 18px;
}

.docs-tree ul a {
    display: block;
    padding: 5px 10px;
    border-radius: 6px;
    color: var(--text-muted);
}

.docs-tree ul a:hover,
.docs-tree ul a:focus-visible {
    color: var(--brand-strong);
    background: var(--bg-elevated);
    text-decoration: none;
}

.docs-tree li.is-current > a {
    color: var(--brand-strong);
    background: var(--brand-soft);
}

.docs-tree ul li.is-active > a {
    color: var(--brand-strong);
    font-weight: 700;
    background: var(--brand-soft);
}

.docs-tree ul .docs-badge {
    margin-left: 6px;
    font-size: 0.62rem;
    padding: 1px 6px;
}

/* La sección que corresponde a la página abierta muestra sus documentos;
   las demás quedan plegadas para que el árbol se escanee. */
.docs-tree li:not(.is-current) > ul {
    display: none;
}

.docs-main-col {
    min-width: 0;
}

.docs-main-col .doc-cover {
    padding: 28px 30px 26px;
}

.docs-main-col .doc-section:first-of-type {
    margin-top: 26px;
}

/* Navegación anterior / siguiente al pie de cada sección. */
.docs-pager {
    display: grid;
    grid-template-columns: 1fr 1fr;
    gap: 14px;
    margin-top: 28px;
}

.docs-pager a {
    display: block;
    padding: 14px 18px;
    border: 1px solid var(--line-soft);
    border-radius: var(--radius-md);
    background: var(--bg-elevated);
    color: var(--text-main);
}

.docs-pager a:hover,
.docs-pager a:focus-visible {
    border-color: var(--brand);
    text-decoration: none;
}

.docs-pager a span {
    display: block;
    font-size: 0.74rem;
    font-weight: 700;
    letter-spacing: 0.06em;
    text-transform: uppercase;
    color: var(--text-muted);
}

.docs-pager a strong {
    display: block;
    margin-top: 2px;
    color: var(--brand-strong);
}

.docs-pager a.is-next {
    text-align: right;
}

/* Detalles dentro de un documento: resumen de "cuándo usarlo", "quién lo
   lee" o pasos. Comparte estética con .doc-callout pero con cabecera. */
.docs-aside {
    margin: 0 0 14px;
    padding: 14px 18px;
    border: 1px solid var(--line-soft);
    border-radius: var(--radius-md);
    background: var(--bg-deep);
}

.docs-aside h4 {
    margin: 0 0 8px;
    font-size: 0.8rem;
    font-weight: 800;
    letter-spacing: 0.08em;
    text-transform: uppercase;
    color: var(--highlight);
}

.docs-aside p:last-child,
.docs-aside ul:last-child {
    margin-bottom: 0;
}

/* Lista de definiciones (glosario, variables, campos sueltos). */
.docs-dl {
    margin: 0 0 14px;
    display: grid;
    grid-template-columns: minmax(140px, 220px) 1fr;
    gap: 8px 18px;
}

.docs-dl dt {
    font-weight: 700;
    color: var(--text-main);
    overflow-wrap: anywhere;
}

.docs-dl dd {
    margin: 0;
    color: var(--text-muted);
}

/* Código en línea: nombres de campos, archivos y comandos. */
.doc-section code,
.docs-dl code,
table.doc-table code {
    padding: 1px 6px;
    border-radius: 6px;
    background: rgba(87, 200, 234, 0.1);
    color: var(--brand-strong);
    font-size: 0.86em;
    overflow-wrap: anywhere;
}

pre code {
    padding: 0;
    background: none;
    color: inherit;
    font-size: inherit;
}

/* Tablas de referencia de campos: se generan desde los datos y llevan un
   filtro para encontrar un campo sin desplazarse. */
.docs-fields-filter {
    display: flex;
    flex-wrap: wrap;
    align-items: center;
    gap: 10px;
    margin: 0 0 14px;
}

.docs-fields-filter input {
    flex: 1 1 240px;
    padding: 9px 14px;
    border: 1px solid var(--line-strong);
    border-radius: 999px;
    background: var(--bg-deep);
    color: var(--text-main);
    font: inherit;
    font-size: 0.94rem;
}

.docs-fields-filter input:focus {
    outline: none;
    border-color: var(--brand);
}

.docs-fields-filter output {
    font-size: 0.86rem;
    color: var(--text-muted);
}

table.doc-table.docs-fields th:nth-child(1) { min-width: 150px; }
table.doc-table.docs-fields th:nth-child(2) { min-width: 100px; }
table.doc-table.docs-fields th:nth-child(3) { min-width: 90px; }
table.doc-table.docs-fields th:nth-child(4) { min-width: 110px; }
table.doc-table.docs-fields th:nth-child(5) { min-width: 150px; }
table.doc-table.docs-fields th:nth-child(6) { min-width: 260px; }

table.doc-table.docs-fields td:first-child {
    font-weight: 700;
    color: var(--text-main);
}

table.doc-table tr[hidden] {
    display: none;
}

.docs-fields-empty {
    padding: 12px 14px;
    color: var(--text-muted);
}

/* ------------------------------ Responsivo -------------------------------- */

@media (max-width: 960px) {
    .docs-layout {
        grid-template-columns: 1fr;
        gap: 20px;
    }

    .docs-side {
        position: static;
        max-height: none;
        overflow: visible;
        padding: 16px 18px;
        border: 1px solid var(--line-soft);
        border-radius: var(--radius-md);
        background: var(--bg-elevated);
    }

    .docs-side-toggle {
        display: flex;
        width: 100%;
        align-items: center;
        justify-content: space-between;
        gap: 10px;
        padding: 0;
        border: 0;
        background: none;
        color: var(--text-main);
        font: inherit;
        font-weight: 700;
        cursor: pointer;
    }

    .docs-side-toggle .material-symbols-outlined {
        transition: transform 160ms ease;
    }

    .docs-side-toggle[aria-expanded="true"] .material-symbols-outlined {
        transform: rotate(180deg);
    }

    .docs-side-body {
        margin-top: 14px;
    }

    .docs-side-body[hidden] {
        display: none;
    }

    .docs-side .docs-search-form button {
        display: inline-flex;
    }
}

@media (max-width: 720px) {
    .docs-search-form button {
        padding: 8px 12px;
        font-size: 0.9rem;
    }

    .docs-pager {
        grid-template-columns: 1fr;
    }

    .docs-pager a.is-next {
        text-align: left;
    }

    .docs-dl {
        grid-template-columns: 1fr;
        gap: 2px 0;
    }

    .docs-dl dd {
        margin-bottom: 10px;
    }

    .docs-main-col .doc-cover {
        padding: 22px 18px;
    }
}

/* ------------------------------- Impresión -------------------------------- */

@media print {
    .docs-side,
    .docs-search,
    .docs-pager,
    .docs-fields-filter,
    .docs-crumbs {
        display: none !important;
    }

    .docs-layout {
        display: block;
    }

    .docs-card,
    .docs-category,
    .docs-aside {
        border-color: #d4deea;
        background: #fff;
        break-inside: avoid;
    }

    .docs-badge.is-soon {
        color: #8a5a00;
        border-color: #c9a35a;
    }

    .doc-section code,
    .docs-dl code,
    table.doc-table code {
        background: #eef4fb;
        color: #063e66;
    }
}

/* La pirámide de la Academia (antes en docs/academia.html, que ahora redirige
   al bloque Academia del portal): los niveles se angostan hacia arriba. */
/* Compacta y centrada: a todo el ancho se veía demasiado grande frente a las
   tarjetas de los cursos que van debajo. */
.academy-pyramid { list-style: none; margin: 0 auto; padding: 0; display: grid; gap: 5px; justify-items: center;
    max-width: 680px; }
.academy-pyramid li { box-sizing: border-box; padding: 7px 12px; border-radius: 8px; text-align: center; color: #fff;
    background: linear-gradient(135deg, #0b4a78, #2b8fd4); display: flex; flex-direction: column; gap: 2px; }
.academy-pyramid .lvl-5 { width: 52%; background: linear-gradient(135deg, #3b1d6e, #7c4dcc); }
.academy-pyramid .lvl-4 { width: 64%; background: linear-gradient(135deg, #0a3657, #1d6fa8); }
.academy-pyramid .lvl-3 { width: 76%; background: linear-gradient(135deg, #0b4a78, #2482c2); }
.academy-pyramid .lvl-2 { width: 88%; background: linear-gradient(135deg, #0f6b8f, #2fb0c9); }
.academy-pyramid .lvl-1 { width: 100%; background: linear-gradient(135deg, #12806f, #34c3a0); }
.academy-pyramid .lvl-name { font-weight: 800; font-size: 0.9rem; line-height: 1.25; }
.academy-pyramid .lvl-tag { font-size: 0.74rem; opacity: 0.9; line-height: 1.25; }
@media (max-width: 640px) {
    .academy-pyramid .lvl-5, .academy-pyramid .lvl-4, .academy-pyramid .lvl-3, .academy-pyramid .lvl-2 { width: 100%; }
}

/* Academia: la descripción a la izquierda y la pirámide a la derecha, en la
   misma fila; apiladas en pantallas angostas. Quita el hueco que dejaba la
   pirámide sola entre el texto y las tarjetas. */
.academy-intro {
    display: grid;
    grid-template-columns: minmax(0, 1fr) minmax(0, 1.25fr);
    gap: 18px 36px;
    align-items: center;
    margin: 0 0 16px;
}

.academy-intro .docs-block-head {
    margin: 0;
}

.academy-intro .academy-pyramid {
    width: 100%;
}

.academy-intro .docs-block-head p {
    margin-top: 6px;
}

@media (max-width: 960px) {
    .academy-intro {
        grid-template-columns: 1fr;
    }
}