/* =============================================================================
   meshcore.nexus guides
   Same tokens, fonts and furniture as the front page; the document styles
   below are the part that's specific to long-form reading.
   ============================================================================= */

:root {
    --font-display: 'Space Grotesk', system-ui, sans-serif;
    --font-body: 'Inter', system-ui, sans-serif;
    --font-mono: 'IBM Plex Mono', ui-monospace, monospace;

    --signal:   #ff8c42;
    --signal-2: #34d1a3;
    --signal-3: #ffd166;

    --radius: 14px;
    --radius-sm: 9px;
    --ease: cubic-bezier(.22, 1, .36, 1);
    --maxw: 1180px;
}

html[data-theme="dark"] {
    --bg:        #100e0c;
    --bg-2:      #16130f;
    --surface:   #1b1713;
    --surface-2: #221d17;
    --text:      #f3ede4;
    --text-dim:  #b7ac9d;
    --text-mute: #8a8073;
    --border:    rgba(243, 237, 228, 0.10);
    --border-2:  rgba(243, 237, 228, 0.18);
    --shadow:    0 24px 60px -20px rgba(0, 0, 0, 0.75);
    --grid-dot:  rgba(243, 237, 228, 0.035);
    --code-bg:   #14110e;
    --code-head: #1d1813;

    /* Syntax tokens. Four hues drawn from the site accents, redefined per theme
       rather than reusing --signal-* directly: amber on cream fails AA. */
    --tok-com:  #8a8073;
    --tok-pun:  #9c9184;
    --tok-key:  #67cfae;
    --tok-str:  #efbb6b;
    --tok-num:  #e8906b;
    --tok-kw:   #ff8c42;

    color-scheme: dark;
}

html[data-theme="light"] {
    --bg:        #f6f1e9;
    --bg-2:      #efe8dc;
    --surface:   #fffdf9;
    --surface-2: #fbf6ee;
    --text:      #241f18;
    --text-dim:  #5c5445;
    --text-mute: #726858;
    --border:    rgba(36, 31, 24, 0.12);
    --border-2:  rgba(36, 31, 24, 0.22);
    /* Re-cut for paper, matching the front page: the display accents sit
       between 1.3:1 and 3.4:1 on cream, so light mode gets its own values. */
    --signal:    #a33e06;
    --signal-2:  #08674b;
    --signal-3:  #8c5d00;
    --shadow:    0 24px 50px -24px rgba(80, 60, 30, 0.35);
    --grid-dot:  rgba(36, 31, 24, 0.05);
    --code-bg:   #fbf7f0;
    --code-head: #f2ebe0;

    --tok-com:  #6e6656;
    --tok-pun:  #5c5445;
    --tok-key:  #0f7a5f;
    --tok-str:  #8a5a08;
    --tok-num:  #a8401a;
    --tok-kw:   #b84a0c;

    color-scheme: light;
}

* { margin: 0; padding: 0; box-sizing: border-box; }

html { scroll-behavior: smooth; scroll-padding-top: 5rem; }
@media (prefers-reduced-motion: reduce) { html { scroll-behavior: auto; } }

body {
    font-family: var(--font-body);
    background: var(--bg);
    color: var(--text);
    line-height: 1.6;
    -webkit-font-smoothing: antialiased;
    text-rendering: optimizeLegibility;
    overflow-x: hidden;
}

body::before {
    content: '';
    position: fixed;
    inset: 0;
    background-image: radial-gradient(var(--grid-dot) 1px, transparent 1px);
    background-size: 26px 26px;
    pointer-events: none;
    z-index: 0;
}

