/*
  Peak PIM Developers — shared stylesheet.

  Follows the "Sand Citron" brand direction used by the app
  (frontend/src/index.css): premium cream/sand surfaces, warm near-black ink,
  a citron-yellow accent, Inter for UI text, Source Serif 4 for display
  headings. Light and dark via prefers-color-scheme.
*/

:root {
  --background: hsl(42 42% 97%);
  --foreground: hsl(35 14% 11%);
  --card: hsl(0 0% 100%);
  --muted: hsl(42 32% 93%);
  --muted-foreground: hsl(35 8% 42%);
  --border: hsl(40 24% 87%);
  --citron: hsl(53 92% 51%);
  --citron-soft: hsl(53 92% 51% / 0.28);
  --ink: hsl(35 14% 13%);
  --ink-foreground: hsl(42 45% 97%);
  --code-bg: hsl(42 30% 94%);
  --code-block-bg: hsl(35 14% 13%);
  --code-block-fg: hsl(42 35% 92%);
  --success: hsl(142 55% 40%);
  --warning: hsl(38 92% 47%);
  --danger: hsl(0 74% 52%);
  --info: hsl(210 82% 47%);
  --radius: 10px;
  --header-h: 60px;
}

@media (prefers-color-scheme: dark) {
  :root {
    --background: hsl(30 8% 9%);
    --foreground: hsl(42 30% 94%);
    --card: hsl(30 8% 11%);
    --muted: hsl(30 8% 14%);
    --muted-foreground: hsl(40 10% 62%);
    --border: hsl(30 8% 20%);
    --citron-soft: hsl(53 92% 51% / 0.18);
    --ink: hsl(42 40% 92%);
    --ink-foreground: hsl(35 14% 11%);
    --code-bg: hsl(30 8% 15%);
    --code-block-bg: hsl(30 10% 7%);
    --code-block-fg: hsl(42 30% 90%);
  }
}

* { box-sizing: border-box; }

html { scroll-behavior: smooth; scroll-padding-top: calc(var(--header-h) + 16px); }

body {
  margin: 0;
  font-family: 'Inter', system-ui, -apple-system, 'Segoe UI', sans-serif;
  font-size: 15.5px;
  line-height: 1.65;
  color: var(--foreground);
  background: var(--background);
  -webkit-font-smoothing: antialiased;
}

a { color: inherit; }

/* ---- header ---------------------------------------------------------- */

.site-header {
  position: sticky;
  top: 0;
  z-index: 40;
  height: var(--header-h);
  display: flex;
  align-items: center;
  gap: 24px;
  padding: 0 24px;
  background: color-mix(in srgb, var(--background) 88%, transparent);
  backdrop-filter: blur(10px);
  border-bottom: 1px solid var(--border);
}

.brand {
  display: flex;
  align-items: baseline;
  gap: 10px;
  text-decoration: none;
  white-space: nowrap;
}

.brand .mark {
  font-family: 'Source Serif 4', Georgia, serif;
  font-weight: 700;
  font-size: 19px;
  letter-spacing: -0.01em;
}

.brand .sub {
  font-size: 13px;
  font-weight: 500;
  color: var(--muted-foreground);
  padding-left: 10px;
  border-left: 1px solid var(--border);
}

.site-nav {
  display: flex;
  align-items: center;
  gap: 4px;
  margin-left: auto;
  overflow-x: auto;
}

.site-nav a {
  text-decoration: none;
  font-size: 13.5px;
  font-weight: 500;
  color: var(--muted-foreground);
  padding: 6px 12px;
  border-radius: 999px;
  white-space: nowrap;
}

.site-nav a:hover { color: var(--foreground); background: var(--muted); }
.site-nav a[aria-current='true'] { color: var(--foreground); background: var(--muted); }

.site-nav a.cta {
  color: var(--ink-foreground);
  background: var(--ink);
  font-weight: 600;
}
.site-nav a.cta:hover { opacity: 0.9; }

/* ---- layout ---------------------------------------------------------- */

.shell {
  display: grid;
  grid-template-columns: 240px minmax(0, 1fr);
  gap: 48px;
  max-width: 1120px;
  margin: 0 auto;
  padding: 40px 24px 96px;
}

.shell.single { grid-template-columns: minmax(0, 1fr); max-width: 880px; }

