/* HAVHO Feed Documentation — shared stylesheet */

:root {
  --bg: #ffffff;
  --bg-alt: #f6f8fa;
  --bg-sidebar: #fbfbfd;
  --text: #1c2128;
  --text-muted: #57606a;
  --border: #d8dee4;
  --brand: #0C8474;
  --brand-dark: #0A6A5E;
  --brand-soft: #E2F4F0;
  --code-bg: #0d1117;
  --code-text: #e6edf3;
  --code-inline-bg: #eef1f4;
  --code-inline-text: #b3261e;
  --required: #b42318;
  --required-bg: #fef3f2;
  --optional: #0f5132;
  --optional-bg: #eaf7ef;
  --table-stripe: #f6f8fa;
  --shadow: 0 1px 2px rgba(16, 24, 40, 0.06), 0 1px 3px rgba(16, 24, 40, 0.08);
  --radius: 8px;
  --sidebar-width: 272px;
}

@media (prefers-color-scheme: dark) and (min-width: 99999px) {
  :root {
    --bg: #0d1117;
    --bg-alt: #10151c;
    --bg-sidebar: #0b0f14;
    --text: #e6edf3;
    --text-muted: #9aa4b2;
    --border: #232a34;
    --brand: #4c8dff;
    --brand-dark: #7fb0ff;
    --brand-soft: #142239;
    --code-bg: #05070a;
    --code-text: #d7e0ea;
    --code-inline-bg: #1a2029;
    --code-inline-text: #ff9d92;
    --required: #ff8a80;
    --required-bg: #2a1414;
    --optional: #7ee2a8;
    --optional-bg: #10241a;
    --table-stripe: #10151c;
    --shadow: 0 1px 2px rgba(0, 0, 0, 0.4), 0 1px 3px rgba(0, 0, 0, 0.5);
  }
}

* { box-sizing: border-box; }

html { scroll-behavior: smooth; }

body {
  margin: 0;
  background: var(--bg);
  color: var(--text);
  font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif;
  font-size: 16px;
  line-height: 1.65;
  -webkit-font-smoothing: antialiased;
}

.layout {
  display: flex;
  min-height: 100vh;
  max-width: 1400px;
  margin: 0 auto;
}

/* ---------- Sidebar ---------- */

.sidebar {
  width: var(--sidebar-width);
  flex-shrink: 0;
  background: var(--bg-sidebar);
  border-right: 1px solid var(--border);
  padding: 28px 20px 40px;
  position: sticky;
  top: 0;
  align-self: flex-start;
  height: 100vh;
  overflow-y: auto;
}

.brand {
  display: flex;
  align-items: center;
  gap: 10px;
  margin-bottom: 4px;
  text-decoration: none;
  color: var(--text);
}

.brand-mark {
  width: 32px;
  height: 32px;
  border-radius: 8px;
  background: linear-gradient(135deg, var(--brand), var(--brand-dark));
  display: flex;
  align-items: center;
  justify-content: center;
  color: #fff;
  font-weight: 700;
  font-size: 15px;
  flex-shrink: 0;
}

.brand-name {
  font-weight: 700;
  font-size: 16px;
  letter-spacing: -0.01em;
}

.brand-sub {
  color: var(--text-muted);
  font-size: 12.5px;
  margin: 0 0 24px 42px;
}

.nav-group {
  margin-bottom: 22px;
}

.nav-label {
  font-size: 11px;
  font-weight: 700;
  letter-spacing: 0.08em;
  text-transform: uppercase;
  color: var(--text-muted);
  margin: 0 0 8px 10px;
}

.nav-group a {
  display: block;
  padding: 7px 10px;
  border-radius: 6px;
  color: var(--text);
  text-decoration: none;
  font-size: 14px;
  margin-bottom: 1px;
}

.nav-group a:hover {
  background: var(--bg-alt);
}

.nav-group a.active {
  background: var(--brand-soft);
  color: var(--brand-dark);
  font-weight: 600;
}

.nav-group a .desc {
  display: block;
  font-size: 12px;
  color: var(--text-muted);
  font-weight: 400;
  margin-top: 1px;
}

.nav-group a.active .desc { color: var(--brand-dark); opacity: 0.75; }

/* ---------- Content ---------- */

.content {
  flex: 1;
  min-width: 0;
  padding: 44px 56px 100px;
}

.content > .page-header {
  margin-bottom: 8px;
}

.eyebrow {
  display: inline-flex;
  align-items: center;
  gap: 6px;
  font-size: 12px;
  font-weight: 700;
  letter-spacing: 0.06em;
  text-transform: uppercase;
  color: var(--brand-dark);
  background: var(--brand-soft);
  padding: 4px 10px;
  border-radius: 999px;
  margin-bottom: 14px;
}

h1 {
  font-size: 32px;
  letter-spacing: -0.02em;
  margin: 0 0 10px;
}

h1 + .lede {
  font-size: 17px;
  color: var(--text-muted);
  max-width: 70ch;
  margin: 0 0 36px;
}

h2 {
  font-size: 22px;
  letter-spacing: -0.01em;
  margin: 48px 0 14px;
  padding-top: 8px;
  border-top: 1px solid var(--border);
}

