/* ==========================================================================
   Clerkify Engineering Documentation — stylesheet
   Palette, type scale and layout for the static docs site.
   ========================================================================== */

:root {
  /* Light theme (default) */
  --paper: #F7F6F2;
  --surface: #FFFFFF;
  --surface-2: #EFEDE7;
  --sidebar: #F1EFE9;
  --ink: #10151F;
  --ink-soft: #3C4454;
  --muted: #6A7285;
  --rule: #DCD9D1;
  --accent: #26456E;
  --accent-dim: #E3E8F0;
  --crit: #9E2B25;
  --crit-bg: #F6E7E5;
  --warn: #9A6510;
  --warn-bg: #F7EEDC;
  --ok: #2C6A4F;
  --ok-bg: #E3EFE7;

  --serif: ui-serif, "Iowan Old Style", "Palatino Linotype", Palatino, "Book Antiqua", Georgia, serif;
  --sans: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif;
  --mono: ui-monospace, SFMono-Regular, "SF Mono", Menlo, Consolas, monospace;

  --sidebar-w: 16rem;
}

@media (prefers-color-scheme: dark) {
  :root {
    --paper: #0E1219;
    --surface: #161B25;
    --surface-2: #1D232F;
    --sidebar: #121722;
    --ink: #E8E9EC;
    --ink-soft: #B6BCC8;
    --muted: #838B9B;
    --rule: #2A313E;
    --accent: #8FB2DF;
    --accent-dim: #1C2836;
    --crit: #E08A82;
    --crit-bg: #2E1D1C;
    --warn: #D8A653;
    --warn-bg: #2C2417;
    --ok: #7FBF9C;
    --ok-bg: #172619;
  }
}

/* Explicit toggle must beat the media query in both directions */
:root[data-theme="dark"] {
  --paper: #0E1219;
  --surface: #161B25;
  --surface-2: #1D232F;
  --sidebar: #121722;
  --ink: #E8E9EC;
  --ink-soft: #B6BCC8;
  --muted: #838B9B;
  --rule: #2A313E;
  --accent: #8FB2DF;
  --accent-dim: #1C2836;
  --crit: #E08A82;
  --crit-bg: #2E1D1C;
  --warn: #D8A653;
  --warn-bg: #2C2417;
  --ok: #7FBF9C;
  --ok-bg: #172619;
}

:root[data-theme="light"] {
  --paper: #F7F6F2;
  --surface: #FFFFFF;
  --surface-2: #EFEDE7;
  --sidebar: #F1EFE9;
  --ink: #10151F;
  --ink-soft: #3C4454;
  --muted: #6A7285;
  --rule: #DCD9D1;
  --accent: #26456E;
  --accent-dim: #E3E8F0;
  --crit: #9E2B25;
  --crit-bg: #F6E7E5;
  --warn: #9A6510;
  --warn-bg: #F7EEDC;
  --ok: #2C6A4F;
  --ok-bg: #E3EFE7;
}

*,
*::before,
*::after { box-sizing: border-box; }

html { scroll-behavior: smooth; }

body {
  margin: 0;
  background: var(--paper);
  color: var(--ink);
  font-family: var(--sans);
  font-size: 16px;
  line-height: 1.65;
  -webkit-font-smoothing: antialiased;
}

/* ---------- shell ---------- */

.shell {
  display: grid;
  grid-template-columns: var(--sidebar-w) minmax(0, 1fr);
  align-items: start;
}

/* ---------- access gate ---------- */
/* Content stays hidden until docs.js confirms the access code, so there is
   no flash of the page before the gate JS runs. */

html:not(.docs-unlocked) .shell {
  visibility: hidden;
}

.docs-gate {
  position: fixed;
  inset: 0;
  z-index: 100;
  display: flex;
  align-items: center;
  justify-content: center;
  background: var(--paper);
  padding: 1.5rem;
}

