/* documentacion.css — documentacion para usuarios (documentacion.php + scripts/d-documentacion.js).
   Se carga despues de index.css y usa su paleta (--home-*): indice a la izquierda (.app-sidebar),
   articulo en el centro y "En esta pagina" a la derecha. */

body.docs-page {
    --docs-input-bg: var(--app-input-bg-dark);
    --docs-input-border: var(--app-input-border-dark);
    --docs-code-bg: #1b1b1b;
    --docs-link: var(--accent-text-dark);
    --docs-danger: #ff5c5c;
    --docs-scroll-thumb: #3a3a3a;
    --docs-scroll-thumb-hover: #555555;
}

body.theme-light.docs-page {
    --docs-input-bg: #ffffff;
    --docs-input-border: #dddddd;
    --docs-code-bg: #f4f4f4;
    --docs-link: var(--accent-text);
    --docs-danger: #bf2e2e;
    --docs-scroll-thumb: #cccccc;
    --docs-scroll-thumb-hover: #aaaaaa;
}

.docs-page [hidden] {
    display: none !important;
}

/* ===== Indice lateral ===== */
body.docs-page .docs-sidebar {
    width: 270px;
    padding: 0;
    background: var(--home-surface);
    border-color: var(--home-border);
    /* clip y no hidden: hidden haria del panel un contenedor de scroll y el indice no se pegaria */
    overflow: clip;
}

/* El indice se queda a la vista al bajar por la pagina y hace scroll propio si es largo */
.docs-sidebar-inner {
    position: sticky;
    top: 0;
    max-height: 100vh;
    overflow-y: auto;
    padding: 18px 14px 24px;
    display: flex;
    flex-direction: column;
    gap: 14px;
}

/* Barra de scroll fina y plana del indice y de "En esta pagina": gris sobre fondo transparente.
   scrollbar-* para Firefox y Chrome 121+; ::-webkit-scrollbar para Safari y Chrome antiguos */
.docs-sidebar-inner,
.docs-toc {
    scrollbar-width: thin;
    scrollbar-color: var(--docs-scroll-thumb) transparent;
}

.docs-sidebar-inner:hover,
.docs-toc:hover {
    scrollbar-color: var(--docs-scroll-thumb-hover) transparent;
}

.docs-sidebar-inner::-webkit-scrollbar,
.docs-toc::-webkit-scrollbar {
    width: 8px;
}

.docs-sidebar-inner::-webkit-scrollbar-track,
.docs-toc::-webkit-scrollbar-track {
    background: transparent;
}

.docs-sidebar-inner::-webkit-scrollbar-thumb,
.docs-toc::-webkit-scrollbar-thumb {
    background: var(--docs-scroll-thumb);
    border: 2px solid transparent;
    background-clip: padding-box;
}

.docs-sidebar-inner::-webkit-scrollbar-thumb:hover,
.docs-toc::-webkit-scrollbar-thumb:hover {
    background-color: var(--docs-scroll-thumb-hover);
}

.docs-sidebar-title {
    font-size: 15px;
    font-weight: 800;
    color: var(--home-ink);
    text-decoration: none;
}

.docs-sidebar-title:hover {
    color: var(--home-accent);
}

.docs-search {
    width: 100%;
    padding: 8px 10px;
    border: 1px solid var(--docs-input-border);
    background: var(--docs-input-bg);
    color: var(--home-ink);
    font: inherit;
    font-size: 14px;
}

.docs-search:focus {
    outline: none;
    border-color: var(--home-accent);
}

.docs-nav {
    display: flex;
    flex-direction: column;
    gap: 10px;
}

.docs-nav-section summary {
    display: flex;
    align-items: center;
    gap: 6px;
    padding: 4px 0;
    cursor: pointer;
    list-style: none;
    font-size: 12px;
    font-weight: 700;
    letter-spacing: 0.12em;
    text-transform: uppercase;
    color: var(--home-accent);
}

.docs-nav-section summary::-webkit-details-marker {
    display: none;
}

/* Flecha propia: apunta a la derecha plegada y abajo desplegada */
.docs-nav-section summary::before {
    content: "\25B8";
    font-size: 10px;
    color: var(--home-muted);
    transition: transform 0.15s;
}

.docs-nav-section[open] summary::before {
    transform: rotate(90deg);
}

.docs-nav-section ul {
    margin: 4px 0 0;
    padding: 0;
    list-style: none;
    border-left: 1px solid var(--home-border);
}

