/* =============================================================================
   nLight.fit Documentation Styles
   NOTE: Layered on top of landing.css - this file adds only what the docs need
   (sidebar, article typography, tables) and inherits every design token, the
   navbar and the button styles from the landing page so /docs looks native
   rather than bolted on.
   ============================================================================= */

/* -----------------------------------------------------------------------------
   Layout
   NOTE: .navbar is position:fixed in landing.css, so the grid needs top padding
   to clear it.
   ----------------------------------------------------------------------------- */
.docs-body {
    background: var(--color-bg);
}

.docs-layout {
    display: grid;
    grid-template-columns: 260px minmax(0, 1fr);
    gap: var(--space-2xl);
    max-width: var(--container-max);
    margin: 0 auto;
    padding: calc(72px + var(--space-2xl)) var(--space-lg) var(--space-4xl);
    align-items: start;
}

/* -----------------------------------------------------------------------------
   Sidebar
   ----------------------------------------------------------------------------- */
.docs-sidebar {
    position: sticky;
    top: calc(72px + var(--space-lg));
    max-height: calc(100vh - 96px);
    overflow-y: auto;
    padding-right: var(--space-md);
    border-right: 1px solid var(--color-border);
}

.docs-sidebar-group {
    margin-bottom: var(--space-xl);
}

.docs-sidebar-group h4 {
    font-size: 0.75rem;
    font-weight: 600;
    text-transform: uppercase;
    letter-spacing: 0.08em;
    color: var(--color-text-muted);
    margin-bottom: var(--space-sm);
}

.docs-sidebar-group ul {
    display: flex;
    flex-direction: column;
    gap: 2px;
}

.docs-sidebar-group a {
    display: block;
    padding: 6px var(--space-sm);
    border-radius: var(--radius-sm);
    font-size: 0.9375rem;
    color: var(--color-text-secondary);
    border-left: 2px solid transparent;
    transition: color var(--transition-fast), background var(--transition-fast);
}

.docs-sidebar-group a:hover {
    color: var(--color-text);
    background: var(--color-glass);
}

.docs-sidebar-group a.active {
    color: var(--color-primary);
    background: var(--color-primary-dim);
    border-left-color: var(--color-primary);
}

/* -----------------------------------------------------------------------------
   Main column
   NOTE: Two-column inside .docs-main so the "on this page" rail can sit beside
   the article without leaving a gap on pages that have too few headings for one.
   ----------------------------------------------------------------------------- */
.docs-main {
    display: grid;
    grid-template-columns: minmax(0, 1fr) auto;
    gap: var(--space-2xl);
    min-width: 0;
}

.docs-article {
    min-width: 0;
    max-width: 760px;
}

.docs-toc {
    position: sticky;
    top: calc(72px + var(--space-lg));
    width: 200px;
    max-height: calc(100vh - 96px);
    overflow-y: auto;
    font-size: 0.875rem;
}

.docs-toc h4 {
    font-size: 0.75rem;
    text-transform: uppercase;
    letter-spacing: 0.08em;
    color: var(--color-text-muted);
    margin-bottom: var(--space-sm);
}

.docs-toc ul {
    display: flex;
    flex-direction: column;
    gap: var(--space-xs);
}

.docs-toc a {
    color: var(--color-text-muted);
    transition: color var(--transition-fast);
}

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

/* -----------------------------------------------------------------------------
   Page metadata strip
   ----------------------------------------------------------------------------- */
.docs-meta {
    display: flex;
    flex-wrap: wrap;
    align-items: center;
    gap: var(--space-sm);
    margin-bottom: var(--space-xl);
    font-size: 0.8125rem;
}

.docs-badge {
    padding: 3px 10px;
    border-radius: var(--radius-full);
    background: var(--color-glass);
    border: 1px solid var(--color-border);
    color: var(--color-text-secondary);
    font-weight: 500;
}

