/* MagWorks documentation — Paper & Ink, light-first, mirrored dark.
   Tokens on :root define the whole light palette; the dark blocks only
   redefine tokens. Components read tokens only. */
:root {
  --paper: #f6f1e9;
  --paper-2: #efe8dc;
  --paper-raised: #fbf8f2;
  --paper-well: #e9e1d3;
  --ink: #1b1411;
  --ink-2: #4a3e37;
  --ink-body: #2f2622;
  --ink-muted: #7b6d63;
  --ghost: #a3958a;
  --line: #d8cdbd;
  --line-soft: #e6ddcf;
  --accent: #8a4b2a;
  --accent-wash: rgba(138, 75, 42, 0.09);
  --code-bg: #ede5d7;
  --selection: rgba(138, 75, 42, 0.18);
  --shadow: 0 1px 2px rgba(27, 20, 17, 0.08), 0 8px 24px rgba(27, 20, 17, 0.06);
  --serif: "Instrument Serif", Georgia, "Times New Roman", serif;
  --sans: Inter, system-ui, -apple-system, "Segoe UI", sans-serif;
  --mono: "IBM Plex Mono", ui-monospace, SFMono-Regular, Menlo, monospace;
  --measure: 68ch;
  --masthead-h: 56px;
  --sidebar-w: 268px;
  --rail-w: 220px;
  color-scheme: light;
}
@media (prefers-color-scheme: dark) {
  :root:not([data-theme="light"]) {
    --paper: #17100e;
    --paper-2: #241a16;
    --paper-raised: #241a16;
    --paper-well: #120c0a;
    --ink: #f0e6da;
    --ink-2: #c9bcae;
    --ink-body: #d6cabc;
    --ink-muted: #a89a8e;
    --ghost: #7d6f65;
    --line: #50403a;
    --line-soft: #3c2e28;
    --accent: #e0a17a;
    --accent-wash: rgba(240, 230, 218, 0.09);
    --code-bg: #241a16;
    --selection: rgba(224, 161, 122, 0.25);
    --shadow: 0 1px 3px rgba(0, 0, 0, 0.5);
    color-scheme: dark;
  }
}
:root[data-theme="dark"] {
  --paper: #17100e;
  --paper-2: #241a16;
  --paper-raised: #241a16;
  --paper-well: #120c0a;
  --ink: #f0e6da;
  --ink-2: #c9bcae;
  --ink-body: #d6cabc;
  --ink-muted: #a89a8e;
  --ghost: #7d6f65;
  --line: #50403a;
  --line-soft: #3c2e28;
  --accent: #e0a17a;
  --accent-wash: rgba(240, 230, 218, 0.09);
  --code-bg: #241a16;
  --selection: rgba(224, 161, 122, 0.25);
  --shadow: 0 1px 3px rgba(0, 0, 0, 0.5);
  color-scheme: dark;
}

*, *::before, *::after { box-sizing: border-box; }
html { -webkit-text-size-adjust: 100%; scroll-padding-top: calc(var(--masthead-h) + 16px); }
body {
  margin: 0;
  background: var(--paper);
  color: var(--ink-body);
  font: 16px/1.6 var(--sans);
  font-feature-settings: "cv11", "ss01";
}
::selection { background: var(--selection); }
a { color: var(--ink); text-decoration: underline; text-decoration-color: var(--line); text-underline-offset: 3px; }
a:hover { text-decoration-color: var(--accent); }
:focus-visible { outline: 2px solid var(--accent); outline-offset: 2px; }
.skip { position: absolute; left: -999px; top: 8px; background: var(--paper-raised); color: var(--ink); padding: 8px 12px; z-index: 100; }
.skip:focus { left: 8px; }

/* ---- Masthead ------------------------------------------------------------ */
.masthead {
  position: sticky; top: 0; z-index: 30;
  height: var(--masthead-h);
  display: flex; align-items: center; gap: 14px;
  padding: 0 18px;
  background: color-mix(in srgb, var(--paper) 88%, transparent);
  backdrop-filter: saturate(140%) blur(10px);
  border-bottom: 1px solid var(--line-soft);
}
.wordmark { display: flex; align-items: baseline; gap: 10px; text-decoration: none; color: var(--ink); }
.wordmark-mag { font-family: var(--serif); font-size: 24px; letter-spacing: -0.01em; }
.wordmark-sub { font-size: 12px; letter-spacing: 0.08em; text-transform: uppercase; color: var(--ink-muted); }
.masthead-actions { margin-left: auto; display: flex; gap: 8px; }
.search-button, .theme-button, .menu-button {
  font: inherit; color: var(--ink-2); background: var(--paper-2); border: 1px solid var(--line-soft);
  border-radius: 6px; height: 34px; padding: 0 10px; cursor: pointer; display: inline-flex; align-items: center; gap: 8px;
}
.search-button:hover, .theme-button:hover, .menu-button:hover { border-color: var(--line); color: var(--ink); }
.search-button kbd { font: 12px var(--mono); color: var(--ink-muted); border: 1px solid var(--line); border-radius: 4px; padding: 0 5px; }
.theme-button { width: 34px; padding: 0; justify-content: center; }
.theme-button::before { content: ""; width: 14px; height: 14px; border-radius: 50%; background: linear-gradient(90deg, var(--ink) 50%, var(--paper) 50%); border: 1.5px solid var(--ink); }
.menu-button { display: none; flex-direction: column; justify-content: center; gap: 4px; width: 38px; padding: 0; }
.menu-button span { display: block; width: 18px; height: 1.5px; background: var(--ink); margin: 0 auto; }