.docs-nav-link {
    display: block;
    margin-left: -1px;
    padding: 5px 10px 5px 14px;
    border-left: 2px solid transparent;
    color: var(--home-muted);
    font-size: 14px;
    line-height: 1.35;
    text-decoration: none;
    transition: color 0.15s, border-color 0.15s;
}

.docs-nav-link:hover {
    color: var(--home-ink);
    border-left-color: var(--home-border);
}

.docs-nav-link.is-current {
    color: var(--home-ink);
    font-weight: 600;
    border-left-color: var(--home-accent);
}

.docs-no-results {
    margin: 0;
    font-size: 13px;
    color: var(--home-muted);
}

/* Sin sesion: aviso al final del indice de que hay mas secciones */
.docs-sidebar-login {
    margin: 0;
    padding-top: 12px;
    border-top: 1px solid var(--home-border);
    font-size: 13px;
    line-height: 1.5;
    color: var(--home-muted);
}

.docs-sidebar-login a {
    color: var(--docs-link);
    font-weight: 600;
}

/* Botones de la pagina que pide iniciar sesion */
.docs-acciones {
    display: flex;
    flex-wrap: wrap;
    gap: 12px;
    margin-top: 20px;
}

.docs-article .docs-acciones .home-btn-primary {
    color: var(--home-accent-ink);
}

.docs-article .docs-acciones .home-btn-secondary {
    color: var(--home-ink);
}

/* ===== Contenido + "En esta pagina" ===== */
.docs-main {
    display: grid;
    grid-template-columns: minmax(0, 760px) 220px;
    justify-content: center;
    align-items: start;
    gap: 56px;
    padding: 36px 40px 72px;
}

.docs-article {
    min-width: 0;
    font-size: 15px;
    line-height: 1.7;
    color: var(--home-ink);
    overflow-wrap: anywhere;
}

.docs-breadcrumb {
    margin: 0 0 10px;
    display: flex;
    flex-wrap: wrap;
    gap: 8px;
    font-size: 13px;
    color: var(--home-muted);
}

.docs-breadcrumb a {
    color: var(--home-muted);
    text-decoration: none;
}

.docs-breadcrumb a:hover {
    color: var(--home-accent);
}

.docs-article h1 {
    margin: 0 0 24px;
    font-size: clamp(28px, 4vw, 38px);
    font-weight: 800;
    line-height: 1.1;
    letter-spacing: -0.02em;
}

.docs-article h1::after {
    content: "";
    display: block;
    width: 48px;
    height: 3px;
    margin-top: 18px;
    background: var(--home-accent);
}

/* Elementos que puede llevar el contenido de una pagina (docs/{idioma}/{slug}.html) */
.docs-body h2 {
    margin: 40px 0 12px;
    padding-top: 20px;
    border-top: 1px solid var(--home-border);
    font-size: 22px;
    font-weight: 700;
    line-height: 1.25;
    scroll-margin-top: 20px;
}

.docs-body h3 {
    margin: 28px 0 8px;
    font-size: 17px;
    font-weight: 700;
    scroll-margin-top: 20px;
}

.docs-body p,
.docs-body ul,
.docs-body ol {
    margin: 0 0 14px;
}

.docs-body ul,
.docs-body ol {
    padding-left: 22px;
}

.docs-body li + li {
    margin-top: 4px;
}

.docs-body .docs-lead {
    font-size: 17px;
    color: var(--home-muted);
}

.docs-article a {
    color: var(--docs-link);
}

.docs-article a:hover {
    color: var(--home-accent);
}

.docs-body code {
    padding: 1px 5px;
    background: var(--docs-code-bg);
    border: 1px solid var(--home-border);
    font-family: Consolas, "Courier New", monospace;
    font-size: 0.9em;
}

/* Teclas: <kbd>Ctrl</kbd> */
.docs-body kbd {
    padding: 1px 6px;
    border: 1px solid var(--home-border);
    border-bottom-width: 2px;
    font-family: inherit;
    font-size: 0.85em;
}

.docs-body img {
    display: block;
    max-width: 100%;
    height: auto;
    margin: 16px 0;
    border: 1px solid var(--home-border);
}

/* Tablas de datos (anulan las reglas de matriz de manos de app-common.css) */
.docs-body .docs-table-wrap {
    margin: 0 0 16px;
    overflow-x: auto;
}

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

.docs-body table :where(th, td) {
    width: auto;
    height: auto;
    padding: 8px 10px;
    border: 1px solid var(--home-border);
    background: transparent;
    color: var(--home-ink);
    text-align: left;
    font-size: 14px;
    font-weight: 400;
}

