/* ── Documentation — sidebar reference under /reference/documentation/.
   Reuses home.css tokens only: --ink/-2/-3, --paper/-2, --line,
   --accent/--accent-ink, --ok, --display/--body/--mono. One accent.

   Numbered sections, one page each. The sidebar is the same on every page
   so the reader keeps their place in the whole set. Topics inside a section
   are not numbered — they get added over time. ── */

/* ── shell ─────────────────────────────────────────── */
.doc-wrap {
    max-width: 1280px;
    margin: 0 auto;
    padding: 0 32px;
    display: grid;
    grid-template-columns: 244px minmax(0, 1fr);
    gap: 0 60px;
    align-items: start;
}

/* ── sidebar ───────────────────────────────────────── */
.doc-side {
    position: sticky;
    top: 60px;                       /* clears the site nav */
    max-height: calc(100vh - 60px);
    overflow-y: auto;
    padding: 34px 0 60px;
    border-right: 1px solid var(--line);
    margin-right: -1px;
    scrollbar-width: thin;
}
.doc-side::-webkit-scrollbar { width: 6px; }
.doc-side::-webkit-scrollbar-thumb { background: var(--line); border-radius: 3px; }

.doc-side-title {
    font-family: var(--mono);
    font-size: 0.7rem;
    letter-spacing: 0.14em;
    text-transform: uppercase;
    color: var(--ink-3);
    padding-right: 24px;
    margin-bottom: 18px;
}

.doc-part { margin-bottom: 22px; padding-right: 24px; }
.doc-part-name {
    display: flex;
    align-items: baseline;
    gap: 8px;
    font-family: var(--display);
    font-size: 0.82rem;
    font-weight: 600;
    color: var(--ink);
    margin-bottom: 7px;
}
.doc-part-num {
    flex: none;
    min-width: 1.1em;
    font-family: var(--mono);
    font-size: 0.72rem;
    font-weight: 500;
    color: var(--ink-3);
}
.doc-part.is-current .doc-part-name { color: var(--accent-ink); }
.doc-part.is-current .doc-part-num { color: var(--accent); }

.doc-part ul { list-style: none; padding-left: 1.15em; }
.doc-part li { margin: 0; }
.doc-part li a {
    display: block;
    padding: 4px 0 4px 2px;
    font-size: 0.82rem;
    line-height: 1.45;
    color: var(--ink-3);
    border-left: 2px solid transparent;
    padding-left: 10px;
    margin-left: -12px;
    transition: color 0.15s ease, border-color 0.15s ease;
}
.doc-part li a:hover { color: var(--ink); }
.doc-part li a.is-active {
    color: var(--ink);
    font-weight: 500;
    border-left-color: var(--accent);
}

/* mobile control — hidden on desktop */
.doc-side-toggle { display: none; }

/* ── content column ────────────────────────────────── */
.doc-main { padding: 34px 0 96px; min-width: 0; }

.doc-head { padding-bottom: 26px; border-bottom: 1px solid var(--line); }
.doc-head .kicker { margin-bottom: 12px; }
.doc-head h1 {
    font-size: clamp(1.9rem, 3.4vw, 2.6rem);
    line-height: 1.1;
    max-width: 17em;
}
.doc-head .lead { margin-top: 14px; font-size: 1rem; }

/* ── a topic ───────────────────────────────────────── */
.topic {
    padding-top: 46px;
    scroll-margin-top: 76px;         /* anchor lands below the sticky nav */
}
.topic + .topic { border-top: 1px solid var(--line); margin-top: 46px; }

.topic h2 {
    font-size: 1.5rem;
    line-height: 1.2;
    font-weight: 600;
    max-width: 20em;
}
.topic h3 {
    font-size: 1rem;
    font-weight: 600;
    margin-top: 30px;
    margin-bottom: 8px;
}
.topic p { max-width: 44em; margin-top: 13px; color: var(--ink-2); }
.topic p strong { color: var(--ink); font-weight: 600; }
.topic p a, .topic li a { color: var(--accent-ink); text-decoration: underline; text-underline-offset: 2px; }
.topic p a:hover, .topic li a:hover { color: var(--ink); }

.topic ul, .topic ol { max-width: 44em; margin-top: 13px; padding-left: 20px; }
.topic li { margin-top: 6px; color: var(--ink-2); }
.topic li strong { color: var(--ink); font-weight: 600; }

code, .doc-main code {
    font-family: var(--mono);
    font-size: 0.86em;
    background: var(--paper-2);
    border: 1px solid var(--line);
    border-radius: 4px;
    padding: 1px 5px;
    color: var(--ink);
    white-space: nowrap;
}

/* ── figure ────────────────────────────────────────── */
.fig { margin-top: 22px; max-width: 100%; }
.fig img {
    display: block;
    width: 100%;
    height: auto;
    border: 1px solid var(--line);
    border-radius: 10px;
    background: #11151b;
    box-shadow: 0 1px 2px rgba(14, 17, 22, 0.04), 0 12px 30px -14px rgba(14, 17, 22, 0.2);
}
/* a panel shot rather than a full window — shown at its own width */
.fig-narrow { max-width: 320px; }

.fig figcaption {
    margin-top: 9px;
    font-size: 0.83rem;
    color: var(--ink-3);
    max-width: 44em;
}

