/* ============================================================
   KG Cache Middleware — Code Explanation Site
   Shared stylesheet
   ============================================================ */

:root {
    /* color tokens */
    --bg: #0e1117;
    --surface: #161b22;
    --surface-2: #1c2229;
    --border: #2d333b;
    --text: #e6edf3;
    --text-muted: #8b949e;
    --text-dim: #6e7681;
    --accent: #58a6ff;
    --accent-warm: #f0883e;
    --accent-green: #56d364;
    --accent-purple: #bc8cff;
    --accent-pink: #ff7b72;
    --code-bg: #0d1117;
    --code-border: #30363d;
    --shadow: 0 8px 24px rgba(0, 0, 0, 0.4);

    /* spacing */
    --space-1: 4px;
    --space-2: 8px;
    --space-3: 12px;
    --space-4: 16px;
    --space-5: 24px;
    --space-6: 32px;
    --space-7: 48px;
    --space-8: 64px;

    /* type */
    --font-sans: -apple-system, BlinkMacSystemFont, "Segoe UI", "Inter", system-ui, sans-serif;
    --font-mono: "JetBrains Mono", "SF Mono", Menlo, Consolas, monospace;
    --font-serif: "Iowan Old Style", "Palatino", "Georgia", serif;
}

@media (prefers-color-scheme: light) {
    :root {
        --bg: #fafbfc;
        --surface: #ffffff;
        --surface-2: #f6f8fa;
        --border: #d0d7de;
        --text: #1f2328;
        --text-muted: #57606a;
        --text-dim: #6e7781;
        --accent: #0969da;
        --accent-warm: #bc4c00;
        --accent-green: #1a7f37;
        --accent-purple: #8250df;
        --accent-pink: #cf222e;
        --code-bg: #f6f8fa;
        --code-border: #d0d7de;
        --shadow: 0 4px 16px rgba(0, 0, 0, 0.08);
    }
}

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

html {
    scroll-behavior: smooth;
    scroll-padding-top: 80px;
}

body {
    background: var(--bg);
    color: var(--text);
    font-family: var(--font-sans);
    line-height: 1.65;
    font-size: 16px;
    -webkit-font-smoothing: antialiased;
    -moz-osx-font-smoothing: grayscale;
}

/* ============================================================
   Layout
   ============================================================ */

.site {
    display: grid;
    grid-template-columns: 280px 1fr;
    min-height: 100vh;
}

@media (max-width: 900px) {
    .site {
        grid-template-columns: 1fr;
    }
}

.sidebar {
    background: var(--surface);
    border-right: 1px solid var(--border);
    padding: var(--space-6) var(--space-5);
    position: sticky;
    top: 0;
    height: 100vh;
    overflow-y: auto;
}

@media (max-width: 900px) {
    .sidebar {
        position: static;
        height: auto;
    }
}

.sidebar h1 {
    font-size: 18px;
    font-weight: 700;
    letter-spacing: -0.01em;
    margin-bottom: var(--space-2);
}

.sidebar h1 a {
    color: var(--text);
    text-decoration: none;
}

.sidebar .tagline {
    font-size: 12px;
    color: var(--text-muted);
    margin-bottom: var(--space-6);
    line-height: 1.5;
}

.sidebar nav {
    display: flex;
    flex-direction: column;
    gap: var(--space-2);
}

.sidebar nav h2 {
    font-size: 11px;
    font-weight: 600;
    color: var(--text-dim);
    text-transform: uppercase;
    letter-spacing: 0.06em;
    margin-top: var(--space-5);
    margin-bottom: var(--space-2);
}

.sidebar nav a {
    color: var(--text-muted);
    text-decoration: none;
    font-size: 14px;
    padding: 6px 10px;
    border-radius: 6px;
    transition: background 0.15s, color 0.15s;
    display: block;
}

.sidebar nav a:hover {
    background: var(--surface-2);
    color: var(--text);
}

.sidebar nav a.active {
    background: var(--surface-2);
    color: var(--accent);
    font-weight: 600;
}

.sidebar nav a .icon {
    display: inline-block;
    width: 18px;
    text-align: center;
    margin-right: 6px;
    opacity: 0.7;
}