.sidebar {
  position: sticky;
  top: calc(var(--header-h) + 40px);
  align-self: start;
  font-size: 13.5px;
}

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

.sidebar .group-title {
  font-size: 11px;
  font-weight: 600;
  text-transform: uppercase;
  letter-spacing: 0.08em;
  color: var(--muted-foreground);
  margin-bottom: 8px;
}

.sidebar a {
  display: block;
  text-decoration: none;
  color: var(--muted-foreground);
  padding: 5px 10px;
  margin-left: -10px;
  border-radius: 7px;
  font-weight: 450;
}

.sidebar a:hover { color: var(--foreground); background: var(--muted); }

.sidebar a[aria-current='true'] {
  color: var(--foreground);
  font-weight: 600;
  background: var(--citron-soft);
}

/* ---- typography ------------------------------------------------------ */

.content h1 {
  font-family: 'Source Serif 4', Georgia, serif;
  font-size: 38px;
  line-height: 1.15;
  letter-spacing: -0.015em;
  font-weight: 700;
  margin: 0 0 10px;
}

.content .lede {
  font-size: 17.5px;
  color: var(--muted-foreground);
  margin: 0 0 36px;
  max-width: 62ch;
}

.content h2 {
  font-family: 'Source Serif 4', Georgia, serif;
  font-size: 25px;
  font-weight: 700;
  letter-spacing: -0.01em;
  margin: 52px 0 14px;
  padding-top: 18px;
  border-top: 1px solid var(--border);
}

.content h2:first-of-type { border-top: 0; padding-top: 0; margin-top: 28px; }

.content h3 { font-size: 17px; font-weight: 600; margin: 32px 0 8px; }
.content h4 { font-size: 15px; font-weight: 600; margin: 24px 0 6px; }

.content p, .content li { max-width: 72ch; }
.content ul, .content ol { padding-left: 22px; }
.content li { margin: 4px 0; }

.content a { text-decoration-color: color-mix(in srgb, var(--foreground) 30%, transparent); text-underline-offset: 3px; }
.content a:hover { text-decoration-color: var(--foreground); }

/* ---- code ------------------------------------------------------------ */

code {
  font-family: ui-monospace, 'SF Mono', 'Cascadia Code', Menlo, Consolas, monospace;
  font-size: 0.86em;
  background: var(--code-bg);
  border: 1px solid var(--border);
  border-radius: 5px;
  padding: 1px 5px;
  white-space: nowrap;
}

pre {
  background: var(--code-block-bg);
  color: var(--code-block-fg);
  border-radius: var(--radius);
  padding: 16px 18px;
  overflow-x: auto;
  font-size: 13px;
  line-height: 1.6;
  margin: 14px 0 22px;
}

pre code {
  background: transparent;
  border: 0;
  padding: 0;
  white-space: pre;
  font-size: inherit;
  color: inherit;
}

pre .cm { color: hsl(42 15% 62%); }

/* ---- tables ---------------------------------------------------------- */

.table-wrap { overflow-x: auto; margin: 14px 0 22px; }

table {
  border-collapse: collapse;
  width: 100%;
  font-size: 13.5px;
  background: var(--card);
  border: 1px solid var(--border);
  border-radius: var(--radius);
  overflow: hidden;
}

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

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

tr:last-child td { border-bottom: 0; }
td code { white-space: nowrap; }

/* ---- components ------------------------------------------------------ */

.pill {
  display: inline-block;
  font-size: 11px;
  font-weight: 600;
  letter-spacing: 0.04em;
  padding: 2px 9px;
  border-radius: 999px;
  border: 1px solid var(--border);
  background: var(--card);
  color: var(--muted-foreground);
  vertical-align: middle;
}

.pill.get { color: var(--success); border-color: color-mix(in srgb, var(--success) 40%, transparent); }
.pill.scope { background: var(--citron-soft); color: var(--foreground); border-color: transparent; }
.pill.read { color: var(--info); border-color: color-mix(in srgb, var(--info) 40%, transparent); }
.pill.write { color: var(--warning); border-color: color-mix(in srgb, var(--warning) 45%, transparent); }
.pill.publish { color: var(--danger); border-color: color-mix(in srgb, var(--danger) 40%, transparent); }