.docs-gate-box {
  width: 100%;
  max-width: 22rem;
  background: var(--surface);
  border: 1px solid var(--rule);
  border-radius: 0.5rem;
  padding: 2rem 1.75rem;
  text-align: center;
  box-shadow: 0 1px 3px rgba(0, 0, 0, 0.08);
}

.docs-gate-brand {
  margin: 0 0 0.25rem;
  font-family: var(--serif);
  font-size: 1.1rem;
  font-weight: 600;
  color: var(--accent);
}

.docs-gate-title {
  margin: 0 0 0.35rem;
  font-weight: 600;
}

.docs-gate-sub {
  margin: 0 0 1.25rem;
  color: var(--muted);
  font-size: 0.9rem;
}

.docs-gate-input {
  width: 100%;
  padding: 0.6rem 0.75rem;
  border: 1px solid var(--rule);
  border-radius: 0.35rem;
  background: var(--surface-2);
  color: var(--ink);
  font-size: 1rem;
  text-align: center;
  letter-spacing: 0.15em;
}

.docs-gate-input:focus {
  outline: 2px solid var(--accent);
  outline-offset: 1px;
}

.docs-gate-box button {
  width: 100%;
  margin-top: 0.75rem;
  padding: 0.6rem 0.75rem;
  border: 0;
  border-radius: 0.35rem;
  background: var(--accent);
  color: var(--surface);
  font-size: 0.95rem;
  font-weight: 600;
  cursor: pointer;
}

.docs-gate-box button:hover { opacity: 0.9; }

.docs-gate-error {
  margin: 0.75rem 0 0;
  color: var(--crit);
  font-size: 0.85rem;
}

/* ---------- sidebar ---------- */

.side {
  position: sticky;
  top: 0;
  height: 100vh;
  overflow-y: auto;
  background: var(--sidebar);
  border-right: 1px solid var(--rule);
  padding: 2rem 1.25rem 3rem;
}

.brand {
  font-family: var(--serif);
  font-size: 1.3rem;
  font-weight: 600;
  letter-spacing: -0.015em;
  margin: 0 0 0.15rem;
}
.brand a { color: inherit; text-decoration: none; }

.brand-sub {
  font-family: var(--mono);
  font-size: 0.64rem;
  letter-spacing: 0.13em;
  text-transform: uppercase;
  color: var(--muted);
  margin: 0 0 1.5rem;
}

.theme-toggle {
  font: inherit;
  font-size: 0.75rem;
  background: none;
  border: 1px solid var(--rule);
  color: var(--ink-soft);
  border-radius: 3px;
  padding: 0.3rem 0.6rem;
  cursor: pointer;
  margin-bottom: 1.5rem;
}
.theme-toggle:hover { background: var(--surface-2); color: var(--ink); }

.nav-group {
  font-family: var(--mono);
  font-size: 0.62rem;
  letter-spacing: 0.13em;
  text-transform: uppercase;
  color: var(--muted);
  margin: 1.5rem 0 0.5rem;
}
.nav-group:first-of-type { margin-top: 0; }

.side nav ul {
  list-style: none;
  margin: 0;
  padding: 0;
  display: flex;
  flex-direction: column;
  gap: 1px;
}

.side nav a {
  display: flex;
  align-items: baseline;
  gap: 0.5rem;
  font-size: 0.88rem;
  color: var(--ink-soft);
  text-decoration: none;
  border-radius: 3px;
  padding: 0.4rem 0.55rem;
  line-height: 1.35;
}
.side nav a:hover { background: var(--surface-2); color: var(--ink); }
.side nav a[aria-current="page"] {
  background: var(--accent-dim);
  color: var(--accent);
  font-weight: 650;
}

.nav-n {
  font-family: var(--mono);
  font-size: 0.7rem;
  color: var(--muted);
  font-variant-numeric: tabular-nums;
}
.side nav a[aria-current="page"] .nav-n { color: var(--accent); }

