/* ============================================================
   Sola Merlino — Instructional Site
   Design system. Self-contained, no external fonts/CDNs.
   ============================================================ */

:root {
  /* Brand palette — Merlin (violet) + sun (gold) */
  --violet-50:#f4f1fe; --violet-100:#e9e3fd; --violet-200:#d4c6fb;
  --violet-300:#b399f6; --violet-400:#9166ef; --violet-500:#7c3aed;
  --violet-600:#6d28d9; --violet-700:#5b21b6; --violet-800:#4c1d95;
  --gold-300:#fcd96a; --gold-400:#f7c948; --gold-500:#e8b021; --gold-600:#c8901a;
  --ink-950:#0c0a1d; --ink-900:#15122b; --ink-800:#1e1a3a; --ink-700:#2a2550;
  --ink-600:#3a3568; --slate-400:#8b87a8; --slate-300:#a8a4c4; --slate-200:#cbc8e0;

  /* Semantic — light theme default */
  --bg: #f7f6fb;
  --bg-soft: #ffffff;
  --bg-panel: #ffffff;
  --bg-elevated: #ffffff;
  --bg-code: #15122b;
  --border: #e6e2f0;
  --border-strong: #d3cde6;
  --text: #1c1830;
  --text-soft: #4a4566;
  --text-faint: #756f93;
  --accent: var(--violet-500);
  --accent-2: var(--violet-700);
  --gold: var(--gold-500);
  --shadow: 0 1px 2px rgba(20,16,40,.06), 0 8px 24px rgba(20,16,40,.07);
  --shadow-lg: 0 12px 40px rgba(60,40,120,.16);
  --radius: 14px;
  --radius-sm: 9px;
  --sidebar-w: 280px;
  --header-h: 60px;
  --maxw: 880px;
  --mono: ui-monospace, "Cascadia Code", "SF Mono", Menlo, Consolas, monospace;
  --sans: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Inter, system-ui, sans-serif;
}

html[data-theme="dark"] {
  --bg: #0c0a1d;
  --bg-soft: #15122b;
  --bg-panel: #15122b;
  --bg-elevated: #1e1a3a;
  --bg-code: #0a0818;
  --border: #2a2550;
  --border-strong: #3a3568;
  --text: #ece9fb;
  --text-soft: #c2bde0;
  --text-faint: #908ab0;
  --accent: var(--violet-400);
  --accent-2: var(--violet-300);
  --shadow: 0 1px 2px rgba(0,0,0,.3), 0 10px 30px rgba(0,0,0,.35);
  --shadow-lg: 0 16px 50px rgba(0,0,0,.5);
}

* { box-sizing: border-box; }
html { scroll-behavior: smooth; }
body {
  margin: 0; font-family: var(--sans); background: var(--bg); color: var(--text);
  line-height: 1.65; font-size: 16px; -webkit-font-smoothing: antialiased;
  text-rendering: optimizeLegibility;
}
a { color: var(--accent); text-decoration: none; }
a:hover { text-decoration: underline; }
h1,h2,h3,h4 { line-height: 1.25; font-weight: 700; color: var(--text); letter-spacing: -.01em; }
h1 { font-size: 2.1rem; margin: .2em 0 .4em; }
h2 { font-size: 1.5rem; margin: 2.2rem 0 .8rem; padding-top: .4rem; }
h3 { font-size: 1.15rem; margin: 1.8rem 0 .5rem; }
h4 { font-size: 1rem; margin: 1.2rem 0 .4rem; color: var(--text-soft); }
p { margin: .7rem 0; }
hr { border: none; border-top: 1px solid var(--border); margin: 2.5rem 0; }
code { font-family: var(--mono); font-size: .88em; }
:not(pre) > code {
  background: color-mix(in srgb, var(--accent) 12%, transparent);
  color: var(--accent-2); padding: .12em .4em; border-radius: 5px;
  border: 1px solid color-mix(in srgb, var(--accent) 18%, transparent);
}
html[data-theme="dark"] :not(pre) > code { color: var(--violet-200); }

/* ---------- Layout ---------- */
.layout { display: grid; grid-template-columns: var(--sidebar-w) 1fr; min-height: 100vh; }