.main {
    padding: var(--space-7) var(--space-7);
    max-width: 980px;
    width: 100%;
    margin: 0 auto;
}

@media (max-width: 900px) {
    .main {
        padding: var(--space-5);
    }
}

/* ============================================================
   Typography
   ============================================================ */

h1, h2, h3, h4 {
    font-weight: 700;
    letter-spacing: -0.015em;
    line-height: 1.25;
    margin-top: var(--space-7);
    margin-bottom: var(--space-4);
}

h1 {
    font-size: 36px;
    margin-top: 0;
}

h1 + .lede {
    font-size: 18px;
    color: var(--text-muted);
    line-height: 1.6;
    margin-top: -8px;
    margin-bottom: var(--space-6);
    max-width: 780px;
}

h2 {
    font-size: 26px;
    border-bottom: 1px solid var(--border);
    padding-bottom: var(--space-3);
}

h3 {
    font-size: 20px;
    color: var(--accent);
}

h4 {
    font-size: 16px;
    color: var(--text);
    text-transform: uppercase;
    letter-spacing: 0.05em;
    font-weight: 600;
}

p {
    margin-bottom: var(--space-4);
    max-width: 80ch;
}

p strong, li strong {
    color: var(--text);
    font-weight: 600;
}

a {
    color: var(--accent);
    text-decoration: none;
    transition: opacity 0.15s;
}

a:hover {
    text-decoration: underline;
}

ul, ol {
    margin: 0 0 var(--space-4) var(--space-5);
}

li {
    margin-bottom: var(--space-2);
    max-width: 78ch;
}

li > p {
    margin-bottom: var(--space-2);
}

/* ============================================================
   Code
   ============================================================ */

code {
    font-family: var(--font-mono);
    font-size: 0.9em;
    background: var(--surface-2);
    padding: 2px 6px;
    border-radius: 4px;
    border: 1px solid var(--border);
    color: var(--accent-warm);
    white-space: nowrap;
}

pre {
    background: var(--code-bg);
    border: 1px solid var(--code-border);
    border-radius: 8px;
    padding: var(--space-4) var(--space-5);
    overflow-x: auto;
    margin: var(--space-4) 0 var(--space-5);
    line-height: 1.55;
    font-size: 13.5px;
    box-shadow: var(--shadow);
}

pre code {
    background: transparent;
    padding: 0;
    border: none;
    color: var(--text);
    white-space: pre;
}

/* simple syntax tokens */
.t-kw { color: var(--accent-pink); }
.t-fn { color: var(--accent-purple); }
.t-str { color: var(--accent-green); }
.t-num { color: var(--accent-warm); }
.t-com { color: var(--text-dim); font-style: italic; }
.t-var { color: var(--accent); }
.t-cls { color: var(--accent-warm); }
.t-op { color: var(--text-muted); }

/* code header strip */
.code-block {
    margin: var(--space-4) 0 var(--space-5);
    border-radius: 8px;
    overflow: hidden;
    border: 1px solid var(--code-border);
    box-shadow: var(--shadow);
}

.code-header {
    background: var(--surface-2);
    border-bottom: 1px solid var(--code-border);
    padding: var(--space-2) var(--space-4);
    font-family: var(--font-mono);
    font-size: 12px;
    color: var(--text-muted);
    display: flex;
    justify-content: space-between;
    align-items: center;
}

.code-header .lang {
    background: var(--bg);
    color: var(--text);
    padding: 2px 8px;
    border-radius: 4px;
    font-size: 11px;
    text-transform: uppercase;
    letter-spacing: 0.05em;
}

.code-block pre {
    margin: 0;
    border: none;
    border-radius: 0;
    box-shadow: none;
}

/* ============================================================
   Cards / Panels
   ============================================================ */

.cards {
    display: grid;
    grid-template-columns: repeat(auto-fit, minmax(280px, 1fr));
    gap: var(--space-4);
    margin: var(--space-5) 0;
}

.card {
    background: var(--surface);
    border: 1px solid var(--border);
    border-radius: 10px;
    padding: var(--space-5);
    text-decoration: none;
    color: inherit;
    transition: transform 0.15s, border-color 0.15s, box-shadow 0.15s;
    display: block;
}