a { color: inherit; }
::selection { background: var(--signal); color: #100e0c; }

.wrap { max-width: var(--maxw); margin: 0 auto; padding: 0 clamp(1.1rem, 4vw, 2.5rem); position: relative; z-index: 1; }

.mono {
    font-family: var(--font-mono);
    font-size: .74rem;
    letter-spacing: .12em;
    text-transform: uppercase;
    color: var(--text-mute);
}

/* ---------------------------------------------------------------------------
   Nav & footer, lifted from the front page so the chrome matches
   --------------------------------------------------------------------------- */
header.site {
    position: sticky;
    top: 0;
    z-index: 50;
    backdrop-filter: blur(10px);
    -webkit-backdrop-filter: blur(10px);
    /* Matches the front page: opaque enough that scrolling content doesn't
       read through the bar. */
    background: color-mix(in srgb, var(--bg) 92%, transparent);
    border-bottom: 1px solid var(--border);
}
.nav { display: flex; align-items: center; justify-content: space-between; gap: 1rem; padding: .85rem 0; }
.brand {
    display: inline-flex; align-items: center; gap: .6rem;
    font-family: var(--font-display); font-weight: 600; font-size: 1.06rem;
    letter-spacing: -.01em; text-decoration: none; color: var(--text);
}
.brand svg { width: 26px; height: 26px; display: block; }
.brand .dot { color: var(--signal); }
.nav-actions { display: flex; align-items: center; gap: .35rem; }
.nav-link {
    display: inline-flex; align-items: center; gap: .5rem;
    padding: .5rem .8rem; border-radius: 999px;
    text-decoration: none; color: var(--text-dim);
    font-size: .92rem; font-weight: 500;
    transition: color .2s var(--ease), background .2s var(--ease);
}
.nav-link:hover { color: var(--text); background: var(--surface-2); }
.nav-link.is-current { color: var(--signal); background: color-mix(in srgb, var(--signal) 10%, transparent); }
.icon-btn {
    display: inline-grid; place-items: center;
    width: 40px; height: 40px; border-radius: 999px;
    border: 1px solid var(--border); background: var(--surface);
    color: var(--text-dim); cursor: pointer;
    transition: color .2s var(--ease), border-color .2s var(--ease), transform .2s var(--ease);
}
.icon-btn:hover { color: var(--signal); border-color: var(--border-2); transform: translateY(-1px); }
.icon-btn .fa-sun { display: none; }
html[data-theme="light"] .icon-btn .fa-sun { display: inline; }
html[data-theme="light"] .icon-btn .fa-moon { display: none; }

@media (max-width: 720px) {
    .nav-link span { display: none; }
    .nav-link { padding: .5rem .6rem; }
}

footer.site {
    position: relative; z-index: 1;
    border-top: 1px solid var(--border);
    padding: 2.5rem 0 3rem;
    margin-top: 3rem;
}
.foot { display: flex; flex-wrap: wrap; align-items: center; justify-content: space-between; gap: 1rem; }
.foot-brand { display: flex; align-items: center; gap: .6rem; font-family: var(--font-display); font-weight: 600; }
.foot-brand svg { width: 22px; height: 22px; }
.foot-links { display: flex; flex-wrap: wrap; gap: 1.3rem; }
.foot-links a { color: var(--text-mute); text-decoration: none; font-size: .9rem; transition: color .2s var(--ease); }
.foot-links a:hover { color: var(--signal); }
.foot-note { flex-basis: 100%; color: var(--text-mute); font-size: .82rem; font-family: var(--font-mono); }

/* ---------------------------------------------------------------------------
   Shared bits
   --------------------------------------------------------------------------- */
.section { padding-top: clamp(2.5rem, 6vh, 4rem); padding-bottom: clamp(2rem, 5vh, 3rem); }

.sec-head { display: flex; align-items: baseline; gap: 1rem; margin-bottom: 2.2rem; flex-wrap: wrap; }
.sec-head h1 { font-family: var(--font-display); font-weight: 600; font-size: clamp(1.9rem, 4.5vw, 2.6rem); letter-spacing: -.02em; }
.sec-head .count { font-family: var(--font-mono); color: var(--signal); font-size: .85rem; }
.sec-head p { flex-basis: 100%; color: var(--text-mute); max-width: 62ch; margin-top: -.2rem; }

.node-badge {
    flex: none; width: 46px; height: 46px;
    display: grid; place-items: center; border-radius: 12px;
    color: var(--signal);
    background: color-mix(in srgb, var(--signal) 12%, transparent);
    border: 1px solid color-mix(in srgb, var(--signal) 30%, transparent);
    font-size: 1.15rem;
    transition: transform .3s var(--ease);
}

.tags { display: flex; flex-wrap: wrap; gap: .4rem; }
.tag {
    font-family: var(--font-mono); font-size: .72rem;
    padding: .18rem .55rem; border-radius: 6px;
    color: var(--text-dim); background: var(--surface-2);
    border: 1px solid var(--border);
    text-transform: none; letter-spacing: 0;
}
.tag.note {
    color: var(--signal-3);
    border-color: color-mix(in srgb, var(--signal-3) 35%, transparent);
    background: color-mix(in srgb, var(--signal-3) 10%, transparent);
    text-transform: uppercase; letter-spacing: .06em; font-size: .62rem;
    vertical-align: middle;
}

.btn {
    display: inline-flex; align-items: center; gap: .55rem;
    padding: .8rem 1.3rem; border-radius: 999px;
    font-weight: 600; font-size: .96rem; text-decoration: none;
    border: 1px solid transparent; cursor: pointer;
    transition: transform .2s var(--ease), box-shadow .2s var(--ease);
}
.btn-primary {
    background: var(--signal); color: #17120d;
    box-shadow: 0 8px 24px -10px color-mix(in srgb, var(--signal) 80%, transparent);
}
.btn-primary:hover { transform: translateY(-2px); }

.link {
    display: inline-flex; align-items: center; gap: .45rem;
    padding: .5rem .85rem; border-radius: 8px;
    font-size: .86rem; font-weight: 500; text-decoration: none;
    color: var(--text-dim); border: 1px solid var(--border); background: var(--surface-2);
    transition: color .2s var(--ease), border-color .2s var(--ease), transform .2s var(--ease);
}
.link:hover { color: var(--text); border-color: var(--border-2); transform: translateY(-1px); }

/* ---------------------------------------------------------------------------
   Guides index
   --------------------------------------------------------------------------- */
/* A list, not a grid: guides are few and long, and full-width rows read
   better than a lonely card stranded in a four-column layout. */
.guide-grid { display: flex; flex-direction: column; gap: 1rem; max-width: 860px; }
.guide-card {
    display: flex; gap: 1.25rem; padding: 1.5rem 1.6rem;
    text-decoration: none;
    background: var(--surface);
    border: 1px solid var(--border);
    border-radius: var(--radius);
    position: relative; overflow: hidden;
    transition: transform .3s var(--ease), border-color .3s var(--ease), box-shadow .3s var(--ease);
}
.guide-card::before {
    content: ''; position: absolute; top: 0; left: 0; bottom: 0; width: 2px;
    background: linear-gradient(180deg, var(--signal), var(--signal-2));
    transform: scaleY(0); transform-origin: top;
    transition: transform .45s var(--ease);
}
.guide-card:hover { transform: translateY(-3px); border-color: var(--border-2); box-shadow: var(--shadow); }
.guide-card:hover::before { transform: scaleY(1); }
.guide-card:hover .node-badge { transform: rotate(-6deg) scale(1.04); }
.guide-card-body { min-width: 0; flex: 1; display: flex; flex-direction: column; gap: .5rem; }
.guide-card h2 {
    font-family: var(--font-display); font-weight: 600;
    font-size: 1.3rem; letter-spacing: -.015em; line-height: 1.2;
}
.guide-tagline { color: var(--text); font-weight: 500; font-size: .98rem; }
.guide-desc { color: var(--text-dim); font-size: .93rem; max-width: 62ch; }
.guide-card .tags { margin-top: .2rem; }
.guide-foot {
    display: flex; flex-wrap: wrap; gap: 1.4rem;
    margin-top: .55rem; padding-top: .85rem;
    border-top: 1px solid var(--border);
    font-size: .7rem;
}

@media (max-width: 560px) {
    .guide-card { flex-direction: column; gap: .9rem; padding: 1.3rem; }
}

.empty { max-width: 46ch; padding: clamp(3rem, 10vh, 6rem) 0; display: flex; flex-direction: column; gap: 1rem; align-items: flex-start; }
.empty h1 { font-family: var(--font-display); font-size: clamp(1.6rem, 4vw, 2.2rem); letter-spacing: -.02em; }
.empty p { color: var(--text-dim); }
.empty code { font-family: var(--font-mono); font-size: .9em; color: var(--signal); }

/* ---------------------------------------------------------------------------
   Document layout
   --------------------------------------------------------------------------- */
.doc-page { padding-top: 2rem; padding-bottom: 2rem; }
.doc-page.has-toc {
    display: grid;
    grid-template-columns: minmax(0, 1fr) 250px;
    gap: clamp(2rem, 5vw, 4rem);
    align-items: start;
}
.doc { min-width: 0; max-width: 78ch; }

.crumbs { display: flex; align-items: center; gap: .5rem; font-size: .84rem; color: var(--text-mute); margin-bottom: 1.5rem; }
.crumbs a { color: var(--text-mute); text-decoration: none; transition: color .2s var(--ease); }
.crumbs a:hover { color: var(--signal); }
.crumbs i { font-size: .65em; opacity: .6; }

.doc-head { padding-bottom: 1.6rem; margin-bottom: 2rem; border-bottom: 1px solid var(--border); }
.doc-head h1 {
    font-family: var(--font-display); font-weight: 700;
    font-size: clamp(2rem, 5vw, 3rem); line-height: 1.05;
    letter-spacing: -.03em; margin-bottom: .6rem;
}
.doc-tagline { font-family: var(--font-display); font-weight: 500; font-size: clamp(1.05rem, 2.2vw, 1.3rem); color: var(--text-dim); letter-spacing: -.01em; margin-bottom: 1.1rem; }
.doc-meta { display: flex; flex-wrap: wrap; gap: 1.2rem; font-size: .7rem; margin-bottom: 1rem; }
.doc-meta i { margin-right: .35rem; opacity: .8; }
.doc-meta .draft-flag { color: var(--signal-3); }

/* ---- table of contents ---- */
.toc { position: sticky; top: 5rem; align-self: start; max-height: calc(100vh - 7rem); overflow-y: auto; }
.toc-inner { border-left: 1px solid var(--border); padding-left: 1.1rem; }
.toc-title { margin-bottom: .8rem; }
.toc ol { list-style: none; display: flex; flex-direction: column; gap: .1rem; }
.toc li.lvl-3 { padding-left: .9rem; }
.toc a {
    display: block; padding: .3rem 0;
    color: var(--text-mute); text-decoration: none;
    font-size: .86rem; line-height: 1.35;
    transition: color .2s var(--ease);
}
.toc a:hover { color: var(--text); }
.toc a.active { color: var(--signal); font-weight: 500; }
.toc li.lvl-3 a { font-size: .82rem; }

.toc-inline { display: none; }
.toc-inline summary {
    cursor: pointer; list-style: none;
    font-family: var(--font-mono); font-size: .74rem;
    letter-spacing: .12em; text-transform: uppercase; color: var(--text-mute);
    padding: .8rem 1rem; border: 1px solid var(--border);
    border-radius: var(--radius-sm); background: var(--surface);
}
.toc-inline summary::-webkit-details-marker { display: none; }
.toc-inline summary::after { content: ' ▾'; }
.toc-inline[open] summary { border-bottom-left-radius: 0; border-bottom-right-radius: 0; }
.toc-inline[open] summary::after { content: ' ▴'; }
.toc-inline ol {
    list-style: none; margin: 0; padding: .6rem 1rem 1rem;
    border: 1px solid var(--border); border-top: none;
    border-radius: 0 0 var(--radius-sm) var(--radius-sm);
    background: var(--surface);
}
.toc-inline li.lvl-3 { padding-left: 1rem; }
.toc-inline a { display: block; padding: .3rem 0; color: var(--text-dim); text-decoration: none; font-size: .9rem; }
.toc-inline a:hover { color: var(--signal); }

@media (max-width: 940px) {
    .doc-page.has-toc { display: block; }
    .toc { display: none; }
    .toc-inline { display: block; margin-bottom: 2rem; }
}

/* ---------------------------------------------------------------------------
   Document body: the actual markdown
   --------------------------------------------------------------------------- */
.doc-body { font-size: 1.02rem; line-height: 1.72; color: var(--text-dim); }
.doc-body > *:first-child { margin-top: 0; }

.doc-body h2, .doc-body h3, .doc-body h4, .doc-body h5, .doc-body h6 {
    font-family: var(--font-display);
    color: var(--text);
    letter-spacing: -.02em;
    line-height: 1.25;
    scroll-margin-top: 5rem;
    position: relative;
}
.doc-body h2 {
    font-size: clamp(1.45rem, 3vw, 1.75rem); font-weight: 600;
    margin: 3rem 0 1rem; padding-bottom: .5rem;
    border-bottom: 1px solid var(--border);
}
.doc-body h3 { font-size: 1.2rem; font-weight: 600; margin: 2.2rem 0 .75rem; }
.doc-body h4 { font-size: 1.03rem; font-weight: 600; margin: 1.8rem 0 .6rem; }

.h-anchor {
    position: absolute; left: -1.1em; top: 0;
    width: 1em; text-align: center;
    color: var(--signal); text-decoration: none;
    opacity: 0; transition: opacity .2s var(--ease);
    font-weight: 400;
}
.doc-body h2:hover .h-anchor,
.doc-body h3:hover .h-anchor,
.doc-body h4:hover .h-anchor,
.h-anchor:focus-visible { opacity: 1; }
@media (max-width: 1080px) { .h-anchor { display: none; } }

.doc-body p { margin: 0 0 1.15rem; }
.doc-body strong { color: var(--text); font-weight: 600; }
.doc-body em { font-style: italic; }

.doc-body a {
    color: var(--signal);
    text-decoration: none;
    border-bottom: 1px solid color-mix(in srgb, var(--signal) 35%, transparent);
    transition: border-color .2s var(--ease), background .2s var(--ease);
}
.doc-body a:hover { border-bottom-color: var(--signal); background: color-mix(in srgb, var(--signal) 9%, transparent); }

.doc-body ul, .doc-body ol { margin: 0 0 1.15rem; padding-left: 1.4rem; }
.doc-body li { margin-bottom: .45rem; }
.doc-body li::marker { color: var(--text-mute); }
.doc-body li > ul, .doc-body li > ol { margin-top: .45rem; margin-bottom: 0; }

.doc-body hr { border: none; border-top: 1px solid var(--border); margin: 2.75rem 0; }

.doc-body blockquote {
    margin: 1.5rem 0;
    padding: .2rem 0 .2rem 1.2rem;
    border-left: 2px solid color-mix(in srgb, var(--signal) 55%, transparent);
    color: var(--text-mute);
}
.doc-body blockquote p:last-child { margin-bottom: 0; }

.doc-body img { max-width: 100%; height: auto; border-radius: var(--radius-sm); border: 1px solid var(--border); }

/* ---- tables ---- */
.table-wrap { overflow-x: auto; margin: 1.5rem 0 1.75rem; border: 1px solid var(--border); border-radius: var(--radius-sm); background: var(--surface); }
.doc-body table { width: 100%; border-collapse: collapse; font-size: .92rem; }
.doc-body th, .doc-body td { padding: .65rem .9rem; text-align: left; border-bottom: 1px solid var(--border); vertical-align: top; }
.doc-body th {
    font-family: var(--font-display); font-weight: 600; color: var(--text);
    background: var(--surface-2); white-space: nowrap;
}
.doc-body tr:last-child td { border-bottom: none; }
.doc-body td code { white-space: nowrap; }

/* ---- code ---- */
.doc-body code {
    font-family: var(--font-mono);
    font-size: .88em;
    padding: .15em .42em;
    border-radius: 5px;
    color: var(--signal-3);
    background: color-mix(in srgb, var(--signal-3) 10%, transparent);
    border: 1px solid color-mix(in srgb, var(--signal-3) 22%, transparent);
}
html[data-theme="light"] .doc-body code { color: #8a4a10; }

.code-block {
    margin: 1.35rem 0 1.75rem;
    border: 1px solid var(--border);
    border-radius: var(--radius-sm);
    overflow: hidden;
    background: var(--code-bg);
}
.code-head {
    display: flex; align-items: center; justify-content: space-between;
    gap: 1rem; padding: .45rem .5rem .45rem .9rem;
    background: var(--code-head);
    border-bottom: 1px solid var(--border);
}
.code-lang {
    font-family: var(--font-mono); font-size: .68rem;
    letter-spacing: .14em; text-transform: uppercase; color: var(--text-mute);
}
.code-copy {
    display: inline-flex; align-items: center; gap: .4rem;
    padding: .3rem .6rem; border-radius: 6px;
    font-family: var(--font-mono); font-size: .68rem;
    letter-spacing: .08em; text-transform: uppercase;
    color: var(--text-mute); background: transparent;
    border: 1px solid transparent; cursor: pointer;
    transition: color .2s var(--ease), border-color .2s var(--ease), background .2s var(--ease);
}
.code-copy:hover { color: var(--signal); border-color: color-mix(in srgb, var(--signal) 30%, transparent); background: color-mix(in srgb, var(--signal) 8%, transparent); }
.code-copy.copied { color: var(--signal-2); border-color: color-mix(in srgb, var(--signal-2) 35%, transparent); }

.code-block pre { margin: 0; padding: 1rem 1.1rem; overflow-x: auto; }
.code-block pre code {
    padding: 0; background: none; border: none;
    color: var(--text-dim); font-size: .855rem; line-height: 1.65;
    white-space: pre;
}
html[data-theme="light"] .code-block pre code { color: var(--text); }

/* Token colors. Commands and keywords share the signal hue, flags share the
   key hue: six classes, four colors, so a block reads as structure rather
   than confetti. */
.tok-com  { color: var(--tok-com); font-style: italic; }
.tok-pun  { color: var(--tok-pun); }
.tok-key  { color: var(--tok-key); }
.tok-str  { color: var(--tok-str); }
.tok-num  { color: var(--tok-num); }
.tok-kw   { color: var(--tok-kw); }
.tok-cmd  { color: var(--tok-kw); font-weight: 500; }
.tok-flag { color: var(--tok-key); }

/* ---- callouts ---- */
.callout {
    margin: 1.5rem 0;
    border: 1px solid var(--border);
    border-left: 3px solid var(--callout-accent, var(--signal));
    border-radius: var(--radius-sm);
    background: var(--surface);
    padding: 1rem 1.15rem;
}
.callout-head {
    display: flex; align-items: center; gap: .55rem;
    font-family: var(--font-display); font-weight: 600; font-size: .92rem;
    color: var(--callout-accent, var(--signal));
    margin-bottom: .5rem;
}
.callout-body > *:last-child { margin-bottom: 0; }
.callout-body p { margin-bottom: .7rem; }
.callout-note      { --callout-accent: var(--signal-2); }
.callout-tip       { --callout-accent: var(--signal-2); }
.callout-important { --callout-accent: var(--signal); }
.callout-warning   { --callout-accent: var(--signal-3); }
.callout-caution   { --callout-accent: #ff6b6b; }
html[data-theme="light"] .callout-caution { --callout-accent: #c9372c; }

/* ---- footer of the doc ---- */
.doc-foot { margin-top: 3rem; padding-top: 1.5rem; border-top: 1px solid var(--border); }

@media print {
    header.site, footer.site, .toc, .toc-inline, .crumbs, .doc-foot, .code-copy, .h-anchor { display: none !important; }
    body::before { display: none; }
    .doc-page.has-toc { display: block; }
}