/* Documentation website. Colors follow the app (frontend/src/index.css):
   near-black ground, warm off-white text, orange accent; a light variant
   for readers whose system is in light mode. */

:root {
  color-scheme: light dark;
  --bg: #fbfaf8;
  --surface: #f2efe9;
  --border: #e2ded6;
  --text: #1f1e1c;
  --muted: #5f5b53;
  --accent: #a3580a;
  --accent-hover: #7f4507;
  --on-accent: #ffffff;
  --code-bg: #f2efe9;
  --note: #2459b3;
  --tip: #22703a;
  --important: #6e40c9;
  --warning: #8a5300;
  --caution: #b42318;
  --shadow: 0 12px 32px rgba(31, 30, 28, 0.18);
}

@media (prefers-color-scheme: dark) {
  :root {
    --bg: #161617;
    --surface: #1e1e20;
    --border: #333338;
    --text: #e8e6e1;
    --muted: #a8a49c;
    --accent: #e1861f;
    --accent-hover: #f3a24d;
    --on-accent: #161617;
    --code-bg: #1e1e20;
    --note: #79a8ff;
    --tip: #63c57f;
    --important: #b593f2;
    --warning: #e2a541;
    --caution: #ff7b72;
    --shadow: 0 12px 32px rgba(0, 0, 0, 0.5);
  }
}

* { box-sizing: border-box; }

html {
  -webkit-text-size-adjust: 100%;
  scroll-padding-top: 76px;
}

body {
  margin: 0;
  background: var(--bg);
  color: var(--text);
  font: 16px/1.65 system-ui, -apple-system, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;
}

a { color: var(--accent); text-underline-offset: 2px; }
a:hover { color: var(--accent-hover); }

.skip-link { position: absolute; left: -9999px; }
.skip-link:focus { left: 12px; top: 12px; z-index: 20; padding: 6px 12px; background: var(--surface); }

/* Header */

.site-header {
  position: sticky;
  top: 0;
  z-index: 10;
  display: flex;
  align-items: center;
  gap: 16px;
  padding: 10px 24px;
  background: var(--bg);
  border-bottom: 1px solid var(--border);
}

.brand {
  display: flex;
  align-items: center;
  gap: 10px;
  color: var(--text);
  font-weight: 650;
  text-decoration: none;
  white-space: nowrap;
}
.brand:hover { color: var(--text); }
.brand img { border-radius: 6px; }

.top-nav { display: flex; align-items: center; gap: 2px; margin-left: auto; }
.top-nav a {
  padding: 6px 11px;
  border-radius: 8px;
  color: var(--text);
  font-size: 15px;
  text-decoration: none;
}
.top-nav a:hover, .top-nav a[aria-current="page"] { background: var(--surface); }
.top-nav a.button, .menu-links a.button {
  margin-left: 6px;
  background: var(--accent);
  color: var(--on-accent);
  font-weight: 650;
}
.top-nav a.button:hover { background: var(--accent-hover); color: var(--on-accent); }

.menu { display: none; margin-left: auto; }
.menu summary {
  cursor: pointer;
  padding: 6px 14px;
  border: 1px solid var(--border);
  border-radius: 8px;
  font-weight: 600;
  list-style: none;
}
.menu summary::-webkit-details-marker { display: none; }
.menu-links { display: flex; flex-wrap: wrap; gap: 6px; margin: 4px 0 10px; padding: 0; list-style: none; }
.menu-links a { display: block; padding: 6px 12px; border: 1px solid var(--border); border-radius: 8px; color: var(--text); text-decoration: none; }

/* Layout */

.layout {
  display: grid;
  grid-template-columns: 250px minmax(0, 1fr) 230px;
  grid-template-areas: "sidebar main toc";
  gap: 44px;
  max-width: 1440px;
  margin: 0 auto;
  padding: 28px 24px 72px;
}
.layout.no-toc {
  grid-template-columns: 250px minmax(0, 1fr);
  grid-template-areas: "sidebar main";
}

