/* ════════════════════════════════════════════════════════════
   NARRADIVE — Documentation (CommandPocket)
   3-column docs shell + markdown typography. Built on core tokens.
   ════════════════════════════════════════════════════════════ */

:root {
    --docs-sidebar: 286px;
    --docs-toc: 232px;
    --docs-gap: 2.6rem;
    --docs-top: calc(var(--nav-h) + 3rem);            /* sticky offset — clears the collapsed header mark */
    --docs-pad-top: calc(var(--nav-h) + 5.5rem);      /* initial padding — clears the overflowing header logo */
    --code-bg: #11131b;
}

/* The docs page = CommandPocket sub-brand, same accent as tools.html. Tokens are
   SCOPED to .docs-page; core.css :root stays untouched. Re-pointing --teal /
   --teal-bright here means every existing var(--teal) in this file automatically
   reads as CommandPocket orange (sampled from the marketing art = #F86838). */
.docs-page {
    --cp-accent: #f86838;
    --cp-accent-bright: #ff8a5c;
    --cp-accent-2: #ffa270;
    --cp-accent-soft: rgba(248, 104, 56, 0.10);
    --cp-accent-line: rgba(248, 104, 56, 0.30);
    --teal: var(--cp-accent);
    --teal-bright: var(--cp-accent-bright);
    /* Sub-brand type: CommandPocket docs are fully Inter (headings + body),
       matching the product art. The rest of the site uses Aladin/Amarante; here
       we pin display, hero AND body back to Inter. Header nav uses --font-caps. */
    --font-display: var(--font-cp);
    --font-hero: var(--font-cp);
    --font-body: var(--font-cp);
}

body.docs-page { overflow-x: hidden; }

/* ═══ SHELL ═══ */
.docs-shell {
    max-width: 1400px;
    margin: 0 auto;
    padding: var(--docs-pad-top) var(--s-3) var(--s-6);
    display: grid;
    grid-template-columns: var(--docs-sidebar) minmax(0, 1fr) var(--docs-toc);
    gap: var(--docs-gap);
    align-items: start;
}

/* ─── Mobile sidebar trigger ─── */
.docs-mobilebar {
    display: none;
    position: sticky;
    top: calc(var(--nav-h) + 0.7rem);
    z-index: 40;
    align-items: center;
    justify-content: center;
    width: 44px;
    height: 44px;
    padding: 0;
    margin-bottom: 0.6rem;
    background: rgba(10, 11, 16, 0.9);
    backdrop-filter: blur(8px);
    -webkit-backdrop-filter: blur(8px);
    border: 1px solid var(--line);
    border-radius: var(--radius);
    color: var(--teal);
}
.docs-mobilebar span { display: none; }
.docs-mobilebar svg { width: 20px; height: 20px; color: var(--teal); }

/* ═══ SIDEBAR ═══ */
.docs-sidebar {
    position: sticky;
    top: var(--docs-top);
    max-height: calc(100vh - var(--docs-top) - 1rem);
    overflow-y: auto;
    overflow-x: hidden;
    padding-right: 0.6rem;
    scrollbar-width: thin;
    scrollbar-color: var(--line-strong) transparent;
}
.docs-sidebar::-webkit-scrollbar { width: 7px; }
.docs-sidebar::-webkit-scrollbar-thumb { background: var(--line-strong); border-radius: 99px; }

/* Brand lockup (sidebar header) */
.docs-brand {
    display: flex;
    align-items: center;
    gap: 0.6rem;
    margin-bottom: var(--s-3);
    padding: 0.5rem 0.2rem 0.9rem;
    border-bottom: 1px solid var(--line);
}
.docs-brand-ico {
    width: 30px;
    height: 30px;
    flex: 0 0 auto;
    border-radius: 7px;
}
.docs-brand-name {
    font-family: var(--font-display);
    font-weight: 700;
    font-size: 1.05rem;
    letter-spacing: -0.01em;
    color: var(--text);
    transition: color 0.18s var(--ease);
}
.docs-brand:hover .docs-brand-name { color: var(--teal-bright); }