/* ---- Frame --------------------------------------------------------------- */
.frame { display: grid; grid-template-columns: var(--sidebar-w) minmax(0, 1fr); min-height: calc(100vh - var(--masthead-h)); }
.sidebar {
  position: sticky; top: var(--masthead-h); align-self: start;
  height: calc(100vh - var(--masthead-h)); overflow-y: auto;
  padding: 22px 14px 48px 18px;
  border-right: 1px solid var(--line-soft);
  font-size: 14px;
}
.nav-group, .nav-children { list-style: none; margin: 0; padding: 0; }
.nav-group > li + li { margin-top: 2px; }
.nav-group a { display: block; padding: 5px 10px; border-radius: 5px; color: var(--ink-2); text-decoration: none; line-height: 1.35; }
.nav-group a:hover { background: var(--paper-2); color: var(--ink); }
.nav-group a[aria-current="page"] { background: var(--accent-wash); color: var(--ink); font-weight: 500; }
.nav-parent > a, .nav-item > a { font-weight: 500; color: var(--ink); }
.nav-children { margin: 2px 0 8px 10px; padding-left: 8px; border-left: 1px solid var(--line-soft); }
.nav-children a { color: var(--ink-2); font-size: 13.5px; padding: 4px 8px; }
.sidebar-foot { margin: 26px 10px 0; font-size: 12px; color: var(--ink-muted); }

/* ---- Content ------------------------------------------------------------- */
.content { display: grid; grid-template-columns: minmax(0, 1fr) var(--rail-w); gap: 40px; padding: 36px 40px 64px; }
.page { max-width: var(--measure); min-width: 0; }
.rail { position: sticky; top: calc(var(--masthead-h) + 32px); align-self: start; font-size: 13px; }
.toc-title { margin: 0 0 8px; font-size: 11px; letter-spacing: 0.1em; text-transform: uppercase; color: var(--ink-muted); }
.toc ul { list-style: none; margin: 0; padding: 0; border-left: 1px solid var(--line-soft); }
.toc a { display: block; padding: 4px 12px; color: var(--ink-muted); text-decoration: none; margin-left: -1px; border-left: 1px solid transparent; }
.toc a:hover { color: var(--ink); }
.toc a.active { color: var(--ink); border-left-color: var(--accent); }
.crumbs { margin: 0 0 6px; font-size: 13px; color: var(--ink-muted); }
.crumbs a { color: inherit; text-decoration: none; }

.page h1 { font: 400 44px/1.08 var(--serif); letter-spacing: -0.015em; color: var(--ink); margin: 0 0 22px; text-wrap: balance; }
.page h2 { font: 400 28px/1.2 var(--serif); color: var(--ink); margin: 44px 0 12px; padding-top: 16px; border-top: 1px solid var(--line-soft); text-wrap: balance; }
.page h3 { font: 600 16px/1.35 var(--sans); color: var(--ink); margin: 28px 0 8px; }
.page h2 .anchor, .page h3 .anchor { color: inherit; text-decoration: none; }
.page h2 .anchor:hover::after, .page h3 .anchor:hover::after { content: " #"; color: var(--ghost); font-family: var(--mono); font-size: 0.7em; }
.page p { margin: 0 0 16px; }
.page h1 + p { font-size: 18px; line-height: 1.55; color: var(--ink-2); }
.page ul, .page ol { margin: 0 0 16px; padding-left: 22px; }
.page li { margin: 0 0 6px; }
.page li > p { margin-bottom: 8px; }
.page strong { color: var(--ink); font-weight: 600; }
.page em { font-style: italic; }
.page blockquote { margin: 18px 0; padding: 4px 0 4px 18px; border-left: 2px solid var(--accent); color: var(--ink-2); font-family: var(--serif); font-size: 19px; line-height: 1.45; }
.page blockquote p { margin: 0; }
.page hr { border: 0; border-top: 1px solid var(--line-soft); margin: 32px 0; }
.page code { font: 0.9em var(--mono); background: var(--code-bg); border-radius: 4px; padding: 1px 5px; color: var(--ink); }
.page pre { background: var(--code-bg); border: 1px solid var(--line-soft); border-radius: 6px; padding: 14px 16px; overflow-x: auto; margin: 0 0 18px; font-size: 13px; line-height: 1.5; }
.page pre code { background: none; padding: 0; font-size: inherit; }
.table-wrap { overflow-x: auto; margin: 0 0 18px; border: 1px solid var(--line-soft); border-radius: 6px; }
.page table { border-collapse: collapse; width: 100%; font-size: 14px; }
.page th, .page td { text-align: left; vertical-align: top; padding: 8px 12px; border-bottom: 1px solid var(--line-soft); }
.page th { font-weight: 600; color: var(--ink); background: var(--paper-2); font-size: 12px; letter-spacing: 0.04em; text-transform: uppercase; }
.page tr:last-child td { border-bottom: 0; }
.page td code { white-space: nowrap; }