/* NOTE: Visually distinct because it is a trust signal - it tells the reader
   this page cannot have drifted from the code. */
.docs-badge-generated {
    background: var(--color-primary-dim);
    border-color: rgba(57, 255, 20, 0.25);
    color: var(--color-primary);
}

.docs-updated {
    color: var(--color-text-muted);
}

.docs-raw {
    margin-left: auto;
    color: var(--color-secondary);
    font-family: var(--font-mono);
    font-size: 0.75rem;
}

.docs-raw:hover {
    text-decoration: underline;
}

/* -----------------------------------------------------------------------------
   Article typography
   ----------------------------------------------------------------------------- */
.docs-article h1 {
    font-size: 2.5rem;
    font-weight: 700;
    line-height: 1.15;
    letter-spacing: -0.02em;
    margin-bottom: var(--space-lg);
}

.docs-article h2 {
    font-size: 1.5rem;
    font-weight: 650;
    letter-spacing: -0.01em;
    margin: var(--space-2xl) 0 var(--space-md);
    padding-top: var(--space-md);
    border-top: 1px solid var(--color-border);
}

.docs-article h3 {
    font-size: 1.125rem;
    font-weight: 600;
    margin: var(--space-xl) 0 var(--space-sm);
    font-family: var(--font-mono);
    color: var(--color-primary);
}

.docs-article h4 {
    font-size: 1rem;
    font-weight: 600;
    margin: var(--space-lg) 0 var(--space-sm);
}

/* NOTE: Headings are wrapped in an anchor so the whole line is a permalink;
   it must not look like body-text link. */
.heading-anchor {
    color: inherit;
}

.heading-anchor:hover {
    color: var(--color-primary);
}

.docs-article p,
.docs-article li {
    color: var(--color-text-secondary);
    line-height: 1.75;
}

.docs-article p {
    margin-bottom: var(--space-md);
}

.docs-article strong {
    color: var(--color-text);
    font-weight: 600;
}

.docs-article a:not(.heading-anchor):not(.docs-raw) {
    color: var(--color-secondary);
    border-bottom: 1px solid rgba(0, 212, 255, 0.3);
}

.docs-article a:not(.heading-anchor):not(.docs-raw):hover {
    border-bottom-color: var(--color-secondary);
}

.docs-article ul,
.docs-article ol {
    margin: 0 0 var(--space-md) var(--space-lg);
    list-style: disc;
}

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

.docs-article li {
    margin-bottom: var(--space-xs);
}

.docs-article blockquote {
    margin: var(--space-lg) 0;
    padding: var(--space-md) var(--space-lg);
    border-left: 3px solid var(--color-primary);
    background: var(--color-glass);
    border-radius: 0 var(--radius-md) var(--radius-md) 0;
}

.docs-article blockquote p:last-child {
    margin-bottom: 0;
}

.docs-article hr {
    border: none;
    border-top: 1px solid var(--color-border);
    margin: var(--space-2xl) 0;
}

/* -----------------------------------------------------------------------------
   Code
   ----------------------------------------------------------------------------- */
.docs-article code {
    font-family: var(--font-mono);
    font-size: 0.8125em;
    padding: 2px 6px;
    border-radius: var(--radius-sm);
    background: var(--color-bg-card);
    border: 1px solid var(--color-border);
    color: var(--color-primary);
    /* NOTE: Only long unbroken strings in prose may wrap - an API token in a
       narrow column otherwise pushes the whole page sideways. */
    overflow-wrap: anywhere;
}

.docs-article pre {
    margin: 0 0 var(--space-lg);
    padding: var(--space-lg);
    border-radius: var(--radius-md);
    background: var(--color-bg-elevated);
    border: 1px solid var(--color-border);
    overflow-x: auto;
}

.docs-article pre code {
    padding: 0;
    border: none;
    background: none;
    color: var(--color-text-secondary);
    font-size: 0.8125rem;
    line-height: 1.7;
    word-break: normal;
}