/* Search */
.docs-search {
    position: relative;
    margin-bottom: var(--s-3);
}
.docs-search-input {
    width: 100%;
    font-family: var(--font-body);
    font-size: 0.92rem;
    color: var(--text);
    background: var(--panel);
    border: 1px solid var(--line-strong);
    border-radius: var(--radius);
    padding: 0.7rem 2.6rem 0.7rem 2.4rem;
    transition: border-color 0.2s var(--ease), background 0.2s var(--ease);
}
.docs-search-input::placeholder { color: var(--muted); }
.docs-search-input:focus {
    outline: none;
    border-color: var(--teal);
    background: var(--panel-2);
}
.docs-search-ico {
    position: absolute;
    left: 0.8rem; top: 50%;
    transform: translateY(-50%);
    width: 16px; height: 16px;
    color: var(--muted);
    pointer-events: none;
}
.docs-search-kbd {
    position: absolute;
    right: 0.65rem; top: 50%;
    transform: translateY(-50%);
    font-family: var(--font-body);
    font-size: 0.66rem;
    font-weight: 600;
    letter-spacing: 0.04em;
    color: var(--muted);
    background: rgba(255, 255, 255, 0.05);
    border: 1px solid var(--line);
    border-radius: 5px;
    padding: 0.12rem 0.4rem;
    pointer-events: none;
}

/* Search results */
.docs-results {
    position: absolute;
    top: calc(100% + 0.5rem);
    left: 0; right: 0;
    z-index: 50;
    background: rgba(12, 13, 18, 0.97);
    backdrop-filter: blur(8px);
    -webkit-backdrop-filter: blur(8px);
    border: 1px solid var(--line-strong);
    border-radius: 12px;
    box-shadow: 0 22px 50px -18px rgba(0, 0, 0, 0.9);
    padding: 0.4rem;
    max-height: 60vh;
    overflow-y: auto;
    display: none;
}
.docs-results.open { display: block; }
.docs-result {
    display: block;
    padding: 0.6rem 0.7rem;
    border-radius: 8px;
    cursor: pointer;
}
.docs-result:hover,
.docs-result.active { background: rgba(248, 104, 56, 0.12); }
.docs-result-title {
    font-family: var(--font-display);
    font-weight: 600;
    font-size: 0.92rem;
    color: var(--text);
}
.docs-result-ctx {
    display: block;
    font-size: 0.8rem;
    color: var(--muted);
    margin-top: 0.15rem;
    line-height: 1.5;
}
.docs-result mark { background: rgba(248, 104, 56, 0.28); color: var(--cp-accent-bright); border-radius: 3px; padding: 0 1px; }
.docs-results-empty { padding: 0.9rem 0.7rem; color: var(--muted); font-size: 0.88rem; }

/* Nav tree */
.docs-nav-group { margin-bottom: var(--s-3); }
.docs-nav-grouptitle {
    font-family: var(--font-body);
    font-weight: 600;
    font-size: 0.72rem;
    letter-spacing: 0.18em;
    text-transform: uppercase;
    color: var(--muted);
    padding: 0 0.7rem;
    margin-bottom: 0.55rem;
}
.docs-nav-link {
    display: flex;
    align-items: center;
    gap: 0.6rem;
    font-size: 0.92rem;
    color: var(--text-dim);
    padding: 0.45rem 0.7rem;
    border-radius: 8px;
    transition: color 0.18s var(--ease), background 0.18s var(--ease);
}
.docs-nav-ico {
    width: 20px;
    height: 20px;
    flex: 0 0 auto;
    object-fit: contain;
    opacity: 0.6;
    transition: opacity 0.18s var(--ease);
}
.docs-nav-label { min-width: 0; }
.docs-nav-link:hover { color: var(--text); background: rgba(255, 255, 255, 0.04); }
.docs-nav-link:hover .docs-nav-ico { opacity: 0.9; }
.docs-nav-link.active {
    color: var(--teal-bright);
    background: var(--cp-accent-soft);
    font-weight: 600;
}
.docs-nav-link.active .docs-nav-ico { opacity: 1; }

/* ═══ ARTICLE ═══ */
.docs-main { min-width: 0; }

.docs-breadcrumb {
    display: flex;
    align-items: center;
    gap: 0.5rem;
    font-size: 0.8rem;
    letter-spacing: 0.04em;
    color: var(--muted);
    margin-bottom: var(--s-3);
}
.docs-breadcrumb .sep { opacity: 0.5; }
.docs-breadcrumb .cur { color: var(--teal); }

.docs-article { min-width: 0; }
.docs-article > *:first-child { margin-top: 0; }