.page-nav { display: flex; justify-content: space-between; gap: 16px; margin-top: 56px; padding-top: 20px; border-top: 1px solid var(--line-soft); }
.page-nav a { text-decoration: none; color: var(--ink); font-family: var(--serif); font-size: 19px; max-width: 48%; }
.page-nav a span { display: block; font: 11px var(--sans); letter-spacing: 0.1em; text-transform: uppercase; color: var(--ink-muted); margin-bottom: 4px; }
.page-next { text-align: right; margin-left: auto; }
/* Fixed, very small copyright, bottom-left. Only the link takes pointer
   events so the line never blocks the content beneath it. */
.copyright { position: fixed; left: 10px; bottom: 8px; z-index: 45; margin: 0; padding: 4px 6px; border-radius: 4px; background: color-mix(in srgb, var(--paper) 86%, transparent); font-size: 10.5px; line-height: 1; color: var(--ghost); letter-spacing: 0.01em; pointer-events: none; }
.copyright a { color: var(--ink-muted); text-decoration: none; pointer-events: auto; }
.copyright a:hover { color: var(--ink); text-decoration: underline; text-underline-offset: 2px; }
.content { padding-bottom: 72px; }

/* ---- Search -------------------------------------------------------------- */
.search[hidden] { display: none; }
.search { position: fixed; inset: 0; z-index: 50; background: rgba(27, 20, 17, 0.45); display: grid; place-items: start center; padding: 12vh 16px 16px; }
.search-panel { width: min(640px, 100%); background: var(--paper-raised); border: 1px solid var(--line); border-radius: 10px; box-shadow: var(--shadow); overflow: hidden; }
.search-input { width: 100%; font: 17px var(--sans); color: var(--ink); background: transparent; border: 0; border-bottom: 1px solid var(--line-soft); padding: 16px 18px; outline: none; }
.search-results { list-style: none; margin: 0; padding: 6px; max-height: 50vh; overflow-y: auto; }
.search-results li a { display: block; padding: 10px 12px; border-radius: 6px; text-decoration: none; color: var(--ink); }
.search-results li a:hover, .search-results li a[aria-selected="true"] { background: var(--accent-wash); }
.search-results .r-section { font-size: 11px; letter-spacing: 0.08em; text-transform: uppercase; color: var(--ink-muted); }
.search-results .r-title { font-weight: 500; }
.search-results .r-snip { font-size: 13px; color: var(--ink-2); margin-top: 2px; }
.search-results .r-snip mark { background: var(--selection); color: inherit; }
.search-hint { margin: 0; padding: 8px 18px 10px; font-size: 12px; color: var(--ink-muted); border-top: 1px solid var(--line-soft); }
.search-empty { padding: 18px; color: var(--ink-muted); font-size: 14px; }

/* ---- Responsive ---------------------------------------------------------- */
@media (max-width: 1100px) {
  .content { grid-template-columns: minmax(0, 1fr); }
  .rail { display: none; }
}
@media (max-width: 800px) {
  .frame { grid-template-columns: minmax(0, 1fr); }
  .menu-button { display: inline-flex; }
  .wordmark-sub { display: none; }
  .search-button span { display: none; }
  .sidebar {
    position: fixed; top: var(--masthead-h); left: 0; bottom: 0; width: min(320px, 86vw);
    background: var(--paper); box-shadow: var(--shadow); z-index: 40;
    transform: translateX(-104%); transition: transform 180ms ease;
  }
  .sidebar.open { transform: none; }
  .content { padding: 24px 18px 48px; }
  .page h1 { font-size: 34px; }
  .page h2 { font-size: 24px; }
  .copyright { left: 8px; bottom: 6px; }
}
@media (prefers-reduced-motion: reduce) {
  .sidebar { transition: none; }
}