/* ========================================
   /doc/ — How Strom works (pages built by scripts/build-doc.mjs)
   Loaded after style.css, help.css and research.css (header, footer,
   language menu, sections). The site has one, light theme; so do these pages.
   After a change: run scripts/build-doc.mjs again (the pages carry this
   file's hash as ?v=).
   ======================================== */

.doc-page {
    color-scheme: light;
    background: var(--color-paper);
}

.doc-container {
    max-width: 1120px;
}

.doc-hero {
    padding-bottom: var(--space-xl);
}

.doc-hero .hero-title.doc-title-main {
    font-size: clamp(2rem, 4vw, 3rem);
    margin-bottom: 0;
    scroll-margin-top: var(--header-height);
}

.doc-title-main span.doc-chapter-num {
    display: inline;
    color: var(--color-sage);
}

.doc-crumbs {
    font-size: 0.875rem;
    color: var(--color-muted);
    margin-bottom: var(--space-md);
}

.doc-crumbs a {
    color: var(--color-moss);
    text-decoration: underline;
    text-underline-offset: 3px;
}

.doc-body {
    padding-top: 0;
}

/* ---------- Layout: the chapter's outline beside the text ---------- */

.doc-layout {
    display: grid;
    grid-template-columns: 260px minmax(0, 1fr);
    gap: var(--space-3xl);
    align-items: start;
}

.doc-toc {
    position: sticky;
    top: calc(var(--header-height) + var(--space-lg));
    max-height: calc(100vh - var(--header-height) - var(--space-2xl));
    overflow-y: auto;
    font-size: 0.875rem;
}

.doc-toc-box summary {
    font-size: 0.75rem;
    font-weight: 600;
    text-transform: uppercase;
    letter-spacing: 0.1em;
    color: var(--color-sage);
    cursor: pointer;
    margin-bottom: var(--space-sm);
}

.doc-toc-list {
    list-style: none;
    margin: 0;
    padding: 0;
}

.doc-toc-list a {
    display: block;
    padding: 5px 0 5px 10px;
    border-left: 2px solid var(--color-border);
    color: var(--color-ink);
    line-height: 1.35;
}

.doc-toc-list a:hover,
.doc-toc-list a.active {
    border-left-color: var(--color-sage);
    color: var(--color-forest);
}

.doc-toc-list .doc-toc-l3 a {
    padding-left: 24px;
    color: var(--color-muted);
}

.doc-toc-num {
    font-variant-numeric: tabular-nums;
    font-weight: 600;
    color: var(--color-sage);
    margin-right: 2px;
}

/* ---------- The text ---------- */

.doc-article,
.doc-readme {
    max-width: 760px;
    font-size: 1.0625rem;
    line-height: 1.7;
    color: var(--color-ink);
    overflow-wrap: break-word;
}

.doc-article p,
.doc-readme p,
.doc-article ul,
.doc-article ol,
.doc-readme ul,
.doc-readme ol {
    margin: 0 0 var(--space-md);
}

.doc-article ul,
.doc-article ol,
.doc-readme ul,
.doc-readme ol {
    padding-left: 1.4em;
}

.doc-article ul {
    list-style: disc;
}

.doc-article ol {
    list-style: decimal;
}

.doc-readme ul {
    list-style: none;
    padding-left: 0;
}

.doc-readme li {
    padding: 6px 0;
    border-bottom: 1px solid var(--color-border);
}

.doc-article li {
    margin-bottom: 6px;
}

/* A note in the text ("> **Note: …**" in strom-doc) */
.doc-note {
    margin: 0 0 var(--space-md);
    padding: var(--space-md) var(--space-lg);
    border-left: 3px solid var(--color-sage);
    border-radius: 0 var(--radius-sm) var(--radius-sm) 0;
    background: var(--color-cream);
}

.doc-note > :last-child {
    margin-bottom: 0;
}

.doc-note code {
    background: var(--color-paper);
}

.doc-article li > ul,
.doc-article li > ol {
    margin: 6px 0 0;
}

.doc-article a,
.doc-readme a {
    color: var(--color-moss);
    text-decoration: underline;
    text-decoration-color: var(--color-mint);
    text-underline-offset: 3px;
}

.doc-article a:hover,
.doc-readme a:hover {
    text-decoration-color: currentColor;
}

.doc-article code,
.doc-readme code {
    padding: 1px 5px;
    border-radius: var(--radius-sm);
    background: var(--color-cream);
    border: 1px solid var(--color-border);
    overflow-wrap: anywhere;
}

.doc-article strong {
    font-weight: 600;
}

/* Headings: the number (its own anchor) and a button for the short link */

.doc-article h2,
.doc-article h3,
.doc-readme h2 {
    font-family: var(--font-body);
    color: var(--color-forest);
    line-height: 1.3;
    scroll-margin-top: calc(var(--header-height) + var(--space-md));
}

.doc-article h2 {
    font-size: 1.375rem;
    font-weight: 600;
    margin: var(--space-2xl) 0 var(--space-md);
    padding-top: var(--space-lg);
    border-top: 1px solid var(--color-border);
}

.doc-article h3 {
    font-size: 1.125rem;
    font-weight: 600;
    margin: var(--space-xl) 0 var(--space-sm);
}