h2:first-of-type { border-top: none; padding-top: 0; margin-top: 32px; }

h3 {
  font-size: 17px;
  margin: 28px 0 10px;
}

p { margin: 0 0 16px; }
ul, ol { margin: 0 0 16px; padding-left: 22px; }
li { margin-bottom: 6px; }

a { color: var(--brand); }
a:hover { color: var(--brand-dark); }

strong { font-weight: 650; }

hr {
  border: none;
  border-top: 1px solid var(--border);
  margin: 40px 0;
}

/* ---------- Callouts ---------- */

.callout {
  border: 1px solid var(--border);
  border-left: 4px solid var(--brand);
  background: var(--bg-alt);
  border-radius: 6px;
  padding: 14px 18px;
  margin: 20px 0;
  font-size: 14.5px;
}

.callout p:last-child { margin-bottom: 0; }
.callout-title {
  font-weight: 700;
  font-size: 13px;
  text-transform: uppercase;
  letter-spacing: 0.04em;
  color: var(--brand-dark);
  margin-bottom: 6px;
}

.callout.warn { border-left-color: var(--required); }
.callout.warn .callout-title { color: var(--required); }

/* ---------- Tables ---------- */

.table-wrap {
  overflow-x: auto;
  border: 1px solid var(--border);
  border-radius: var(--radius);
  margin: 18px 0 28px;
  box-shadow: var(--shadow);
}

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

th, td {
  text-align: left;
  padding: 10px 14px;
  border-bottom: 1px solid var(--border);
  vertical-align: top;
}

thead th {
  background: var(--bg-alt);
  font-size: 12px;
  text-transform: uppercase;
  letter-spacing: 0.04em;
  color: var(--text-muted);
  white-space: nowrap;
}

tbody tr:last-child td { border-bottom: none; }
tbody tr:nth-child(even) { background: var(--table-stripe); }

td code, th code { white-space: nowrap; }

/* ---------- Badges ---------- */

.badge {
  display: inline-block;
  padding: 2px 9px;
  border-radius: 999px;
  font-size: 12px;
  font-weight: 650;
  white-space: nowrap;
}

.badge-required { background: var(--required-bg); color: var(--required); }
.badge-optional { background: var(--optional-bg); color: var(--optional); }

/* ---------- Code ---------- */

code {
  font-family: ui-monospace, SFMono-Regular, "SF Mono", Menlo, Consolas, monospace;
  background: var(--code-inline-bg);
  color: var(--code-inline-text);
  padding: 2px 6px;
  border-radius: 4px;
  font-size: 0.88em;
}

pre {
  background: var(--code-bg);
  color: var(--code-text);
  padding: 18px 20px;
  border-radius: var(--radius);
  overflow-x: auto;
  margin: 16px 0 24px;
  font-size: 13.3px;
  line-height: 1.6;
  box-shadow: var(--shadow);
}

pre code {
  background: none;
  color: inherit;
  padding: 0;
  font-size: 1em;
}

.code-label {
  display: flex;
  align-items: center;
  justify-content: space-between;
  background: var(--code-bg);
  color: var(--text-muted);
  font-size: 12px;
  padding: 9px 20px 0;
  border-radius: var(--radius) var(--radius) 0 0;
  margin: 16px 0 -18px;
  font-family: ui-monospace, SFMono-Regular, "SF Mono", Menlo, Consolas, monospace;
}

.code-label + pre { border-top-left-radius: 0; border-top-right-radius: 0; margin-top: 0; }

/* syntax hint colors (manual spans) */
.tok-key { color: #7ee2a8; }
.tok-str { color: #ffd479; }
.tok-num { color: #79c0ff; }
.tok-punc { color: #8b949e; }
.tok-comment { color: #6e7681; font-style: italic; }
.tok-tag { color: #ff9d92; }
.tok-attr { color: #7ee2a8; }

/* ---------- Page nav (prev/next) ---------- */

.page-nav {
  display: flex;
  justify-content: space-between;
  gap: 16px;
  margin-top: 56px;
  padding-top: 24px;
  border-top: 1px solid var(--border);
}

.page-nav a {
  flex: 1;
  border: 1px solid var(--border);
  border-radius: var(--radius);
  padding: 14px 16px;
  text-decoration: none;
  color: var(--text);
  max-width: 48%;
}

.page-nav a:hover { border-color: var(--brand); background: var(--bg-alt); }
.page-nav .dir { display: block; font-size: 11px; text-transform: uppercase; letter-spacing: 0.05em; color: var(--text-muted); margin-bottom: 4px; }
.page-nav .next { text-align: right; margin-left: auto; }

/* ---------- Footer ---------- */

.doc-footer {
  margin-top: 40px;
  color: var(--text-muted);
  font-size: 13px;
}

/* ---------- Responsive ---------- */

@media (max-width: 900px) {
  .layout { flex-direction: column; }
  .sidebar {
    position: relative;
    width: 100%;
    height: auto;
    border-right: none;
    border-bottom: 1px solid var(--border);
  }
  .content { padding: 32px 20px 80px; }
}