.callout {
  display: block;
  border: 1px solid var(--border);
  border-left: 3px solid var(--citron);
  background: var(--card);
  border-radius: var(--radius);
  padding: 14px 18px;
  margin: 18px 0 24px;
  font-size: 14px;
  max-width: 76ch;
}

.callout.warn { border-left-color: var(--warning); }
.callout.danger { border-left-color: var(--danger); }
.callout > strong { display: block; margin-bottom: 2px; }
.callout p { margin: 6px 0 0; }

.endpoint {
  border: 1px solid var(--border);
  background: var(--card);
  border-radius: var(--radius);
  padding: 18px 20px;
  margin: 18px 0;
}

.endpoint .sig {
  display: flex;
  flex-wrap: wrap;
  align-items: center;
  gap: 10px;
  margin-bottom: 8px;
}

.endpoint .sig code { font-size: 14px; background: transparent; border: 0; padding: 0; font-weight: 600; }
.endpoint p { margin: 8px 0; }

/* ---- cards / hero ---------------------------------------------------- */

.hero {
  padding: 64px 0 40px;
  max-width: 760px;
}

.hero h1 {
  font-family: 'Source Serif 4', Georgia, serif;
  font-size: 52px;
  line-height: 1.08;
  letter-spacing: -0.02em;
  font-weight: 700;
  margin: 0 0 18px;
}

.hero .accent {
  box-shadow: inset 0 -0.34em 0 var(--citron-soft);
}

.hero p { font-size: 18.5px; color: var(--muted-foreground); max-width: 58ch; margin: 0 0 28px; }

.hero-actions { display: flex; flex-wrap: wrap; gap: 12px; }

.btn {
  display: inline-block;
  text-decoration: none;
  font-weight: 600;
  font-size: 14.5px;
  padding: 11px 20px;
  border-radius: 999px;
  border: 1px solid transparent;
}

.btn.primary { background: var(--ink); color: var(--ink-foreground); }
.btn.primary:hover { opacity: 0.9; }
.btn.ghost { border-color: var(--border); background: var(--card); }
.btn.ghost:hover { background: var(--muted); }

.card-grid {
  display: grid;
  grid-template-columns: repeat(auto-fit, minmax(260px, 1fr));
  gap: 16px;
  margin: 28px 0;
}

.card {
  display: block;
  text-decoration: none;
  border: 1px solid var(--border);
  background: var(--card);
  border-radius: 14px;
  padding: 22px 22px 18px;
  transition: border-color 0.15s ease, transform 0.15s ease;
}

.card:hover { border-color: color-mix(in srgb, var(--foreground) 30%, var(--border)); transform: translateY(-1px); }

.card .kicker {
  font-size: 11px;
  font-weight: 600;
  text-transform: uppercase;
  letter-spacing: 0.08em;
  color: var(--muted-foreground);
}

.card h3 {
  font-family: 'Source Serif 4', Georgia, serif;
  font-size: 20px;
  font-weight: 700;
  margin: 8px 0 6px;
}

.card p { font-size: 14px; color: var(--muted-foreground); margin: 0; }

/* ---- footer ---------------------------------------------------------- */

.site-footer {
  border-top: 1px solid var(--border);
  padding: 28px 24px 40px;
  font-size: 13px;
  color: var(--muted-foreground);
}

.site-footer .inner {
  max-width: 1120px;
  margin: 0 auto;
  display: flex;
  flex-wrap: wrap;
  gap: 8px 28px;
  align-items: center;
}

.site-footer a { color: inherit; text-decoration: none; }
.site-footer a:hover { color: var(--foreground); }
.site-footer .spacer { flex: 1; }

/* ---- responsive ------------------------------------------------------ */

@media (max-width: 860px) {
  .shell { grid-template-columns: minmax(0, 1fr); gap: 0; padding-top: 24px; }
  .sidebar {
    position: static;
    display: flex;
    flex-wrap: wrap;
    gap: 6px;
    padding-bottom: 18px;
    margin-bottom: 18px;
    border-bottom: 1px solid var(--border);
  }
  .sidebar .group { display: contents; }
  .sidebar .group-title { display: none; }
  .sidebar a { margin-left: 0; border: 1px solid var(--border); border-radius: 999px; padding: 5px 12px; }
  .hero h1 { font-size: 38px; }
  .brand .sub { display: none; }
}