/* ---------- main ---------- */

main {
  padding: 3.5rem 3rem 7rem;
  max-width: 60rem;
}

.eyebrow {
  font-family: var(--mono);
  font-size: 0.68rem;
  letter-spacing: 0.14em;
  text-transform: uppercase;
  color: var(--accent);
  margin: 0 0 0.6rem;
}

h1 {
  font-family: var(--serif);
  font-weight: 600;
  font-size: clamp(1.9rem, 4vw, 2.6rem);
  line-height: 1.12;
  letter-spacing: -0.02em;
  text-wrap: balance;
  margin: 0 0 0.75rem;
}

.lede {
  font-family: var(--serif);
  font-size: 1.12rem;
  line-height: 1.55;
  color: var(--ink-soft);
  max-width: 38rem;
  margin: 0 0 2rem;
}

h2 {
  font-family: var(--serif);
  font-size: 1.45rem;
  font-weight: 600;
  letter-spacing: -0.015em;
  text-wrap: balance;
  margin: 2.75rem 0 0.5rem;
  padding-top: 1.5rem;
  border-top: 1px solid var(--rule);
}
h2:first-of-type { border-top: 0; padding-top: 0; }

h3 {
  font-size: 1rem;
  font-weight: 650;
  margin: 1.75rem 0 0.4rem;
}

p { margin: 0 0 1rem; max-width: 42rem; }

ul, ol { margin: 0 0 1rem; padding-left: 1.15rem; max-width: 42rem; }
li { margin-bottom: 0.4rem; }
li::marker { color: var(--muted); }

a { color: var(--accent); text-underline-offset: 2px; }
a:focus-visible,
button:focus-visible {
  outline: 2px solid var(--accent);
  outline-offset: 2px;
  border-radius: 2px;
}

strong { font-weight: 650; }

code {
  font-family: var(--mono);
  font-size: 0.85em;
  background: var(--surface-2);
  padding: 0.1em 0.35em;
  border-radius: 3px;
  word-break: break-word;
}

pre.code {
  font-family: var(--mono);
  font-size: 0.8rem;
  line-height: 1.6;
  background: var(--surface);
  border: 1px solid var(--rule);
  border-radius: 4px;
  padding: 1rem 1.15rem;
  overflow-x: auto;
  margin: 1.15rem 0;
}
pre.code code { background: none; padding: 0; font-size: 1em; }

/* ---------- diagrams ---------- */

.mermaid {
  background: var(--surface);
  border: 1px solid var(--rule);
  border-radius: 4px;
  padding: 1.5rem 1rem;
  margin: 1.35rem 0;
  overflow-x: auto;
  text-align: center;
}
/* Hide raw definition text until mermaid has rendered it */
.mermaid:not([data-processed]) { color: transparent; min-height: 6rem; }

.fig {
  font-family: var(--mono);
  font-size: 0.68rem;
  letter-spacing: 0.09em;
  text-transform: uppercase;
  color: var(--muted);
  margin: -0.6rem 0 1.6rem;
}

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

.t-scroll { overflow-x: auto; margin: 1.25rem 0; }

table {
  border-collapse: collapse;
  width: 100%;
  min-width: 34rem;
  font-size: 0.88rem;
}
th, td {
  text-align: left;
  padding: 0.6rem 0.9rem 0.6rem 0;
  border-bottom: 1px solid var(--rule);
  vertical-align: top;
}
th {
  font-family: var(--mono);
  font-size: 0.66rem;
  letter-spacing: 0.11em;
  text-transform: uppercase;
  color: var(--muted);
  font-weight: 600;
  border-bottom-color: var(--ink);
}
td.num {
  font-family: var(--mono);
  font-variant-numeric: tabular-nums;
  white-space: nowrap;
}

/* ---------- callouts ---------- */