/* -----------------------------------------------------------------------------
   Tables
   NOTE: Wrapped in horizontal scroll rather than shrunk - the generated tool
   and metric tables are wide by nature and truncating cells loses the content.
   ----------------------------------------------------------------------------- */
.docs-article table {
    width: 100%;
    margin-bottom: var(--space-lg);
    border-collapse: collapse;
    font-size: 0.875rem;
    display: block;
    overflow-x: auto;
}

.docs-article th {
    text-align: left;
    padding: var(--space-sm) var(--space-md);
    border-bottom: 1px solid var(--color-border-hover);
    color: var(--color-text);
    font-weight: 600;
    white-space: nowrap;
}

.docs-article td {
    padding: var(--space-sm) var(--space-md);
    border-bottom: 1px solid var(--color-border);
    color: var(--color-text-secondary);
    vertical-align: top;
}

/* NOTE: Identifiers in a table must never wrap mid-token - a tool name broken
   across two lines as "get_s / treak" is not copy-pasteable and reads as a
   different symbol. The table scrolls horizontally instead; prose cells still
   wrap normally, so only the identifier columns widen. */
.docs-article td code,
.docs-article th code {
    white-space: nowrap;
    overflow-wrap: normal;
}

.docs-article tr:last-child td {
    border-bottom: none;
}

/* -----------------------------------------------------------------------------
   Docs index page
   ----------------------------------------------------------------------------- */
.docs-lede {
    font-size: 1.125rem;
    color: var(--color-text-secondary);
    max-width: 65ch;
}

.docs-index-callout {
    margin: var(--space-xl) 0 var(--space-2xl);
    padding: var(--space-md) var(--space-lg);
    border: 1px solid var(--color-border);
    border-radius: var(--radius-md);
    background: var(--color-glass);
}

.docs-index-callout p {
    margin-bottom: 0;
    font-size: 0.9375rem;
}

.docs-index-group ul {
    display: grid;
    gap: var(--space-sm);
    margin: 0 0 var(--space-lg);
    list-style: none;
}

.docs-index-group a {
    display: block;
    padding: var(--space-md);
    border: 1px solid var(--color-border);
    border-radius: var(--radius-md);
    background: var(--color-bg-card);
    transition: border-color var(--transition-fast), background var(--transition-fast);
}

.docs-index-group a:hover {
    border-color: var(--color-border-hover);
    background: var(--color-bg-card-hover);
}

.docs-index-group a strong {
    display: block;
    color: var(--color-text);
    margin-bottom: 2px;
}

.docs-index-group a span {
    display: block;
    font-size: 0.875rem;
    color: var(--color-text-muted);
    line-height: 1.5;
}

/* NOTE: landing.css has btn-lg but no small variant; the docs navbar needs one. */
.btn-sm {
    padding: 0.5rem 1rem;
    font-size: 0.875rem;
}

/* -----------------------------------------------------------------------------
   Responsive
   NOTE: Below 1100px the "on this page" rail goes first, then the left sidebar
   collapses into a scrollable strip above the article.
   ----------------------------------------------------------------------------- */
@media (max-width: 1100px) {
    .docs-main {
        grid-template-columns: minmax(0, 1fr);
    }

    .docs-toc {
        display: none;
    }
}

@media (max-width: 860px) {
    .docs-layout {
        grid-template-columns: minmax(0, 1fr);
        gap: var(--space-lg);
        padding-top: calc(72px + var(--space-lg));
    }

    .docs-sidebar {
        position: static;
        max-height: none;
        padding: 0 0 var(--space-lg);
        border-right: none;
        border-bottom: 1px solid var(--color-border);
    }

    .docs-sidebar-group {
        margin-bottom: var(--space-lg);
    }

    .docs-article h1 {
        font-size: 2rem;
    }

    .docs-raw {
        margin-left: 0;
    }
}