/* ==========================================================================
   NexusForge Studio — documentation shell
   Persistent sidebar, article measure, optional right-hand table of contents,
   search dialog and the pager. Product pages reuse none of this: docs are
   information-dense by design, product pages are not.
   ========================================================================== */

.docs-shell {
    display: grid;
    grid-template-columns: var(--sidebar-w) minmax(0, 1fr);
    gap: var(--space-7);
    max-width: var(--page-max);
    margin-inline: auto;
    padding-inline: var(--gutter);
    align-items: start;
}

.docs-shell--with-toc {
    grid-template-columns: var(--sidebar-w) minmax(0, 1fr) var(--toc-w);
}

.docs-sidebar {
    position: sticky;
    top: var(--header-h);
    max-height: calc(100vh - var(--header-h));
    overflow-y: auto;
    overscroll-behavior: contain;
    padding-block: var(--space-6) var(--space-8);
    scrollbar-width: thin;
}

.docs-sidebar__header {
    display: flex;
    align-items: center;
    justify-content: space-between;
    gap: var(--space-3);
    margin-bottom: var(--space-5);
}

.docs-sidebar__title {
    font-family: var(--font-mono);
    font-size: 0.72rem;
    letter-spacing: 0.14em;
    text-transform: uppercase;
    color: var(--text-faint);
    margin: 0;
}

.docs-sidebar__version {
    display: inline-flex;
    align-items: center;
    gap: 0.35em;
    font-family: var(--font-mono);
    font-size: 0.7rem;
    color: var(--text-dim);
    border: 1px solid var(--border);
    border-radius: var(--radius-pill);
    padding: 0.15em 0.55em;
    text-decoration: none;
}

.docs-sidebar__version:hover {
    color: var(--text);
    border-color: var(--border-strong);
}

.docs-group {
    margin-bottom: var(--space-2);
    border-bottom: 1px solid var(--border);
}

.docs-group:last-child {
    border-bottom: 0;
}

.docs-group__toggle {
    display: flex;
    align-items: center;
    justify-content: space-between;
    gap: var(--space-3);
    width: 100%;
    background: none;
    border: 0;
    cursor: pointer;
    padding: var(--space-3) 0;
    color: var(--text-2);
    font-family: var(--font-mono);
    font-size: 0.72rem;
    font-weight: 500;
    letter-spacing: 0.12em;
    text-transform: uppercase;
    text-align: left;
}

.docs-group__toggle:hover {
    color: var(--text);
}

.docs-group__chevron {
    width: 10px;
    height: 10px;
    flex-shrink: 0;
    transition: transform var(--dur-2) var(--ease);
    color: var(--text-faint);
}

.docs-group[data-open='false'] .docs-group__chevron {
    transform: rotate(-90deg);
}

.docs-group__list {
    list-style: none;
    margin: 0;
    padding: 0 0 var(--space-3);
    display: grid;
    gap: 1px;
}

.docs-group[data-open='false'] .docs-group__list {
    display: none;
}

.docs-group__list li {
    margin: 0;
}

.docs-link {
    display: flex;
    align-items: center;
    justify-content: space-between;
    gap: var(--space-2);
    padding: 0.32rem 0.6rem;
    border-radius: var(--radius-sm);
    border-left: 2px solid transparent;
    color: var(--text-dim);
    text-decoration: none;
    font-size: var(--step--1);
    line-height: 1.4;
}

.docs-link:hover {
    color: var(--text);
    background: var(--surface-2);
}

.docs-link[aria-current='page'] {
    color: var(--accent-strong);
    background: var(--surface-2);
    border-left-color: var(--accent-strong);
}

.docs-link__status {
    font-family: var(--font-mono);
    font-size: 0.6rem;
    letter-spacing: 0.08em;
    text-transform: uppercase;
    color: var(--text-faint);
    border: 1px solid var(--border);
    border-radius: var(--radius-pill);
    padding: 0 0.4em;
    flex-shrink: 0;
}