/* ---------- Sidebar ---------- */
.sidebar {
  position: sticky; top: 0; height: 100vh; overflow-y: auto;
  background: var(--bg-soft); border-right: 1px solid var(--border);
  padding: 0; display: flex; flex-direction: column; z-index: 40;
}
.brand {
  display: flex; align-items: center; gap: .65rem; padding: 1.05rem 1.25rem;
  border-bottom: 1px solid var(--border); position: sticky; top: 0;
  background: var(--bg-soft); z-index: 2;
}
.brand .logo { width: 34px; height: 34px; flex: none; }
.brand .name { font-weight: 800; font-size: 1.12rem; letter-spacing: -.02em; }
.brand .name .sub { display:block; font-weight:500; font-size:.62rem; letter-spacing:.18em;
  text-transform: uppercase; color: var(--text-faint); margin-top: -2px; }
.nav { padding: .8rem .7rem 2rem; }
.nav .group { margin: .2rem 0 1rem; }
.nav .group-label {
  font-size: .68rem; text-transform: uppercase; letter-spacing: .12em;
  color: var(--text-faint); font-weight: 700; padding: .4rem .75rem; margin-top:.5rem;
}
.nav a {
  display: flex; align-items: center; gap: .6rem; padding: .5rem .75rem; margin: 1px 0;
  border-radius: 9px; color: var(--text-soft); font-size: .92rem; font-weight: 500;
  transition: background .12s, color .12s;
}
.nav a:hover { background: color-mix(in srgb, var(--accent) 9%, transparent); color: var(--text); text-decoration: none; }
.nav a.active { background: color-mix(in srgb, var(--accent) 14%, transparent); color: var(--accent-2); font-weight: 600; }
.nav a .ico { width: 17px; height: 17px; flex: none; opacity: .8; }
.nav a.active .ico { opacity: 1; }

/* ---------- Header (mobile) ---------- */
.topbar {
  display: none; align-items: center; gap: .8rem; height: var(--header-h);
  padding: 0 1rem; border-bottom: 1px solid var(--border);
  position: sticky; top: 0; background: color-mix(in srgb, var(--bg) 86%, transparent);
  backdrop-filter: saturate(150%) blur(10px); z-index: 50;
}
.icon-btn {
  display:inline-flex; align-items:center; justify-content:center; width:38px; height:38px;
  border:1px solid var(--border); border-radius:10px; background:var(--bg-panel);
  color:var(--text-soft); cursor:pointer;
}
.icon-btn:hover { color: var(--text); border-color: var(--border-strong); }

/* ---------- Main / content ---------- */
.main { min-width: 0; }
.content { max-width: var(--maxw); margin: 0 auto; padding: 2.6rem 2.4rem 6rem; }
.content > .eyebrow {
  display:inline-block; font-size:.72rem; font-weight:700; letter-spacing:.14em; text-transform:uppercase;
  color: var(--accent); background: color-mix(in srgb, var(--accent) 11%, transparent);
  padding:.3rem .7rem; border-radius:99px; margin-bottom: .4rem;
}
.lead { font-size: 1.18rem; color: var(--text-soft); margin: .3rem 0 1.4rem; }
.content img { max-width: 100%; }
.toolbar { display:flex; gap:.5rem; align-items:center; }
.spacer { flex: 1; }

/* page footer nav */
.pagenav { display:flex; justify-content:space-between; gap:1rem; margin-top:3.5rem;
  padding-top:1.5rem; border-top:1px solid var(--border); }
.pagenav a { display:block; padding:.9rem 1.1rem; border:1px solid var(--border); border-radius:12px;
  flex:1; background:var(--bg-panel); transition:border-color .15s, transform .15s; }
.pagenav a:hover { border-color: var(--accent); text-decoration:none; transform: translateY(-1px); }
.pagenav .dir { font-size:.72rem; color:var(--text-faint); text-transform:uppercase; letter-spacing:.1em; }
.pagenav .ttl { font-weight:600; color:var(--text); }
.pagenav .next { text-align:right; }
.site-foot { color: var(--text-faint); font-size: .82rem; margin-top: 3rem; text-align:center; }

