/* ==========================================================================
   Docs / guides page
   ========================================================================== */

.docs-hero {
  padding: clamp(4rem, 8vw, 7rem) 0 clamp(2rem, 4vw, 3rem);
  text-align: center;
}
.docs-hero h1 {
  font-family: var(--font-display);
  font-size: clamp(2.5rem, 6vw, 4.5rem);
  font-weight: 300;
  letter-spacing: -0.04em;
  line-height: 1.05;
  margin: 0.5rem auto 1.5rem;
  max-width: 22ch;
}

/* Guide index — cards at top */
.guide-index {
  display: grid;
  grid-template-columns: repeat(auto-fill, minmax(280px, 1fr));
  gap: 1rem;
  max-width: 1200px;
  margin: 3rem auto 0;
}
.guide-index-card {
  display: block;
  padding: 1.5rem;
  background: var(--bg-card);
  border: 1px solid var(--border);
  border-radius: var(--radius-lg);
  text-decoration: none;
  color: inherit;
  transition: border-color var(--d-mid) var(--ease-out), transform var(--d-mid) var(--ease-out);
  min-width: 0;
}
.guide-index-card:hover {
  border-color: var(--border-accent);
  transform: translateY(-2px);
  color: inherit;
}
.guide-index-num {
  font-family: var(--font-mono);
  font-size: 0.7rem;
  letter-spacing: 0.08em;
  color: var(--accent-teal);
  margin-bottom: 0.85rem;
  display: block;
}
.guide-index-card h3 {
  font-family: var(--font-display);
  font-size: 1.25rem;
  font-weight: 500;
  letter-spacing: -0.015em;
  margin: 0 0 0.4rem;
  color: var(--text-primary);
}
.guide-index-card p {
  margin: 0 0 0.85rem;
  font-size: 0.9rem;
  color: var(--text-secondary);
  line-height: 1.55;
}
.guide-index-meta {
  display: flex;
  align-items: center;
  gap: 0.85rem;
  font-family: var(--font-mono);
  font-size: 0.7rem;
  color: var(--text-muted);
}
.guide-index-meta-item {
  display: inline-flex;
  align-items: center;
  gap: 0.35rem;
}

/* Individual guide article */
.guide-article {
  padding: clamp(3rem, 6vw, 5rem) 0;
  border-top: 1px solid var(--border);
  scroll-margin-top: 100px;
}
.guide-article-inner {
  max-width: 760px;
  margin: 0 auto;
}

.guide-eyebrow {
  display: flex;
  align-items: center;
  gap: 0.75rem;
  margin-bottom: 1rem;
}
.guide-eyebrow-num {
  font-family: var(--font-mono);
  font-size: 0.75rem;
  font-weight: 600;
  letter-spacing: 0.1em;
  color: var(--accent-teal);
  padding: 0.3rem 0.7rem;
  background: rgba(94, 234, 212, 0.08);
  border: 1px solid rgba(94, 234, 212, 0.2);
  border-radius: var(--radius-full);
}
.guide-eyebrow-time {
  font-family: var(--font-mono);
  font-size: 0.75rem;
  color: var(--text-muted);
  letter-spacing: 0.04em;
}

.guide-article h2 {
  font-family: var(--font-display);
  font-size: clamp(2rem, 4vw, 2.75rem);
  font-weight: 400;
  letter-spacing: -0.025em;
  margin: 0.5rem 0 1.25rem;
  line-height: 1.1;
}
.guide-article > .guide-article-inner > p {
  font-size: 1.1rem;
  line-height: 1.65;
  margin: 0 0 1.5rem;
}
.guide-article > .guide-article-inner > p:first-of-type {
  color: var(--text-primary);
  font-size: 1.15rem;
}
.guide-article h3 {
  font-family: var(--font-display);
  font-size: 1.5rem;
  font-weight: 500;
  letter-spacing: -0.02em;
  margin: 2.5rem 0 1rem;
}
.guide-article h4 {
  font-family: var(--font-body);
  font-size: 1.05rem;
  font-weight: 600;
  letter-spacing: -0.01em;
  margin: 1.5rem 0 0.5rem;
  color: var(--text-primary);
}
.guide-article ul, .guide-article ol {
  padding-left: 1.4rem;
  margin: 0.75rem 0 1.5rem;
  font-size: 1rem;
  line-height: 1.7;
  color: var(--text-secondary);
}
.guide-article li { margin-bottom: 0.5rem; }
.guide-article li strong { color: var(--text-primary); font-weight: 600; }

.guide-article pre {
  margin: 1rem 0 1.5rem;
}

.guide-callout {
  display: flex;
  gap: 0.85rem;
  padding: 1rem 1.25rem;
  background: rgba(94, 234, 212, 0.04);
  border: 1px solid var(--border-accent);
  border-left: 3px solid var(--accent-teal);
  border-radius: 0 var(--radius-md) var(--radius-md) 0;
  margin: 1.5rem 0;
  font-size: 0.95rem;
  line-height: 1.6;
  color: var(--text-secondary);
}
.guide-callout strong { color: var(--text-primary); }
.guide-callout svg { color: var(--accent-teal); flex-shrink: 0; margin-top: 2px; }
.guide-callout.warn {
  background: rgba(251, 191, 36, 0.04);
  border-color: rgba(251, 191, 36, 0.25);
  border-left-color: #fbbf24;
}
.guide-callout.warn svg { color: #fbbf24; }
.guide-callout.warn strong { color: #fbbf24; }

/* Step list (numbered, visually distinct from regular OL) */
.guide-steps {
  list-style: none;
  padding: 0;
  margin: 1.5rem 0;
  counter-reset: step-counter;
}
.guide-steps li {
  position: relative;
  padding: 1rem 1.25rem 1rem 3.5rem;
  margin: 0 0 0.75rem;
  background: var(--bg-card);
  border: 1px solid var(--border);
  border-radius: var(--radius-md);
  counter-increment: step-counter;
}
.guide-steps li::before {
  content: counter(step-counter);
  position: absolute;
  left: 1rem;
  top: 1rem;
  width: 24px;
  height: 24px;
  border-radius: 50%;
  background: rgba(94, 234, 212, 0.1);
  border: 1px solid var(--border-accent);
  color: var(--accent-teal);
  font-family: var(--font-mono);
  font-size: 0.8rem;
  font-weight: 700;
  display: flex;
  align-items: center;
  justify-content: center;
}
.guide-steps li p:first-child { margin-top: 0; }
.guide-steps li p:last-child { margin-bottom: 0; }
.guide-steps li strong { color: var(--text-primary); font-weight: 600; }

/* Continue-reading footer per guide */
.guide-continue {
  margin-top: 3rem;
  padding-top: 2rem;
  border-top: 1px solid var(--border);
  display: flex;
  justify-content: space-between;
  align-items: center;
  gap: 1rem;
  flex-wrap: wrap;
}
.guide-continue-label {
  font-family: var(--font-mono);
  font-size: 0.7rem;
  letter-spacing: 0.1em;
  text-transform: uppercase;
  color: var(--text-muted);
}