.sidebar {
  grid-area: sidebar;
  position: sticky;
  top: 76px;
  align-self: start;
  max-height: calc(100vh - 92px);
  overflow-y: auto;
  font-size: 14.5px;
}
.nav-title {
  margin: 20px 0 6px;
  color: var(--muted);
  font-size: 12px;
  font-weight: 700;
  letter-spacing: 0.06em;
  text-transform: uppercase;
}
.sidebar .nav-title:first-child { margin-top: 0; }
.sidebar ul, .menu nav ul.nav-list { margin: 0; padding: 0; list-style: none; }
.sidebar a, .menu .nav-list a {
  display: block;
  padding: 4px 10px;
  border-radius: 6px;
  color: var(--text);
  text-decoration: none;
}
.sidebar a:hover, .menu .nav-list a:hover { background: var(--surface); }
.sidebar a[aria-current="page"], .menu .nav-list a[aria-current="page"] {
  background: var(--surface);
  color: var(--accent);
  font-weight: 600;
}

.toc-column { grid-area: toc; }
.toc { position: sticky; top: 76px; font-size: 14px; }
.toc summary { cursor: pointer; color: var(--muted); font-weight: 650; }
.toc ol {
  max-height: calc(100vh - 150px);
  overflow-y: auto;
  margin: 10px 0 0;
  padding: 0 0 0 12px;
  border-left: 1px solid var(--border);
  list-style: none;
}
.toc a { display: block; padding: 3px 4px; color: var(--muted); text-decoration: none; }
.toc a:hover { color: var(--accent); }

.main { grid-area: main; min-width: 0; }

.breadcrumbs { margin-bottom: 10px; color: var(--muted); font-size: 14px; }
.breadcrumbs a { color: var(--muted); }

.page-meta {
  max-width: 820px;
  margin-top: 48px;
  padding-top: 16px;
  border-top: 1px solid var(--border);
  color: var(--muted);
  font-size: 14px;
}
.page-meta a { color: var(--muted); }

.site-footer {
  padding: 24px;
  border-top: 1px solid var(--border);
  color: var(--muted);
  font-size: 14px;
  text-align: center;
}
.site-footer a { color: var(--muted); }

/* Page content: the HTML that GitHub's Markdown API returns */

.markdown-body { max-width: 820px; overflow-wrap: break-word; }
.markdown-body > :first-child { margin-top: 0; }
.markdown-heading { position: relative; }
.markdown-heading .anchor {
  position: absolute;
  top: 50%;
  left: -1.2em;
  padding-right: 0.3em;
  transform: translateY(-50%);
  color: var(--muted);
  text-decoration: none;
  opacity: 0;
}
.markdown-heading:hover .anchor, .markdown-heading .anchor:focus { opacity: 1; }
.octicon-link::before { content: "#"; }

.markdown-body h1, .markdown-body h2, .markdown-body h3, .markdown-body h4 {
  margin: 1.8em 0 0.6em;
  line-height: 1.25;
}
.markdown-body > .markdown-heading:first-child h1 { margin-top: 0; }
.markdown-body h1 { font-size: 2.1rem; letter-spacing: -0.01em; }
.markdown-body h2 { padding-bottom: 0.3em; border-bottom: 1px solid var(--border); font-size: 1.5rem; }
.markdown-body h3 { font-size: 1.2rem; }
.markdown-body h4 { font-size: 1.05rem; }

.markdown-body p, .markdown-body ul, .markdown-body ol, .markdown-body pre,
.markdown-body blockquote, .markdown-body details { margin: 0 0 1em; }
.markdown-body li + li { margin-top: 0.25em; }
.markdown-body li > ul, .markdown-body li > ol { margin: 0.25em 0 0; }

.markdown-body code, .markdown-body kbd, .markdown-body pre {
  font-family: ui-monospace, SFMono-Regular, "Cascadia Mono", Menlo, Consolas, monospace;
  font-size: 0.9em;
}
.markdown-body :not(pre) > code {
  padding: 0.1em 0.35em;
  border: 1px solid var(--border);
  border-radius: 5px;
  background: var(--code-bg);
}
.markdown-body pre {
  overflow-x: auto;
  padding: 14px 16px;
  border: 1px solid var(--border);
  border-radius: 8px;
  background: var(--code-bg);
  line-height: 1.5;
}
.markdown-body pre code { padding: 0; border: 0; background: none; }
.markdown-body kbd {
  padding: 0 0.35em;
  border: 1px solid var(--border);
  border-bottom-width: 2px;
  border-radius: 4px;
  background: var(--surface);
}