.docs-article h1 {
    font-size: clamp(2rem, 4vw, 2.85rem);
    color: var(--text);
    letter-spacing: 0.02em;
    margin-bottom: var(--s-3);
    scroll-margin-top: var(--docs-top);
}
.docs-article h2 {
    font-size: clamp(1.45rem, 2.4vw, 1.85rem);
    color: var(--text);
    letter-spacing: 0.02em;
    margin: var(--s-5) 0 var(--s-2);
    padding-top: 0.4rem;
    scroll-margin-top: var(--docs-top);
}
.docs-article h3 {
    font-size: 1.2rem;
    color: var(--text);
    margin: var(--s-4) 0 var(--s-1);
    scroll-margin-top: var(--docs-top);
}
.docs-article h2 + h3 { margin-top: var(--s-2); }

.docs-article p,
.docs-article li {
    color: var(--text-dim);
    font-size: 1.02rem;
    line-height: 1.78;
}
.docs-article p { margin: var(--s-2) 0; text-wrap: pretty; }

.docs-article a {
    color: var(--teal-bright);
    text-decoration: none;
    border-bottom: 1px solid rgba(248, 104, 56, 0.3);
    transition: border-color 0.2s var(--ease), color 0.2s var(--ease);
}
.docs-article a:hover { color: var(--text); border-bottom-color: var(--teal-bright); }

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

.docs-article ul,
.docs-article ol { margin: var(--s-2) 0; padding-left: 1.4rem; }
.docs-article ul { list-style: none; padding-left: 1.5rem; }
.docs-article ul > li { position: relative; margin: 0.4rem 0; }
.docs-article ul > li::before {
    content: '';
    position: absolute;
    left: -1.1rem; top: 0.72em;
    width: 6px; height: 6px;
    border-radius: 50%;
    background: var(--teal);
    opacity: 0.8;
}
.docs-article ol { padding-left: 1.3rem; }
.docs-article ol > li { margin: 0.4rem 0; padding-left: 0.3rem; }
.docs-article ol > li::marker { color: var(--teal); font-family: var(--font-display); font-weight: 700; }

/* Inline + block code */
.docs-article code {
    font-family: 'SFMono-Regular', ui-monospace, 'Cascadia Code', Menlo, Consolas, monospace;
    font-size: 0.88em;
    background: rgba(255, 255, 255, 0.06);
    border: 1px solid var(--line);
    border-radius: 5px;
    padding: 0.12em 0.4em;
    color: var(--teal-bright);
}
.docs-article pre {
    background: var(--code-bg);
    border: 1px solid var(--line-strong);
    border-radius: var(--radius);
    padding: var(--s-3);
    overflow-x: auto;
    margin: var(--s-3) 0;
}
.docs-article pre code {
    background: none;
    border: none;
    padding: 0;
    color: var(--text-dim);
    font-size: 0.9rem;
    line-height: 1.7;
}

/* Blockquote = callout */
.docs-article blockquote {
    margin: var(--s-3) 0;
    padding: 1rem 1.3rem;
    background: rgba(248, 104, 56, 0.09);
    border: 1px solid rgba(248, 104, 56, 0.22);
    border-radius: var(--radius);
}
.docs-article blockquote p { margin: 0.3rem 0; color: var(--text-dim); }
.docs-article blockquote p:first-child { margin-top: 0; }
.docs-article blockquote p:last-child { margin-bottom: 0; }

/* Tables */
.docs-article table {
    width: 100%;
    border-collapse: collapse;
    margin: var(--s-3) 0;
    font-size: 0.95rem;
    overflow: hidden;
    border-radius: var(--radius);
    border: 1px solid var(--line-strong);
}
.docs-article thead { background: var(--panel-2); }
.docs-article th {
    text-align: left;
    font-family: var(--font-display);
    font-weight: 600;
    letter-spacing: 0.04em;
    color: var(--text);
    padding: 0.7rem 1rem;
}
.docs-article td {
    padding: 0.7rem 1rem;
    color: var(--text-dim);
    border-top: 1px solid var(--line);
}
.docs-article tbody tr:nth-child(even) { background: rgba(255, 255, 255, 0.015); }
.docs-article td code { white-space: nowrap; }

/* Images */
.docs-article img {
    width: 100%;
    border-radius: var(--radius-lg);
    border: 1px solid var(--line-strong);
    margin: var(--s-3) 0;
    box-shadow: 0 20px 50px -24px rgba(0, 0, 0, 0.85);
}

.docs-article hr { border: none; border-top: 1px solid var(--line); margin: var(--s-5) 0; }