.callout {
  background: var(--surface-2);
  border-top: 3px solid var(--accent);
  border-radius: 3px;
  padding: 1.2rem 1.35rem;
  margin: 1.5rem 0;
  max-width: 42rem;
}
.callout.warn { border-top-color: var(--warn); }
.callout p:last-child { margin-bottom: 0; }

.callout-t {
  font-family: var(--serif);
  font-size: 1.08rem;
  font-weight: 600;
  margin: 0 0 0.5rem;
}

/* ---------- pills ---------- */

.pill {
  font-family: var(--mono);
  font-size: 0.63rem;
  letter-spacing: 0.11em;
  text-transform: uppercase;
  font-weight: 600;
  padding: 0.2rem 0.5rem;
  border-radius: 2px;
  white-space: nowrap;
  display: inline-block;
}
.pill.crit { background: var(--crit-bg); color: var(--crit); }
.pill.warn { background: var(--warn-bg); color: var(--warn); }
.pill.ok   { background: var(--ok-bg);   color: var(--ok); }
.pill.note { background: var(--accent-dim); color: var(--accent); }

/* ---------- card grid ---------- */

.cards {
  display: grid;
  grid-template-columns: repeat(auto-fit, minmax(15rem, 1fr));
  gap: 1px;
  background: var(--rule);
  border: 1px solid var(--rule);
  border-radius: 4px;
  overflow: hidden;
  margin: 1.5rem 0;
}
.card { background: var(--surface); padding: 1.1rem 1.2rem; }
.card-t { font-weight: 650; font-size: 0.95rem; margin: 0 0 0.3rem; }
.card p { font-size: 0.88rem; color: var(--ink-soft); margin: 0; }

/* ---------- numbered steps ---------- */

.step {
  display: grid;
  grid-template-columns: 2.4rem 1fr;
  gap: 0 0.85rem;
  padding: 1rem 0;
  border-bottom: 1px solid var(--rule);
  max-width: 44rem;
}
.step-n {
  font-family: var(--mono);
  font-size: 0.78rem;
  font-weight: 600;
  color: var(--accent);
  padding-top: 0.15rem;
  font-variant-numeric: tabular-nums;
}
.step-t { font-weight: 650; margin-bottom: 0.2rem; }
.step p { font-size: 0.9rem; color: var(--ink-soft); margin: 0 0 0.35rem; }
.step p:last-child { margin-bottom: 0; }
.step-meta {
  font-family: var(--mono);
  font-size: 0.68rem;
  color: var(--muted);
  letter-spacing: 0.04em;
}

/* ---------- pager ---------- */

.pager {
  display: flex;
  justify-content: space-between;
  gap: 1rem;
  margin-top: 3.5rem;
  padding-top: 1.5rem;
  border-top: 1px solid var(--rule);
  max-width: 44rem;
}
.pager a {
  font-size: 0.88rem;
  text-decoration: none;
  border: 1px solid var(--rule);
  border-radius: 3px;
  padding: 0.55rem 0.95rem;
  color: var(--accent);
  background: var(--surface);
}
.pager a:hover { background: var(--surface-2); }
.pager .spacer { flex: 1; }

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

@media (max-width: 900px) {
  .shell { grid-template-columns: 1fr; }
  .side {
    position: static;
    height: auto;
    border-right: 0;
    border-bottom: 1px solid var(--rule);
    padding: 1.5rem 1.25rem;
  }
  .side nav ul {
    display: grid;
    grid-template-columns: repeat(auto-fit, minmax(11rem, 1fr));
  }
  main { padding: 2.25rem 1.25rem 4rem; }
}

@media (prefers-reduced-motion: reduce) {
  html { scroll-behavior: auto; }
  * { animation: none !important; transition: none !important; }
}

/* ---------- print ---------- */

@media print {
  .side, .pager, .theme-toggle { display: none; }
  .shell { display: block; }
  main { padding: 0; max-width: none; }
  h2 { break-after: avoid; }
  .mermaid, .callout, .step, table { break-inside: avoid; }
}