/* ---------- Components ---------- */
.card {
  background: var(--bg-panel); border: 1px solid var(--border); border-radius: var(--radius);
  padding: 1.25rem 1.35rem; box-shadow: var(--shadow);
}
.feature-grid { display: grid; gap: 1rem; grid-template-columns: repeat(auto-fill, minmax(245px, 1fr)); margin: 1.3rem 0; }
.feature {
  background: var(--bg-panel); border: 1px solid var(--border); border-radius: var(--radius);
  padding: 1.2rem 1.25rem; transition: transform .15s, border-color .15s, box-shadow .15s;
  position: relative; overflow: hidden;
}
.feature:hover { transform: translateY(-2px); border-color: color-mix(in srgb, var(--accent) 45%, var(--border)); box-shadow: var(--shadow-lg); }
.feature .ico-badge {
  width: 42px; height: 42px; border-radius: 11px; display:flex; align-items:center; justify-content:center;
  background: linear-gradient(135deg, color-mix(in srgb, var(--accent) 22%, transparent), color-mix(in srgb, var(--gold) 16%, transparent));
  margin-bottom: .8rem; color: var(--accent-2);
}
html[data-theme="dark"] .feature .ico-badge { color: var(--violet-200); }
.feature h3 { margin: 0 0 .35rem; font-size: 1.02rem; }
.feature p { margin: 0; font-size: .9rem; color: var(--text-soft); }
.feature .route { display:inline-block; margin-top:.6rem; font-family:var(--mono); font-size:.74rem;
  color: var(--text-faint); background: var(--bg); border:1px solid var(--border); padding:.1rem .45rem; border-radius:6px; }

/* callouts */
.callout { border: 1px solid var(--border); border-left: 4px solid var(--accent);
  background: color-mix(in srgb, var(--accent) 6%, var(--bg-panel)); border-radius: 10px;
  padding: .95rem 1.15rem; margin: 1.3rem 0; }