.docs-link__status--roadmap {
    color: var(--status-roadmap);
    border-color: var(--status-roadmap);
}

.docs-link__status--adapter {
    color: var(--status-adapter);
    border-color: var(--status-adapter);
}

.docs-link__status--not-verified {
    color: var(--status-notverified);
    border-color: var(--border-strong);
}

.docs-sidebar__footer {
    margin-top: var(--space-5);
    padding-top: var(--space-4);
    border-top: 1px solid var(--border);
    font-size: var(--step--1);
    color: var(--text-faint);
    line-height: 1.6;
}

.docs-sidebar__footer a {
    color: var(--text-dim);
}

/* Article ---------------------------------------------------------------- */

.docs-main {
    min-width: 0;
    padding-block: var(--space-6) var(--space-8);
}

.docs-article {
    max-width: var(--prose-max);
}

.docs-breadcrumbs {
    margin-bottom: var(--space-5);
}

.docs-breadcrumbs ol {
    display: flex;
    flex-wrap: wrap;
    align-items: center;
    gap: 0.35rem;
    list-style: none;
    margin: 0;
    padding: 0;
    font-family: var(--font-mono);
    font-size: 0.7rem;
    letter-spacing: 0.06em;
    color: var(--text-faint);
}

.docs-breadcrumbs li {
    margin: 0;
    display: inline-flex;
    align-items: center;
    gap: 0.35rem;
}

.docs-breadcrumbs li + li::before {
    content: '/';
    color: var(--text-faint);
}

.docs-breadcrumbs a {
    color: var(--text-dim);
    text-decoration: none;
}

.docs-breadcrumbs a:hover {
    color: var(--text);
    text-decoration: underline;
}

.docs-title {
    font-size: var(--step-4);
    margin-bottom: var(--space-3);
}

.docs-lede {
    font-size: var(--step-1);
    color: var(--text-2);
    margin-bottom: var(--space-5);
    max-width: 68ch;
}

.docs-meta {
    display: flex;
    flex-wrap: wrap;
    align-items: center;
    gap: var(--space-2) var(--space-4);
    padding-block: var(--space-3);
    margin-bottom: var(--space-5);
    border-block: 1px solid var(--border);
    font-family: var(--font-mono);
    font-size: 0.7rem;
    letter-spacing: 0.06em;
    text-transform: uppercase;
    color: var(--text-faint);
}

.docs-meta > span {
    display: inline-flex;
    align-items: center;
    gap: 0.4em;
}

/* Article prose ---------------------------------------------------------- */

.prose h2 {
    font-size: var(--step-3);
    margin-top: var(--space-7);
    margin-bottom: var(--space-3);
    padding-top: var(--space-2);
}

.prose h3 {
    font-size: var(--step-2);
    margin-top: var(--space-6);
    margin-bottom: var(--space-3);
}

.prose h4 {
    font-size: var(--step-1);
    margin-top: var(--space-5);
    margin-bottom: var(--space-2);
    color: var(--text-2);
}

.prose ul,
.prose ol {
    padding-left: 1.4em;
}

.prose ul li::marker {
    color: var(--text-faint);
}

.prose ol {
    counter-reset: step;
    list-style: none;
    padding-left: 0;
}

.prose ol > li {
    position: relative;
    padding-left: 2.4em;
    margin-bottom: var(--space-3);
    counter-increment: step;
}

.prose ol > li::before {
    content: counter(step);
    position: absolute;
    left: 0;
    top: 0.15em;
    width: 1.6em;
    height: 1.6em;
    display: grid;
    place-items: center;
    font-family: var(--font-mono);
    font-size: 0.72rem;
    color: var(--accent);
    background: var(--surface-2);
    border: 1px solid var(--border-strong);
    border-radius: 50%;
}

.prose blockquote {
    border-left: 2px solid var(--border-strong);
    padding-left: var(--space-4);
    color: var(--text-2);
}