.card:hover {
    border-color: var(--accent);
    transform: translateY(-2px);
    box-shadow: var(--shadow);
    text-decoration: none;
}

.card .badge {
    display: inline-block;
    font-size: 11px;
    text-transform: uppercase;
    letter-spacing: 0.06em;
    color: var(--text-dim);
    margin-bottom: var(--space-2);
}

.card h3 {
    font-size: 17px;
    margin: 0 0 var(--space-2);
    color: var(--text);
}

.card p {
    font-size: 14px;
    color: var(--text-muted);
    margin: 0;
    line-height: 1.55;
}

.card .tags {
    margin-top: var(--space-3);
    display: flex;
    flex-wrap: wrap;
    gap: 6px;
}

.tag {
    display: inline-block;
    font-size: 11px;
    padding: 2px 8px;
    border-radius: 999px;
    background: var(--surface-2);
    border: 1px solid var(--border);
    color: var(--text-muted);
    font-family: var(--font-mono);
}

.tag.green { color: var(--accent-green); border-color: var(--accent-green); }
.tag.blue { color: var(--accent); border-color: var(--accent); }
.tag.warm { color: var(--accent-warm); border-color: var(--accent-warm); }
.tag.purple { color: var(--accent-purple); border-color: var(--accent-purple); }
.tag.pink { color: var(--accent-pink); border-color: var(--accent-pink); }

/* ============================================================
   Callouts
   ============================================================ */

.callout {
    border-left: 4px solid var(--accent);
    background: var(--surface);
    padding: var(--space-4) var(--space-5);
    border-radius: 0 8px 8px 0;
    margin: var(--space-5) 0;
    box-shadow: var(--shadow);
}

.callout.warn { border-left-color: var(--accent-warm); }
.callout.note { border-left-color: var(--accent-purple); }
.callout.success { border-left-color: var(--accent-green); }
.callout.info { border-left-color: var(--accent); }

.callout .title {
    font-weight: 600;
    margin-bottom: var(--space-2);
    display: flex;
    align-items: center;
    gap: 8px;
    font-size: 14px;
    text-transform: uppercase;
    letter-spacing: 0.05em;
}

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

.callout p:last-child {
    margin-bottom: 0;
}

/* ============================================================
   Tables
   ============================================================ */

.table-wrap {
    overflow-x: auto;
    margin: var(--space-5) 0;
    border-radius: 8px;
    border: 1px solid var(--border);
}

table {
    width: 100%;
    border-collapse: collapse;
    font-size: 14px;
}

thead {
    background: var(--surface-2);
}

th, td {
    padding: var(--space-3) var(--space-4);
    text-align: left;
    border-bottom: 1px solid var(--border);
}

th {
    font-weight: 600;
    color: var(--text);
    font-size: 12px;
    text-transform: uppercase;
    letter-spacing: 0.05em;
    color: var(--text-muted);
}

tbody tr:last-child td {
    border-bottom: none;
}

tbody tr:hover {
    background: var(--surface-2);
}

td.num {
    font-family: var(--font-mono);
    text-align: right;
    color: var(--accent-green);
}

td.num.bad {
    color: var(--accent-pink);
}

/* ============================================================
   Diagrams (CSS-only)
   ============================================================ */

.flow {
    display: flex;
    flex-direction: column;
    gap: var(--space-3);
    margin: var(--space-5) 0;
    padding: var(--space-5);
    background: var(--surface);
    border-radius: 12px;
    border: 1px solid var(--border);
}

.flow-step {
    display: grid;
    grid-template-columns: 36px 1fr;
    gap: var(--space-4);
    align-items: start;
}

.flow-num {
    width: 32px;
    height: 32px;
    border-radius: 50%;
    background: linear-gradient(135deg, var(--accent), var(--accent-purple));
    color: white;
    font-weight: 700;
    display: flex;
    align-items: center;
    justify-content: center;
    font-size: 14px;
    flex-shrink: 0;
}

.flow-body {
    background: var(--surface-2);
    border: 1px solid var(--border);
    border-radius: 8px;
    padding: var(--space-3) var(--space-4);
}