.callout.gold { border-left-color: var(--gold); background: color-mix(in srgb, var(--gold) 9%, var(--bg-panel)); }
.callout.warn { border-left-color: #e0683c; background: color-mix(in srgb, #e0683c 8%, var(--bg-panel)); }
.callout .ct { font-weight: 700; display:block; margin-bottom:.2rem; }
.callout p:first-child { margin-top: 0; } .callout p:last-child { margin-bottom: 0; }

/* steps */
.steps { counter-reset: step; margin: 1.4rem 0; padding: 0; list-style: none; }
.steps > li { position: relative; padding: 0 0 1.4rem 3.2rem; }
.steps > li:not(:last-child)::after { content:""; position:absolute; left:17px; top:34px; bottom:-2px; width:2px;
  background: linear-gradient(var(--border-strong), transparent); }
.steps > li::before { counter-increment: step; content: counter(step);
  position: absolute; left: 0; top: 0; width: 36px; height: 36px; border-radius: 50%;
  background: linear-gradient(135deg, var(--accent), var(--accent-2)); color:#fff;
  display:flex; align-items:center; justify-content:center; font-weight:700; box-shadow: var(--shadow); }
.steps > li h4 { margin: .35rem 0 .3rem; font-size: 1.02rem; color: var(--text); }
.steps > li p { margin: .2rem 0; color: var(--text-soft); }

/* code blocks */
.code, pre {
  background: var(--bg-code); color: #e7e3ff; border-radius: 12px; padding: 1.05rem 1.15rem;
  overflow-x: auto; font-family: var(--mono); font-size: .85rem; line-height: 1.6;
  border: 1px solid #2a2550; position: relative; margin: 1.1rem 0;
}
pre code { background: none; border: none; padding: 0; color: inherit; }
.code .cm { color: #8b87a8; } .code .kw { color: #c8a6ff; } .code .st { color: #9be0a8; }
.code .fn { color: #f7c948; } .code .nm { color: #84c5ff; }
.copy-btn { position:absolute; top:.5rem; right:.5rem; font-size:.7rem; padding:.25rem .55rem;
  background: rgba(255,255,255,.08); color:#cbc8e0; border:1px solid rgba(255,255,255,.14);
  border-radius:7px; cursor:pointer; opacity:0; transition:opacity .15s; }
.code:hover .copy-btn, pre:hover .copy-btn { opacity:1; }
.copy-btn:hover { background: rgba(255,255,255,.16); }

/* tables */
.table-wrap { overflow-x:auto; margin:1.2rem 0; border:1px solid var(--border); border-radius:12px; }
table { border-collapse: collapse; width: 100%; font-size: .9rem; }
th, td { text-align: left; padding: .7rem .9rem; border-bottom: 1px solid var(--border); }
thead th { background: var(--bg-soft); color: var(--text-soft); font-weight:700; font-size:.78rem;
  text-transform: uppercase; letter-spacing:.04em; }
tbody tr:last-child td { border-bottom: none; }
tbody tr:hover { background: color-mix(in srgb, var(--accent) 4%, transparent); }
td code { white-space: nowrap; }

/* phase table accent */
.phase-table td:first-child { font-weight:700; color: var(--accent-2); }
html[data-theme="dark"] .phase-table td:first-child { color: var(--violet-200); }

/* api rows */
.api-row { display:flex; gap:.8rem; align-items:center; padding:.6rem .8rem; border:1px solid var(--border);
  border-radius:10px; margin:.45rem 0; background:var(--bg-panel); font-family:var(--mono); font-size:.84rem; flex-wrap:wrap; }
.method { font-weight:700; font-size:.72rem; padding:.18rem .5rem; border-radius:6px; letter-spacing:.03em; flex:none; min-width:52px; text-align:center; }
.method.get{ background:#1f6f43; color:#c8f7d8; } .method.post{ background:#1a4f8a; color:#cfe6ff; }
.method.put{ background:#8a6a1a; color:#ffeec2; } .method.delete{ background:#8a2b2b; color:#ffd2d2; }
.api-row .path { color: var(--text); } .api-row .desc { color: var(--text-faint); font-family:var(--sans); font-size:.84rem; }

/* badges + pills */
.badge { display:inline-block; font-size:.72rem; font-weight:600; padding:.2rem .6rem; border-radius:99px;
  background: color-mix(in srgb, var(--accent) 13%, transparent); color: var(--accent-2); margin:.15rem .25rem .15rem 0; }
html[data-theme="dark"] .badge { color: var(--violet-200); }
.badge.gold { background: color-mix(in srgb, var(--gold) 18%, transparent); color: var(--gold-600); }
html[data-theme="dark"] .badge.gold { color: var(--gold-300); }
.pill-row { display:flex; flex-wrap:wrap; gap:.4rem; margin:.8rem 0; }

/* diagram figure */
figure.diagram { margin: 1.6rem 0; text-align:center; }
figure.diagram img { width:100%; max-width:760px; border:1px solid var(--border); border-radius:14px;
  background: var(--bg-panel); box-shadow: var(--shadow); }
figure.diagram figcaption { color: var(--text-faint); font-size:.83rem; margin-top:.6rem; }

/* stat strip */
.stats { display:grid; grid-template-columns:repeat(auto-fit,minmax(130px,1fr)); gap:1rem; margin:1.4rem 0; }
.stat { background:var(--bg-panel); border:1px solid var(--border); border-radius:12px; padding:1rem 1.1rem; text-align:center; }
.stat .num { font-size:1.7rem; font-weight:800; background:linear-gradient(135deg,var(--accent),var(--gold));
  -webkit-background-clip:text; background-clip:text; -webkit-text-fill-color:transparent; }
.stat .lbl { font-size:.78rem; color:var(--text-faint); text-transform:uppercase; letter-spacing:.05em; }

/* hero (landing) */
.hero { position:relative; padding: 1rem 0 1.5rem; }
.hero .eyebrow { margin-bottom:.7rem; }
.hero h1 { font-size: 2.7rem; margin: .2rem 0 .5rem; }
.hero h1 .grad { background:linear-gradient(120deg,var(--accent) 10%, var(--gold) 90%);
  -webkit-background-clip:text; background-clip:text; -webkit-text-fill-color:transparent; }
.hero .lead { font-size:1.28rem; max-width:42ch; }
.btn-row { display:flex; gap:.7rem; flex-wrap:wrap; margin:1.4rem 0; }
.btn { display:inline-flex; align-items:center; gap:.5rem; padding:.7rem 1.2rem; border-radius:11px;
  font-weight:600; font-size:.95rem; border:1px solid transparent; cursor:pointer; }
.btn.primary { background:linear-gradient(135deg,var(--accent),var(--accent-2)); color:#fff; box-shadow:var(--shadow); }
.btn.primary:hover { text-decoration:none; transform:translateY(-1px); box-shadow:var(--shadow-lg); }
.btn.ghost { background:var(--bg-panel); border-color:var(--border-strong); color:var(--text); }
.btn.ghost:hover { text-decoration:none; border-color:var(--accent); }
.hero-art { width:100%; max-width:520px; margin:1rem auto 0; display:block; }

/* TOC inline */
.toc { background:var(--bg-soft); border:1px solid var(--border); border-radius:12px; padding:1rem 1.2rem; margin:1.4rem 0; }
.toc strong { font-size:.8rem; text-transform:uppercase; letter-spacing:.08em; color:var(--text-faint); }
.toc ul { margin:.5rem 0 0; padding-left:1.1rem; columns:2; }
.toc li { margin:.2rem 0; }

/* search */
.search-wrap { position:relative; margin:.4rem .7rem .8rem; }
#search { width:100%; padding:.55rem .8rem .55rem 2.1rem; border:1px solid var(--border); border-radius:10px;
  background:var(--bg); color:var(--text); font-size:.88rem; font-family:var(--sans); }
#search:focus { outline:none; border-color:var(--accent); }
.search-wrap svg { position:absolute; left:.65rem; top:50%; transform:translateY(-50%); width:15px; height:15px; color:var(--text-faint); }
.search-results { position:absolute; top:100%; left:0; right:0; background:var(--bg-elevated);
  border:1px solid var(--border-strong); border-radius:10px; margin-top:4px; box-shadow:var(--shadow-lg);
  max-height:320px; overflow:auto; display:none; z-index:60; }
.search-results.show { display:block; }
.search-results a { display:block; padding:.55rem .8rem; border-bottom:1px solid var(--border); font-size:.88rem; }
.search-results a:hover { background:color-mix(in srgb,var(--accent) 10%,transparent); text-decoration:none; }
.search-results .r-page { font-size:.72rem; color:var(--text-faint); }
.search-results .empty { padding:.7rem .8rem; color:var(--text-faint); font-size:.85rem; }

/* misc */
.kbd { font-family:var(--mono); font-size:.78rem; background:var(--bg-soft); border:1px solid var(--border-strong);
  border-bottom-width:2px; border-radius:6px; padding:.05rem .4rem; }
.muted { color: var(--text-faint); }
ul.clean { list-style:none; padding-left:0; } ul.clean li { padding:.3rem 0 .3rem 1.6rem; position:relative; }
ul.clean li::before { content:""; position:absolute; left:.2rem; top:.85rem; width:7px; height:7px; border-radius:50%;
  background:linear-gradient(135deg,var(--accent),var(--gold)); }
.two-col { display:grid; grid-template-columns:1fr 1fr; gap:1.3rem; }

/* ---------- Responsive ---------- */
@media (max-width: 1080px){ :root{ --sidebar-w:248px; } .two-col{ grid-template-columns:1fr; } }
@media (max-width: 860px){
  .layout { grid-template-columns: 1fr; }
  .topbar { display:flex; }
  .sidebar { position:fixed; top:0; left:0; bottom:0; width:300px; transform:translateX(-100%);
    transition:transform .22s ease; box-shadow:var(--shadow-lg); }
  body.nav-open .sidebar { transform:translateX(0); }
  .scrim { display:none; position:fixed; inset:0; background:rgba(8,6,20,.5); z-index:39; }
  body.nav-open .scrim { display:block; }
  .content { padding: 1.6rem 1.2rem 4rem; }
  .hero h1 { font-size:2.1rem; } .toc ul{ columns:1; }
}
@media (min-width: 861px){ .scrim{ display:none; } }