.prose figure {
    margin-block: var(--space-5);
}

.prose figcaption {
    font-size: var(--step--1);
    color: var(--text-faint);
    margin-top: var(--space-2);
}

.prose .anchor {
    color: var(--text-faint);
    text-decoration: none;
    margin-left: 0.4em;
    opacity: 0;
    transition: opacity var(--dur-1) var(--ease);
}

.prose h2:hover .anchor,
.prose h3:hover .anchor,
.prose h2:focus-within .anchor,
.prose h3:focus-within .anchor {
    opacity: 1;
}

/* At a glance ------------------------------------------------------------ */

.glance {
    border: 1px solid var(--border);
    border-radius: var(--radius-lg);
    background: var(--surface);
    padding: var(--space-4) var(--space-5);
    margin-block: var(--space-5);
}

.glance__title {
    font-family: var(--font-mono);
    font-size: 0.7rem;
    letter-spacing: 0.12em;
    text-transform: uppercase;
    color: var(--text-faint);
    margin-bottom: var(--space-3);
}

.glance dl {
    display: grid;
    grid-template-columns: auto 1fr;
    gap: var(--space-2) var(--space-5);
    margin: 0;
    font-size: var(--step--1);
}

.glance dt {
    font-family: var(--font-mono);
    font-size: 0.72rem;
    color: var(--text-dim);
    white-space: nowrap;
}

.glance dd {
    margin: 0;
    color: var(--text);
}

/* Table of contents ------------------------------------------------------ */

.docs-toc {
    position: sticky;
    top: var(--header-h);
    max-height: calc(100vh - var(--header-h));
    overflow-y: auto;
    padding-block: var(--space-6);
    font-size: var(--step--1);
    scrollbar-width: thin;
}

.docs-toc__title {
    font-family: var(--font-mono);
    font-size: 0.7rem;
    letter-spacing: 0.12em;
    text-transform: uppercase;
    color: var(--text-faint);
    margin-bottom: var(--space-3);
}

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

.docs-toc li {
    margin: 0;
}

.docs-toc a {
    display: block;
    padding: 0.25rem 0 0.25rem var(--space-3);
    margin-left: -1px;
    border-left: 2px solid transparent;
    color: var(--text-dim);
    text-decoration: none;
    line-height: 1.45;
}

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

.docs-toc a[aria-current='true'] {
    color: var(--accent-strong);
    border-left-color: var(--accent-strong);
}

.docs-toc ul ul a {
    padding-left: var(--space-5);
    font-size: 0.82rem;
    color: var(--text-faint);
}

/* Pager ------------------------------------------------------------------ */

.docs-pager {
    display: grid;
    grid-template-columns: repeat(auto-fit, minmax(220px, 1fr));
    gap: var(--space-4);
    margin-top: var(--space-8);
    max-width: var(--prose-max);
}

.docs-pager__link {
    display: flex;
    flex-direction: column;
    gap: var(--space-1);
    padding: var(--space-4) var(--space-5);
    border: 1px solid var(--border);
    border-radius: var(--radius-lg);
    background: var(--surface);
    text-decoration: none;
    transition: border-color var(--dur-2) var(--ease), background var(--dur-2) var(--ease);
}

.docs-pager__link:hover {
    border-color: var(--border-strong);
    background: var(--surface-2);
}

.docs-pager__link--next {
    text-align: right;
    align-items: flex-end;
}

.docs-pager__dir {
    font-family: var(--font-mono);
    font-size: 0.68rem;
    letter-spacing: 0.12em;
    text-transform: uppercase;
    color: var(--text-faint);
}

.docs-pager__name {
    color: var(--text);
    font-weight: 500;
}

.docs-feedback {
    margin-top: var(--space-6);
    max-width: var(--prose-max);
    border-top: 1px solid var(--border);
    padding-top: var(--space-5);
    font-size: var(--step--1);
    color: var(--text-dim);
}

.docs-feedback p {
    margin-bottom: var(--space-2);
}

