/* Shared styles for human-readable doc pages (user guide, tutorial). */
:root {
  color-scheme: light;
  --bg: #ffffff;
  --bg-soft: #fafafa;
  --border: #e5e5e5;
  --text: #171717;
  --muted: #525252;
  --dim: #737373;
  --accent: #a16207;
  --accent-soft: #fef3c7;
  --callout: #fffbeb;
  --callout-border: #fcd34d;
}

* {
  box-sizing: border-box;
}

html,
body {
  margin: 0;
  min-height: 100%;
}

body {
  display: flex;
  flex-direction: column;
  min-height: 100vh;
  background:
    radial-gradient(circle at top right, rgba(254, 243, 199, 0.65), transparent 42%),
    var(--bg);
  color: var(--text);
  font-family: ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI",
    Roboto, sans-serif;
  line-height: 1.55;
}

.wrap {
  width: min(760px, calc(100% - 2rem));
  margin: 0 auto;
}

.doc-header {
  border-bottom: 1px solid var(--border);
  background: rgba(255, 255, 255, 0.9);
  backdrop-filter: blur(8px);
  position: sticky;
  top: 0;
  z-index: 5;
}

.doc-header-inner {
  display: flex;
  align-items: center;
  justify-content: space-between;
  gap: 1rem;
  padding: 0.9rem 0;
}

.brand {
  font-weight: 700;
  color: var(--text);
  text-decoration: none;
  font-size: 1.05rem;
}

.brand span {
  color: var(--accent);
}

.nav-links {
  display: flex;
  flex-wrap: wrap;
  gap: 0.75rem 1rem;
  font-size: 0.875rem;
}

.nav-links a {
  color: var(--muted);
  text-decoration: none;
}

.nav-links a:hover,
.nav-links a[aria-current="page"] {
  color: var(--accent);
}

main {
  flex: 1;
  padding: 2rem 0 3.5rem;
}

h1 {
  font-size: clamp(1.75rem, 3vw, 2.25rem);
  letter-spacing: -0.03em;
  margin: 0 0 0.5rem;
}

.meta {
  color: var(--dim);
  font-size: 0.875rem;
  margin: 0 0 1.25rem;
}

.lede {
  font-size: 1.05rem;
  color: var(--muted);
  margin: 0 0 2rem;
}

h2 {
  font-size: 1.25rem;
  margin: 2.25rem 0 0.75rem;
  letter-spacing: -0.02em;
}

h3 {
  font-size: 1.05rem;
  margin: 1.5rem 0 0.5rem;
}

p,
li {
  color: var(--muted);
}

p {
  margin: 0.65rem 0;
}

ul,
ol {
  margin: 0.5rem 0 1rem;
  padding-left: 1.25rem;
}

li + li {
  margin-top: 0.35rem;
}

a {
  color: var(--accent);
}

table {
  width: 100%;
  border-collapse: collapse;
  margin: 1rem 0 1.5rem;
  font-size: 0.9375rem;
}

th,
td {
  border: 1px solid var(--border);
  padding: 0.65rem 0.75rem;
  text-align: left;
  vertical-align: top;
}

th {
  background: var(--bg-soft);
  color: var(--text);
  font-weight: 600;
}

.callout {
  margin: 1.25rem 0;
  padding: 1rem 1.1rem;
  border: 1px solid var(--callout-border);
  border-radius: 0.75rem;
  background: var(--callout);
}

.callout strong {
  color: var(--text);
}

.callout p:first-child {
  margin-top: 0;
}

.callout p:last-child {
  margin-bottom: 0;
}

.cta-row {
  display: flex;
  flex-wrap: wrap;
  gap: 0.75rem;
  margin: 1.25rem 0 0;
}

.btn {
  display: inline-flex;
  align-items: center;
  justify-content: center;
  padding: 0.65rem 1rem;
  border-radius: 0.65rem;
  font-weight: 600;
  font-size: 0.9rem;
  text-decoration: none;
}

.btn-primary {
  background: var(--accent);
  color: #fff;
}

.btn-primary:hover {
  filter: brightness(0.95);
}

.btn-secondary {
  border: 1px solid var(--border);
  background: #fff;
  color: var(--text);
}

.btn-secondary:hover {
  background: var(--bg-soft);
}

code {
  font-family: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace;
  font-size: 0.85em;
  background: var(--bg-soft);
  border: 1px solid var(--border);
  border-radius: 0.3rem;
  padding: 0.05rem 0.3rem;
}

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

@media (max-width: 640px) {
  .doc-header-inner {
    flex-direction: column;
    align-items: flex-start;
  }
}