.docs-body table :where(th, td):hover {
    opacity: 1;
}

.docs-body table th {
    font-weight: 700;
    background: var(--home-surface);
}

/* Avisos: <div class="docs-callout"><p class="docs-callout-title">Nota</p><p>...</p></div> */
.docs-callout {
    margin: 0 0 16px;
    padding: 12px 16px;
    background: var(--home-surface);
    border: 1px solid var(--home-border);
    border-left: 3px solid var(--home-accent);
}

.docs-callout > :last-child {
    margin-bottom: 0;
}

.docs-callout-title {
    margin: 0 0 4px;
    font-size: 12px;
    font-weight: 700;
    letter-spacing: 0.12em;
    text-transform: uppercase;
    color: var(--home-accent);
}

.docs-callout-peligro {
    border-left-color: var(--docs-danger);
}

.docs-callout-peligro .docs-callout-title {
    color: var(--docs-danger);
}

/* Apartado todavia sin escribir */
.docs-callout-pendiente {
    border-style: dashed;
    border-left: 3px solid var(--home-muted);
    color: var(--home-muted);
}

/* Portada de la documentacion: una tarjeta por seccion */
.docs-index-grid {
    margin-top: 32px;
}

.docs-index-card {
    grid-column: span 6;
}

.docs-index-card ul {
    margin: 0;
    padding: 0;
    list-style: none;
}

.docs-index-card li + li {
    margin-top: 6px;
}

.docs-index-card a {
    color: var(--home-ink);
    font-size: 14px;
    text-decoration: none;
}

.docs-index-card a:hover {
    color: var(--home-accent);
}

/* Anterior / siguiente */
.docs-pager {
    margin-top: 48px;
    display: flex;
    gap: 12px;
}

.docs-pager-link {
    flex: 1 1 0;
    min-width: 0;
    display: flex;
    flex-direction: column;
    gap: 2px;
    padding: 14px 16px;
    border: 1px solid var(--home-border);
    font-weight: 600;
    text-decoration: none;
    transition: border-color 0.15s, color 0.15s;
}

.docs-article .docs-pager-link {
    color: var(--home-ink);
}

.docs-pager-link span {
    font-size: 12px;
    font-weight: 400;
    color: var(--home-muted);
}

.docs-article .docs-pager-link:hover {
    border-color: var(--home-accent);
    color: var(--home-accent);
}

/* El enlace "siguiente" siempre a la derecha, aunque no haya "anterior" */
.docs-pager-next {
    margin-left: auto;
    text-align: right;
}

/* "En esta pagina" */
.docs-toc {
    position: sticky;
    top: 24px;
    max-height: calc(100vh - 48px);
    overflow-y: auto;
}

.docs-toc h2 {
    margin: 0 0 10px;
    font-size: 12px;
    font-weight: 700;
    letter-spacing: 0.12em;
    text-transform: uppercase;
    color: var(--home-accent);
}

.docs-toc ul {
    margin: 0;
    padding: 0;
    list-style: none;
    border-left: 1px solid var(--home-border);
}

.docs-toc a {
    display: block;
    margin-left: -1px;
    padding: 4px 0 4px 12px;
    border-left: 2px solid transparent;
    color: var(--home-muted);
    font-size: 13px;
    line-height: 1.4;
    text-decoration: none;
}

.docs-toc .docs-toc-sub a {
    padding-left: 24px;
}

.docs-toc a:hover {
    color: var(--home-ink);
}

.docs-toc a.is-current {
    color: var(--home-ink);
    border-left-color: var(--home-accent);
}

.docs-search:focus-visible,
.docs-nav-section summary:focus-visible,
.docs-page a:focus-visible {
    outline: 2px solid var(--home-accent);
    outline-offset: 2px;
}

/* ===== Responsive ===== */
@media (max-width: 1200px) {
    .docs-main {
        grid-template-columns: minmax(0, 760px);
    }

    .docs-toc {
        display: none;
    }
}

@media (max-width: 900px) {
    /* Sin la barra "Ocultar panel" encima: recupera el borde de arriba y separa de la barra */
    body.docs-page .docs-sidebar {
        margin-top: 14px;
        padding: 0;
        border-top: 1px solid var(--home-border);
    }

    .docs-sidebar-inner {
        position: static;
        max-height: none;
    }

    .docs-main {
        padding: 24px 16px 48px;
    }
}

@media (max-width: 600px) {
    .docs-index-card {
        grid-column: 1 / -1;
    }

    .docs-pager {
        flex-direction: column;
    }
}