/* Search ----------------------------------------------------------------- */

.search-root {
    display: inline-flex;
}

.search-trigger {
    display: inline-flex;
    align-items: center;
    gap: var(--space-2);
    background: var(--surface);
    border: 1px solid var(--border);
    border-radius: var(--radius);
    color: var(--text-dim);
    padding: 0.42rem 0.7rem;
    cursor: pointer;
    font-size: var(--step--1);
    min-width: 190px;
    transition: color var(--dur-1) var(--ease), border-color var(--dur-1) var(--ease);
}

.search-trigger:hover {
    color: var(--text);
    border-color: var(--border-strong);
}

.search-trigger kbd {
    margin-left: auto;
}

.search-dialog {
    position: fixed;
    inset: 0;
    z-index: var(--z-search);
    display: none;
}

.search-dialog[open] {
    display: block;
}

.search-dialog__backdrop {
    position: absolute;
    inset: 0;
    background: rgba(4, 5, 7, 0.72);
    border: 0;
    cursor: pointer;
}

.search-panel {
    position: relative;
    max-width: 660px;
    margin: 8vh auto 0;
    background: var(--surface-2);
    border: 1px solid var(--border-strong);
    border-radius: var(--radius-lg);
    box-shadow: var(--shadow-3);
    overflow: hidden;
    display: flex;
    flex-direction: column;
    max-height: 78vh;
}

.search-field {
    display: flex;
    align-items: center;
    gap: var(--space-3);
    padding: var(--space-4) var(--space-5);
    border-bottom: 1px solid var(--border);
}

.search-field input {
    flex: 1;
    background: none;
    border: 0;
    color: var(--text);
    font-size: var(--step-1);
    font-family: inherit;
    outline: none;
}

.search-field input::placeholder {
    color: var(--text-faint);
}

.search-results {
    list-style: none;
    margin: 0;
    padding: var(--space-2);
    overflow-y: auto;
}

.search-results li {
    margin: 0;
}

.search-result {
    display: block;
    padding: var(--space-3) var(--space-4);
    border-radius: var(--radius);
    text-decoration: none;
    color: var(--text);
}

.search-result:hover,
.search-result[aria-selected='true'] {
    background: var(--surface-3);
}

.search-result__title {
    display: flex;
    align-items: center;
    gap: var(--space-3);
    justify-content: space-between;
    font-weight: 500;
}

.search-result__section {
    font-family: var(--font-mono);
    font-size: 0.66rem;
    letter-spacing: 0.1em;
    text-transform: uppercase;
    color: var(--text-faint);
}

.search-result__excerpt {
    display: block;
    font-size: var(--step--1);
    color: var(--text-dim);
    margin-top: 0.25rem;
}

.search-result mark {
    background: var(--accent-tint);
    color: var(--accent-strong);
    border-radius: 2px;
    padding: 0 0.15em;
}

.search-empty {
    padding: var(--space-5);
    color: var(--text-dim);
    font-size: var(--step--1);
}

.search-hint {
    padding: var(--space-3) var(--space-5);
    border-top: 1px solid var(--border);
    color: var(--text-faint);
    font-size: 0.7rem;
    font-family: var(--font-mono);
    display: flex;
    gap: var(--space-4);
    flex-wrap: wrap;
}

/* Docs toolbar (mobile) -------------------------------------------------- */

.docs-toolbar {
    display: none;
    align-items: center;
    gap: var(--space-2);
    border-bottom: 1px solid var(--border);
    background: var(--surface);
    padding: var(--space-2) var(--gutter);
    position: sticky;
    top: var(--header-h);
    z-index: calc(var(--z-header) - 1);
}

.docs-toolbar__button {
    display: inline-flex;
    align-items: center;
    gap: var(--space-2);
    font-family: var(--font-mono);
    font-size: 0.72rem;
    letter-spacing: 0.08em;
    text-transform: uppercase;
    color: var(--text-dim);
    background: var(--surface-2);
    border: 1px solid var(--border);
    border-radius: var(--radius);
    padding: 0.4rem 0.7rem;
    cursor: pointer;
}