/* ── a definition table: field / meaning ───────────── */
.doc-table { margin-top: 20px; overflow-x: auto; }
.doc-table table { border-collapse: collapse; width: 100%; min-width: 460px; }
.doc-table th, .doc-table td {
    text-align: left;
    vertical-align: top;
    padding: 9px 16px 9px 0;
    border-bottom: 1px solid var(--line);
    font-size: 0.88rem;
}
.doc-table th {
    font-family: var(--mono);
    font-size: 0.68rem;
    letter-spacing: 0.12em;
    text-transform: uppercase;
    color: var(--ink-3);
    font-weight: 500;
    border-bottom-color: var(--ink-3);
}
.doc-table td:first-child {
    font-family: var(--mono);
    font-size: 0.8rem;
    color: var(--ink);
    white-space: nowrap;
    padding-right: 24px;
}
.doc-table td { color: var(--ink-2); }
.doc-table td:first-child.wrapcell { white-space: normal; }

/* ── callout — one rule the product holds itself to ── */
.note {
    margin-top: 20px;
    max-width: 44em;
    padding: 14px 18px;
    background: var(--paper-2);
    border: 1px solid var(--line);
    border-left: 2px solid var(--accent);
    border-radius: 0 8px 8px 0;
}
.note p { margin-top: 0; font-size: 0.92rem; }
.note p + p { margin-top: 10px; }
.note-label {
    font-family: var(--mono);
    font-size: 0.66rem;
    letter-spacing: 0.13em;
    text-transform: uppercase;
    color: var(--ink-3);
    margin-bottom: 6px;
}

/* ── in-page link out to a demo chapter ────────────── */
.seealso {
    display: inline-flex;
    align-items: center;
    gap: 8px;
    margin-top: 18px;
    font-family: var(--mono);
    font-size: 0.74rem;
    letter-spacing: 0.06em;
    color: var(--ink-3);
    border-bottom: 1px solid var(--line);
    padding-bottom: 3px;
    transition: color 0.15s ease, border-color 0.15s ease;
}
.seealso:hover { color: var(--ink); border-bottom-color: var(--ink-3); }
.seealso::before { content: "▸"; color: var(--accent); }

/* ── availability marker on a catalog row ──────────── */
.tag {
    display: inline-block;
    margin-left: 8px;
    padding: 1px 6px;
    border: 1px solid var(--line);
    border-radius: 4px;
    background: var(--paper-2);
    font-family: var(--mono);
    font-size: 0.62rem;
    letter-spacing: 0.07em;
    text-transform: uppercase;
    color: var(--ink-3);
    vertical-align: 1px;
    white-space: nowrap;
}

/* catalog tables: the option name wraps rather than forcing the column wide */
.doc-table.catalog td:first-child { white-space: normal; min-width: 13em; }
.doc-table.catalog table { min-width: 380px; }

/* ── prev / next ───────────────────────────────────── */
.doc-nav {
    display: flex;
    gap: 16px;
    margin-top: 64px;
    padding-top: 26px;
    border-top: 1px solid var(--line);
}
.doc-nav a {
    flex: 1 1 0;
    min-width: 0;
    padding: 14px 18px;
    border: 1px solid var(--line);
    border-radius: 10px;
    transition: border-color 0.15s ease;
}
.doc-nav a:hover { border-color: var(--ink-3); }
.doc-nav .dir {
    font-family: var(--mono);
    font-size: 0.68rem;
    letter-spacing: 0.12em;
    text-transform: uppercase;
    color: var(--ink-3);
}
.doc-nav .name {
    display: block;
    margin-top: 4px;
    font-family: var(--display);
    font-weight: 600;
    font-size: 0.95rem;
    color: var(--ink);
}
.doc-nav .next { text-align: right; }
.doc-nav .spacer { flex: 1 1 0; }

/* ── narrow ────────────────────────────────────────── */
@media (max-width: 900px) {
    .doc-wrap { grid-template-columns: minmax(0, 1fr); gap: 0; padding: 0 22px; }

    .doc-side {
        position: static;
        max-height: none;
        overflow: visible;
        border-right: 0;
        border-bottom: 1px solid var(--line);
        margin-right: 0;
        padding: 20px 0;
    }
    /* collapsed by default on a phone; the toggle opens it */
    .doc-side-title { display: none; }
    .doc-side-toggle {
        display: flex;
        align-items: center;
        justify-content: space-between;
        width: 100%;
        padding: 0;
        background: none;
        border: 0;
        cursor: pointer;
        font-family: var(--mono);
        font-size: 0.72rem;
        letter-spacing: 0.12em;
        text-transform: uppercase;
        color: var(--ink-3);
    }
    .doc-side-toggle::after { content: "+"; font-size: 1rem; }
    .doc-side.is-open .doc-side-toggle::after { content: "–"; }
    .doc-side-list { display: none; margin-top: 18px; }
    .doc-side.is-open .doc-side-list { display: block; }

    .doc-main { padding: 26px 0 72px; }
    .topic { padding-top: 36px; }
    .topic + .topic { margin-top: 36px; }
    .doc-nav { flex-direction: column; }
    .doc-nav .next { text-align: left; }
    .doc-nav .spacer { display: none; }
}