.markdown-body blockquote {
  margin-left: 0;
  padding: 0.2em 1em;
  border-left: 4px solid var(--border);
  color: var(--muted);
}
.markdown-body hr { margin: 2em 0; border: 0; border-top: 1px solid var(--border); }
.markdown-body img, .markdown-body video { max-width: 100%; height: auto; border-radius: 6px; }
.markdown-body video { display: block; width: 100%; margin: 0 0 1em; background: #000; }

.table-wrap { overflow-x: auto; margin: 0 0 1.2em; }
.table-wrap table { width: 100%; margin: 0; border-collapse: collapse; font-size: 0.94em; }
.markdown-body th, .markdown-body td {
  padding: 7px 12px;
  border: 1px solid var(--border);
  text-align: left;
  vertical-align: top;
}
.markdown-body th { background: var(--surface); }
.table-wrap.gallery th, .table-wrap.gallery td { padding: 6px; border: 0; background: none; text-align: center; }

.markdown-body details { padding: 0.5em 0.9em; border: 1px solid var(--border); border-radius: 8px; }
.markdown-body summary { cursor: pointer; font-weight: 600; }
.markdown-body .task-list-item { list-style: none; }
.markdown-body .task-list-item input { margin: 0 0.4em 0 -1.4em; }

.callout {
  margin: 0 0 1em;
  padding: 0.7em 1em;
  border-left: 4px solid var(--note);
  border-radius: 0 8px 8px 0;
  background: var(--surface);
}
.callout > :last-child { margin-bottom: 0; }
.callout-title { margin-bottom: 0.3em !important; color: var(--note); font-weight: 700; }
.callout-tip { border-color: var(--tip); }
.callout-tip .callout-title { color: var(--tip); }
.callout-important { border-color: var(--important); }
.callout-important .callout-title { color: var(--important); }
.callout-warning { border-color: var(--warning); }
.callout-warning .callout-title { color: var(--warning); }
.callout-caution { border-color: var(--caution); }
.callout-caution .callout-title { color: var(--caution); }

/* Syntax colors for GitHub's highlighter classes */
.pl-c { color: var(--muted); font-style: italic; }
.pl-k, .pl-smi { color: var(--caution); }
.pl-s, .pl-pds, .pl-sr { color: var(--tip); }
.pl-c1, .pl-v, .pl-e { color: var(--note); }
.pl-en, .pl-ent { color: var(--important); }

/* Narrower screens */

@media (max-width: 1199px) {
  .layout {
    grid-template-columns: 230px minmax(0, 1fr);
    grid-template-areas: "sidebar toc" "sidebar main";
    column-gap: 36px;
    row-gap: 0;
  }
  .layout.no-toc { grid-template-areas: "sidebar main"; }
  .toc { position: static; margin-bottom: 18px; }
  .toc ol { max-height: none; }
}

@media (max-width: 900px) {
  .site-header { padding: 10px 16px; }
  .top-nav, .sidebar { display: none; }
  .menu { display: block; }
  .menu[open] nav {
    position: absolute;
    top: 56px;
    right: 12px;
    left: 12px;
    max-height: calc(100vh - 72px);
    overflow-y: auto;
    padding: 10px 14px 16px;
    border: 1px solid var(--border);
    border-radius: 10px;
    background: var(--bg);
    box-shadow: var(--shadow);
  }
  .layout, .layout.no-toc { display: block; padding: 18px 16px 56px; }
  .markdown-heading .anchor { display: none; }
  .markdown-body h1 { font-size: 1.75rem; }
  .table-wrap.gallery table, .table-wrap.gallery tbody, .table-wrap.gallery tr,
  .table-wrap.gallery td { display: block; width: 100%; }
}