/* Prev / next */
.docs-pager {
    display: grid;
    grid-template-columns: 1fr 1fr;
    gap: var(--s-2);
    margin-top: var(--s-6);
    padding-top: var(--s-4);
    border-top: 1px solid var(--line);
}
.docs-pager-link {
    display: flex;
    flex-direction: row;
    align-items: center;
    justify-content: space-between;
    gap: 0.9rem;
    padding: 1rem 1.2rem;
    border-radius: var(--radius);
    background: rgba(255, 255, 255, 0.045);
    transition: background 0.2s var(--ease), color 0.2s var(--ease);
}
.docs-article a.docs-pager-link { border-bottom: 0; }
.docs-pager-link:hover { background: rgba(248, 104, 56, 0.08); }
.docs-pager-link:hover .docs-pager-title { color: var(--teal-bright); }
.docs-pager-text { display: flex; flex-direction: column; gap: 0.25rem; min-width: 0; }
.docs-pager-link.prev .docs-pager-text { text-align: right; }
.docs-pager-chevron { flex: 0 0 auto; font-size: 1.5rem; line-height: 1; color: var(--text); }
.docs-pager-link:hover .docs-pager-chevron { color: var(--teal-bright); }
.docs-pager-dir { font-size: 0.72rem; letter-spacing: 0.16em; text-transform: uppercase; color: var(--muted); }
.docs-pager-title { font-family: var(--font-display); font-weight: 600; color: var(--text); font-size: 1.02rem; }
.docs-pager-link.placeholder { visibility: hidden; }

/* ═══ ON THIS PAGE (TOC) ═══ */
.docs-toc {
    position: sticky;
    top: var(--docs-top);
    max-height: calc(100vh - var(--docs-top) - 1rem);
    overflow-y: auto;
    font-size: 0.86rem;
    scrollbar-width: thin;
    scrollbar-color: var(--line-strong) transparent;
}
.docs-toc-title {
    font-family: var(--font-body);
    font-weight: 600;
    font-size: 0.7rem;
    letter-spacing: 0.18em;
    text-transform: uppercase;
    color: var(--muted);
    margin-bottom: 0.7rem;
    display: flex;
    align-items: center;
    gap: 0.5rem;
}
.docs-toc-title svg { width: 14px; height: 14px; color: var(--teal); }
.docs-toc-link {
    display: block;
    color: var(--muted);
    padding: 0.3rem 0 0.3rem 0.1rem;
    line-height: 1.45;
    transition: color 0.18s var(--ease);
}
.docs-toc-link.sub { padding-left: 0.95rem; font-size: 0.82rem; }
.docs-toc-link:hover { color: var(--text-dim); }
.docs-toc-link.active { color: var(--teal-bright); font-weight: 600; }
.docs-toc:empty { display: none; }

/* Loading / not-found states */
.docs-loading,
.docs-notfound {
    color: var(--muted);
    padding: var(--s-5) 0;
    font-size: 1rem;
}
.docs-notfound h1 { color: var(--text); }

/* ═══ RESPONSIVE ═══ */
@media (max-width: 1140px) {
    :root { --docs-gap: 1.8rem; }
    .docs-shell { grid-template-columns: 250px minmax(0, 1fr); }
    .docs-toc { display: none; }
}

@media (max-width: 860px) {
    .docs-shell {
        display: block;
        padding-top: 0;
    }
    .docs-mobilebar { display: flex; }
    .docs-sidebar {
        position: fixed;
        top: var(--nav-h);
        left: 0;
        width: min(320px, 86vw);
        height: calc(100vh - var(--nav-h));
        max-height: none;
        background: rgba(10, 11, 16, 0.98);
        backdrop-filter: blur(8px);
        -webkit-backdrop-filter: blur(8px);
        border-right: 1px solid var(--line-strong);
        padding: var(--s-3) var(--s-2) var(--s-4) var(--s-3);
        transform: translateX(-104%);
        transition: transform 0.32s var(--ease);
        z-index: 60;
    }
    .docs-sidebar.open { transform: none; }
    .docs-main { padding-top: var(--s-3); }
    .docs-backdrop {
        position: fixed;
        inset: 0;
        background: rgba(4, 5, 8, 0.6);
        opacity: 0;
        visibility: hidden;
        transition: opacity 0.3s var(--ease), visibility 0.3s;
        z-index: 55;
    }
    .docs-backdrop.open { opacity: 1; visibility: visible; }
}

@media (max-width: 520px) {
    .docs-pager { grid-template-columns: 1fr; }
    .docs-pager-link.placeholder { display: none; }
}