.flow-body .head {
    font-weight: 600;
    color: var(--text);
    margin-bottom: 4px;
    font-size: 14px;
}

.flow-body .desc {
    font-size: 13px;
    color: var(--text-muted);
    line-height: 1.5;
}

.flow-body code {
    font-size: 12px;
}

/* component diagram */
.diagram {
    display: grid;
    gap: var(--space-3);
    margin: var(--space-5) 0;
    padding: var(--space-5);
    background: var(--surface);
    border-radius: 12px;
    border: 1px solid var(--border);
}

.diag-row {
    display: flex;
    gap: var(--space-3);
    align-items: stretch;
    flex-wrap: wrap;
}

.diag-box {
    flex: 1;
    min-width: 140px;
    background: var(--surface-2);
    border: 1px solid var(--border);
    border-radius: 8px;
    padding: var(--space-3) var(--space-4);
    text-align: center;
    font-size: 13px;
}

.diag-box .label {
    font-size: 11px;
    color: var(--text-dim);
    text-transform: uppercase;
    letter-spacing: 0.05em;
    margin-bottom: 4px;
}

.diag-box .name {
    font-weight: 600;
    color: var(--text);
    font-family: var(--font-mono);
}

.diag-box.accent { border-color: var(--accent); }
.diag-box.warm { border-color: var(--accent-warm); }
.diag-box.green { border-color: var(--accent-green); }
.diag-box.purple { border-color: var(--accent-purple); }

.diag-arrow {
    align-self: center;
    color: var(--text-dim);
    font-size: 22px;
    padding: 0 var(--space-2);
}

/* ============================================================
   Misc
   ============================================================ */

.kbd {
    font-family: var(--font-mono);
    font-size: 11px;
    background: var(--surface-2);
    border: 1px solid var(--border);
    border-bottom-width: 2px;
    border-radius: 4px;
    padding: 1px 6px;
    color: var(--text);
}

.eq {
    background: var(--surface);
    border: 1px solid var(--border);
    border-radius: 8px;
    padding: var(--space-4) var(--space-5);
    margin: var(--space-4) 0;
    text-align: center;
    font-family: var(--font-serif);
    font-size: 18px;
    overflow-x: auto;
}

.eq .num {
    color: var(--text-dim);
    font-size: 14px;
    float: right;
    font-family: var(--font-mono);
}

.footer {
    margin-top: var(--space-8);
    padding-top: var(--space-5);
    border-top: 1px solid var(--border);
    font-size: 13px;
    color: var(--text-dim);
    display: flex;
    justify-content: space-between;
    flex-wrap: wrap;
    gap: var(--space-3);
}

.footer a {
    color: var(--text-muted);
}

/* anchor offset for fixed-ish nav scroll target */
:target {
    scroll-margin-top: 24px;
}

/* selection */
::selection {
    background: var(--accent);
    color: var(--bg);
}

/* scrollbar */
::-webkit-scrollbar { width: 10px; height: 10px; }
::-webkit-scrollbar-track { background: var(--bg); }
::-webkit-scrollbar-thumb { background: var(--border); border-radius: 5px; }
::-webkit-scrollbar-thumb:hover { background: var(--text-dim); }

/* hero on landing */
.hero {
    background: linear-gradient(135deg, rgba(88, 166, 255, 0.08), rgba(188, 140, 255, 0.08));
    border: 1px solid var(--border);
    border-radius: 16px;
    padding: var(--space-7) var(--space-6);
    margin-bottom: var(--space-7);
    text-align: center;
}

.hero h1 {
    font-size: 42px;
    background: linear-gradient(135deg, var(--accent), var(--accent-purple));
    -webkit-background-clip: text;
    background-clip: text;
    -webkit-text-fill-color: transparent;
    color: transparent;
    margin-bottom: var(--space-3);
}

.hero p {
    font-size: 17px;
    color: var(--text-muted);
    max-width: 640px;
    margin: 0 auto;
}

.hero .meta {
    margin-top: var(--space-4);
    display: flex;
    gap: var(--space-3);
    justify-content: center;
    flex-wrap: wrap;
}

.hero .meta .tag {
    font-size: 12px;
    padding: 4px 12px;
}