/* ==========================================================================
   Documentation page styles
   Builds on style.css (shares --accent-color and Montserrat).
   ========================================================================== */

:root {
    --docs-accent: #7f5ab6;
    --docs-accent-dark: #6d4a9e;
    --docs-accent-darker: #573a80;
    --docs-soft: #f3eef8;
    --docs-soft-2: #faf8fd;
    --docs-border: #e7dcf3;
    --docs-ink: #2c2733;
    --docs-ink-soft: #625a70;
    --docs-code-bg: #2b2640;
    --docs-code-ink: #ece7f7;
}

body.docs-page {
    background-color: #ffffff;
    color: var(--docs-ink);
    min-height: 100vh;
    /* Override style.css `overflow-x: hidden`, which turns overflow-y into
       auto and breaks `position: sticky` on .docs-sidebar. `clip` recorta
       igual pero no crea contenedor de scroll. */
    overflow-x: clip;
}

/* --- Back link ----------------------------------------------------------- */
.docs-back {
    display: inline-flex;
    align-items: center;
    gap: 0.45rem;
    color: var(--docs-accent-dark);
    font-weight: 600;
    font-size: 0.95rem;
    text-decoration: none;
    transition: color 0.15s ease, transform 0.15s ease;
}

.docs-back span[aria-hidden] {
    transition: transform 0.15s ease;
}

.docs-back:hover {
    color: var(--docs-accent-darker);
}

.docs-back:hover span[aria-hidden] {
    transform: translateX(-3px);
}

/* --- Layout & sheet ------------------------------------------------------ */
.docs-main {
    max-width: 1160px;
    margin: 0 auto;
    padding: 3rem 1.5rem 4rem;
    display: grid;
    grid-template-columns: 230px minmax(0, 1fr);
    gap: 3.5rem;
    align-items: start;
}

.docs-sidebar {
    position: sticky;
    top: 2rem;
    align-self: start;
    max-height: calc(100vh - 4rem);
    overflow-y: auto;
}

.docs-content-col {
    min-width: 0;
    max-width: 780px;
}

.docs-card.content {
    background: transparent;
    padding: 0;
}

/* --- Header of the sheet ------------------------------------------------- */
.docs-eyebrow {
    text-transform: uppercase;
    letter-spacing: 0.18em;
    font-size: 0.78rem;
    font-weight: 700;
    color: var(--docs-accent);
    margin-bottom: 0.5rem !important;
}

.docs-card.content h1.docs-title {
    color: var(--docs-ink);
    font-weight: 700;
    letter-spacing: -0.02em;
    margin-bottom: 1rem;
}

.docs-lead {
    font-size: 1.2rem;
    line-height: 1.6;
    color: var(--docs-ink-soft);
}

/* --- Typography ---------------------------------------------------------- */
.docs-card.content p,
.docs-card.content li {
    line-height: 1.75;
    color: var(--docs-ink);
}

.docs-card.content h2 {
    color: var(--docs-ink);
    font-weight: 700;
    font-size: 1.85rem;
    margin-top: 3.25rem;
    margin-bottom: 1.1rem;
    padding-bottom: 0.55rem;
    border-bottom: 1px solid var(--docs-border);
    scroll-margin-top: 1.5rem;
    position: relative;
}

.docs-card.content h2::after {
    content: "";
    position: absolute;
    left: 0;
    bottom: -1px;
    width: 3rem;
    height: 3px;
    border-radius: 3px;
    background: var(--docs-accent);
}

.docs-card.content h3 {
    color: var(--docs-accent-dark);
    font-weight: 600;
    font-size: 1.3rem;
    margin-top: 2.25rem;
    margin-bottom: 0.85rem;
    scroll-margin-top: 1.5rem;
}

.docs-card.content hr {
    background: var(--docs-border);
    height: 1px;
    margin: 2.5rem 0;
}

/* --- Links --------------------------------------------------------------- */
.docs-card.content a {
    color: var(--docs-accent-dark);
    text-decoration: underline;
    text-decoration-color: rgba(127, 90, 182, 0.35);
    text-underline-offset: 2px;
    transition: color 0.15s ease, text-decoration-color 0.15s ease;
}

.docs-card.content a:hover {
    color: var(--docs-accent-darker);
    text-decoration-color: var(--docs-accent-dark);
}

/* --- Inline code --------------------------------------------------------- */
.docs-card.content code {
    background: var(--docs-soft);
    color: var(--docs-accent-darker);
    padding: 0.15em 0.42em;
    border-radius: 6px;
    font-family: 'Monaco', 'Courier New', monospace;
    font-size: 0.85em;
    font-weight: 600;
}