.docs-toolbar__button:hover {
    color: var(--text);
    border-color: var(--border-strong);
}

.sidebar-scrim {
    display: none;
}

/* Responsive ------------------------------------------------------------- */

@media (max-width: 1180px) {
    .docs-shell--with-toc {
        grid-template-columns: var(--sidebar-w) minmax(0, 1fr);
    }

    .docs-toc {
        display: none;
    }
}

@media (max-width: 980px) {
    .nav-toggle {
        display: inline-flex;
    }

    .site-nav__list {
        position: fixed;
        inset: var(--header-h) 0 auto 0;
        flex-direction: column;
        align-items: stretch;
        gap: 0;
        background: var(--surface);
        border-bottom: 1px solid var(--border);
        box-shadow: var(--shadow-2);
        padding: var(--space-3) var(--gutter) var(--space-5);
        display: none;
        max-height: calc(100vh - var(--header-h));
        overflow-y: auto;
    }

    .site-nav__list[data-open='true'] {
        display: flex;
    }

    .site-nav__item {
        width: 100%;
    }

    .site-nav__link,
    .site-nav__button {
        width: 100%;
        justify-content: space-between;
        padding: 0.7rem 0.5rem;
        border-radius: var(--radius-sm);
        font-size: 0.82rem;
    }

    .site-nav__menu {
        position: static;
        display: block;
        border: 0;
        box-shadow: none;
        background: transparent;
        padding: 0 0 var(--space-3) var(--space-3);
        min-width: 0;
    }

    .search-trigger {
        min-width: 0;
    }

    .search-trigger__label,
    .search-trigger kbd {
        display: none;
    }

    .docs-shell,
    .docs-shell--with-toc {
        grid-template-columns: minmax(0, 1fr);
        gap: 0;
    }

    .docs-toolbar {
        display: flex;
    }

    .docs-sidebar {
        position: fixed;
        top: var(--header-h);
        left: 0;
        bottom: 0;
        width: min(86vw, 340px);
        max-height: none;
        background: var(--bg-alt);
        border-right: 1px solid var(--border-strong);
        box-shadow: var(--shadow-3);
        padding: var(--space-5) var(--space-5) var(--space-8);
        z-index: var(--z-drawer);
        transform: translateX(-102%);
        transition: transform var(--dur-3) var(--ease);
    }

    .docs-sidebar[data-open='true'] {
        transform: translateX(0);
    }

    .sidebar-scrim {
        display: none;
        position: fixed;
        inset: var(--header-h) 0 0 0;
        background: rgba(4, 5, 7, 0.6);
        border: 0;
        z-index: calc(var(--z-drawer) - 1);
    }

    .sidebar-scrim[data-open='true'] {
        display: block;
    }

    .docs-main {
        padding-block: var(--space-5) var(--space-7);
    }
}

@media (max-width: 760px) {
    /* Below this width the measure is the viewport, not a comfortable column. */
    .docs-article {
        max-width: none;
    }
}

@media (max-width: 640px) {
    :root {
        --header-h: 58px;
    }

    .brand__text {
        font-size: 0.8rem;
        letter-spacing: 0.1em;
    }

    .btn {
        width: 100%;
    }

    .btn-row {
        flex-direction: column;
    }

    .code pre {
        font-size: 0.78rem;
        padding: var(--space-3) var(--space-4);
    }

    .docs-pager__link--next {
        text-align: left;
        align-items: flex-start;
    }

    .grid--2,
    .grid--3,
    .grid--4 {
        grid-template-columns: minmax(0, 1fr);
    }

    .kv__row {
        grid-template-columns: minmax(0, 1fr);
        gap: var(--space-1);
    }

    .glance dl {
        grid-template-columns: minmax(0, 1fr);
        gap: var(--space-1) 0;
    }

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