.doc-readme h2 {
    font-size: 1.25rem;
    font-weight: 600;
    margin: var(--space-xl) 0 var(--space-sm);
}

.doc-article .doc-num {
    color: var(--color-sage);
    text-decoration: none;
    font-variant-numeric: tabular-nums;
    margin-right: 4px;
}

.doc-article .doc-num:hover {
    text-decoration: underline;
}

.doc-copy {
    display: inline-flex;
    align-items: center;
    justify-content: center;
    width: 28px;
    height: 28px;
    margin-left: 4px;
    vertical-align: middle;
    border-radius: var(--radius-sm);
    color: var(--color-muted);
    opacity: 0.55;
    cursor: pointer;
    transition: opacity var(--transition-fast), background var(--transition-fast);
}

.doc-h:hover .doc-copy,
.doc-copy:focus-visible {
    opacity: 1;
}

.doc-copy:hover {
    background: var(--color-cream);
    color: var(--color-forest);
}

.doc-copy.copied {
    opacity: 1;
    color: var(--color-sage);
}

.doc-copied-note {
    margin-left: 6px;
    font-size: 0.8125rem;
    font-weight: 500;
    color: var(--color-sage);
    vertical-align: middle;
}

/* The target of a link stands out for a moment */
.doc-article :target {
    animation: doc-target 2s ease-out;
}

@keyframes doc-target {
    from { background: rgba(168, 213, 186, 0.45); }
    to { background: transparent; }
}

/* Tables scroll on their own on a narrow screen, not the page */
.doc-table {
    overflow-x: auto;
    margin: 0 0 var(--space-lg);
    border: 1px solid var(--color-border);
    border-radius: var(--radius-md);
}

.doc-table table {
    width: 100%;
    border-collapse: collapse;
    font-size: 0.9375rem;
    line-height: 1.5;
}

.doc-table th,
.doc-table td {
    padding: 8px 12px;
    text-align: left;
    vertical-align: top;
    border-bottom: 1px solid var(--color-border);
}

.doc-table th {
    background: var(--color-cream);
    font-weight: 600;
    color: var(--color-forest);
}

.doc-table tr:last-child td {
    border-bottom: 0;
}

/* Code in a cell stays whole ("entries", not "entrie|s"): the column takes
   its width, and a table wider than the screen scrolls inside its box. */
.doc-table code {
    white-space: nowrap;
    overflow-wrap: normal;
}

/* Previous / next chapter */
.doc-pager {
    display: grid;
    grid-template-columns: 1fr 1fr;
    gap: var(--space-md);
    margin-top: var(--space-3xl);
    padding-top: var(--space-lg);
    border-top: 1px solid var(--color-border);
}

.doc-article .doc-pager a {
    display: flex;
    flex-direction: column;
    gap: 2px;
    padding: var(--space-md);
    border: 1px solid var(--color-border);
    border-radius: var(--radius-md);
    text-decoration: none;
    color: var(--color-forest);
}

.doc-article .doc-pager a:hover {
    border-color: var(--color-sage);
}

.doc-pager-next {
    text-align: right;
    grid-column: 2;
}

.doc-pager-label {
    font-size: 0.8125rem;
    color: var(--color-muted);
}

.doc-pager-title {
    font-weight: 600;
}

/* Footer: the source and the license; the languages as words */
.doc-source a {
    text-decoration: underline;
    text-underline-offset: 3px;
}

.doc-page .footer-langs {
    display: flex;
    justify-content: center;
    flex-wrap: wrap;
    gap: 4px;
    font-size: 0.875rem;
}

.doc-page .footer-langs .lang-option {
    display: inline-block;
    width: auto;
    padding: 4px 8px;
    color: rgba(255, 255, 255, 0.75);
    background: none;
    border-radius: 0;
}

.doc-page .footer-langs .lang-option:hover {
    color: #fff;
    background: none;
}

.doc-page .footer-langs .lang-option.active {
    color: #fff;
    font-weight: 600;
    text-decoration: underline;
    text-underline-offset: 4px;
}

@media (min-width: 1025px) {
    .doc-page .footer .footer-bottom {
        flex-direction: row;
        justify-content: space-between;
        text-align: left;
    }
}

/* ---------- Narrow screens: the outline above the text, folded ---------- */

@media (max-width: 960px) {
    .doc-layout {
        grid-template-columns: minmax(0, 1fr);
        gap: var(--space-lg);
    }

    .doc-toc {
        position: static;
        max-height: none;
        padding: var(--space-md);
        border: 1px solid var(--color-border);
        border-radius: var(--radius-md);
        background: var(--color-cream);
    }

    .doc-toc-box summary {
        margin-bottom: 0;
    }

    .doc-toc-box[open] summary {
        margin-bottom: var(--space-sm);
    }
}

@media (max-width: 640px) {
    .doc-section,
    .doc-page .r-section {
        padding-left: 16px;
        padding-right: 16px;
    }

    .doc-article,
    .doc-readme {
        font-size: 1rem;
    }

    .doc-article h2 {
        font-size: 1.25rem;
    }

    .doc-pager {
        grid-template-columns: minmax(0, 1fr);
    }

    .doc-pager-next {
        grid-column: 1;
    }
}