/* --- Code blocks --------------------------------------------------------- */
.docs-card.content pre:not(.mermaid) {
    background: var(--docs-code-bg);
    color: var(--docs-code-ink);
    border: none;
    border-radius: 12px;
    padding: 1.15rem 1.35rem;
    margin: 1.25rem 0;
    overflow-x: auto;
    line-height: 1.65;
    box-shadow: 0 8px 24px rgba(43, 38, 64, 0.18);
}

.docs-card.content pre:not(.mermaid) code {
    background: transparent;
    color: inherit;
    padding: 0;
    font-weight: 400;
    font-size: 0.85rem;
}

/* --- Mermaid diagrams ---------------------------------------------------- */
.docs-card.content .mermaid {
    background: #ffffff;
    border: 1px solid var(--docs-border);
    border-radius: 14px;
    padding: 1.75rem 1rem;
    margin: 1.5rem 0;
    text-align: center;
    overflow-x: auto;
}

/* --- Table of contents --------------------------------------------------- */
.docs-toc {
    border-left: 2px solid var(--docs-border);
    padding: 0.25rem 0 0.25rem 1.25rem;
}

.docs-toc ul {
    margin: 0;
    list-style: none;
}

.docs-toc li {
    margin: 0.15rem 0;
}

.docs-toc a {
    display: block;
    padding: 0.3rem 0;
    text-decoration: none;
    font-weight: 500;
    font-size: 0.92rem;
    line-height: 1.35;
    color: var(--docs-ink-soft);
    transition: color 0.15s ease;
}

.docs-toc a:hover {
    color: var(--docs-accent-dark);
}

.docs-toc li.docs-toc-back {
    margin-bottom: 0.6rem;
    padding-bottom: 0.5rem;
    border-bottom: 1px solid var(--docs-border);
}

.docs-toc li.docs-toc-back a {
    color: var(--docs-accent-dark);
    font-weight: 600;
    display: inline-flex;
    align-items: center;
    gap: 0.4rem;
}

.docs-toc li.docs-toc-back a:hover {
    color: var(--docs-accent-darker);
}

.docs-toc li.docs-toc-back a span[aria-hidden] {
    transition: transform 0.15s ease;
}

.docs-toc li.docs-toc-back a:hover span[aria-hidden] {
    transform: translateX(-3px);
}

/* --- Tables -------------------------------------------------------------- */
.docs-card.content .table-container {
    margin: 1.5rem 0;
    border-radius: 12px;
    border: 1px solid var(--docs-border);
    overflow: hidden;
}

.docs-card.content table.table {
    margin-bottom: 0;
    border: none;
    background: transparent;
}

.docs-card.content table.table thead th {
    background: var(--docs-accent);
    color: #ffffff;
    border-color: var(--docs-accent);
    font-weight: 600;
    vertical-align: middle;
}

.docs-card.content table.table td,
.docs-card.content table.table th {
    border-color: var(--docs-border);
    vertical-align: middle;
}

.docs-card.content table.is-striped tbody tr:nth-child(even) {
    background: var(--docs-soft-2);
}

.docs-card.content table.table tbody tr:hover {
    background: var(--docs-soft);
}

/* --- Lists spacing ------------------------------------------------------- */
.docs-card.content ul,
.docs-card.content ol {
    margin-top: 0.85rem;
}

.docs-card.content li + li {
    margin-top: 0.35rem;
}

/* --- Footer -------------------------------------------------------------- */
.docs-footer {
    background: transparent;
    color: var(--docs-ink-soft);
}

/* --- Responsive ---------------------------------------------------------- */
@media screen and (max-width: 900px) {
    .docs-main {
        grid-template-columns: 1fr;
        gap: 1.75rem;
        padding: 1.5rem 1rem 3rem;
    }

    .docs-sidebar {
        position: static;
        max-height: none;
        overflow-y: visible;
    }

    .docs-content-col {
        max-width: none;
    }

    .docs-toc {
        border-left: none;
        border: 1px solid var(--docs-border);
        border-radius: 14px;
        padding: 1.1rem 1.4rem;
    }

    .docs-toc ul {
        columns: 2;
        column-gap: 1.5rem;
    }

    .docs-lead {
        font-size: 1.08rem;
    }

    .docs-card.content h2 {
        font-size: 1.5rem;
    }
}

@media screen and (max-width: 520px) {
    .docs-toc ul {
        columns: 1;
    }
}
