/* ── DOCS SECTION STYLES ───────────────────────────────── */

/* Hero banner (docs index page) */
.docs-hero {
  background: var(--paper-warm);
  padding: 4rem 0 3rem;
  border-bottom: 1px solid var(--border-light);
}
.docs-hero h1 {
  font-size: clamp(2rem, 4vw, 2.75rem);
  font-weight: 700;
  letter-spacing: -0.02em;
  margin-bottom: .75rem;
  margin-top: .5rem;
}
.docs-hero p {
  font-size: 1.05rem;
  color: var(--muted);
  max-width: 560px;
  font-weight: 300;
  margin: 0;
}

/* Guide cards grid */
.docs-grid {
  padding: 4rem 0 5rem;
}
.guide-card {
  display: flex;
  flex-direction: column;
  background: #fff;
  border: 1px solid var(--border-light);
  border-radius: 1rem;
  padding: 1.75rem;
  text-decoration: none;
  color: var(--ink);
  height: 100%;
  transition: transform .2s, box-shadow .2s, border-color .2s;
  position: relative;
  overflow: hidden;
}
.guide-card::before {
  content: '';
  position: absolute;
  top: 0; left: 0; right: 0;
  height: 3px;
  background: var(--primary);
  transform: scaleX(0);
  transform-origin: left;
  transition: transform .3s ease;
}
[dir="rtl"] .guide-card::before { transform-origin: right; }
.guide-card:hover {
  transform: translateY(-4px);
  box-shadow: 0 10px 36px rgba(79,85,193,.12);
  border-color: rgba(79,85,193,.2);
  color: var(--ink);
}
.guide-card:hover::before { transform: scaleX(1); }

.guide-card-icon {
  font-size: 2rem;
  display: block;
  margin-bottom: 1rem;
}
.guide-card h3 {
  font-size: 1.1rem;
  font-weight: 700;
  margin-bottom: .4rem;
}
.guide-card p {
  font-size: .9rem;
  color: var(--muted);
  line-height: 1.6;
  margin: 0 0 1.25rem;
  font-weight: 300;
  flex: 1;
}
.guide-card .read-link {
  font-size: .85rem;
  font-weight: 600;
  color: var(--primary);
  margin-top: auto;
}

/* ── SINGLE GUIDE ──────────────────────────────────────── */

.docs-article-hero {
  background: var(--paper-warm);
  padding: 3rem 0 2.5rem;
  border-bottom: 1px solid var(--border-light);
}

.docs-breadcrumb {
  display: flex;
  align-items: center;
  gap: .5rem;
  font-size: .8rem;
  color: var(--muted);
  margin-bottom: 1.5rem;
  flex-wrap: wrap;
}
.docs-breadcrumb a {
  color: var(--muted);
  transition: color .2s;
}
.docs-breadcrumb a:hover { color: var(--primary); }
.docs-breadcrumb .sep { opacity: .35; }

.docs-article-hero h1 {
  font-size: clamp(1.75rem, 4vw, 2.5rem);
  font-weight: 700;
  letter-spacing: -0.02em;
  margin-bottom: .5rem;
  margin-top: 0;
}
.docs-article-hero .docs-desc {
  font-size: 1rem;
  color: var(--muted);
  font-weight: 300;
  margin-top: .5rem;
  margin-bottom: 0;
}
.docs-article-meta {
  display: flex;
  align-items: center;
  gap: 1rem;
  margin-top: .85rem;
  font-size: .82rem;
  color: var(--muted);
}
.docs-article-meta .meta-tag {
  display: inline-flex;
  align-items: center;
  gap: .3rem;
  background: var(--primary-pale);
  color: var(--primary);
  font-weight: 600;
  padding: .2rem .65rem;
  border-radius: 1rem;
}

/* ── ARTICLE PROSE ─────────────────────────────────────── */
.docs-body {
  padding: 3.5rem 0 5rem;
}

.docs-prose {
  font-size: 1rem;
  line-height: 1.82;
  color: #374151;
  max-width: 720px;
}

.docs-prose h2 {
  font-size: 1.4rem;
  font-weight: 700;
  color: var(--ink);
  margin: 2.5rem 0 .75rem;
  padding-top: 1.5rem;
  border-top: 1px solid var(--border-light);
}
.docs-prose h2:first-child {
  border-top: none;
  margin-top: 0;
  padding-top: 0;
}
.docs-prose h3 {
  font-size: 1.1rem;
  font-weight: 700;
  color: var(--ink);
  margin: 1.75rem 0 .5rem;
}
.docs-prose p {
  margin-bottom: 1.1rem;
  font-weight: 300;
}
.docs-prose ul, .docs-prose ol {
  padding-left: 1.5rem;
  margin-bottom: 1.1rem;
}
[dir="rtl"] .docs-prose ul,
[dir="rtl"] .docs-prose ol {
  padding-left: 0;
  padding-right: 1.5rem;
}
.docs-prose li { margin-bottom: .35rem; font-weight: 300; }
.docs-prose strong { font-weight: 600; color: var(--ink); }
.docs-prose em { font-style: italic; }
.docs-prose a { color: var(--primary); text-decoration: underline; text-underline-offset: 2px; }
.docs-prose a:hover { color: var(--primary-dark); }

.docs-prose hr {
  border: none;
  border-top: 1px solid var(--border-light);
  margin: 2rem 0;
}

/* Inline code */
.docs-prose code {
  background: var(--paper-warm);
  border: 1px solid var(--border-light);
  border-radius: .3rem;
  padding: .1rem .4rem;
  font-size: .875em;
  font-family: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace;
  color: var(--primary);
}

/* Code blocks */
.docs-prose pre {
  background: var(--ink);
  border-radius: .75rem;
  padding: 1.25rem 1.5rem;
  margin: 1.25rem 0;
  overflow-x: auto;
}
.docs-prose pre code {
  background: none;
  border: none;
  padding: 0;
  font-size: .875rem;
  color: #e2e8f0;
  font-family: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace;
}

/* Blockquote */
.docs-prose blockquote {
  border-left: 3px solid var(--primary);
  margin-left: 0;
  padding-left: 1.25rem;
  color: var(--muted);
  font-style: italic;
}
[dir="rtl"] .docs-prose blockquote {
  border-left: none;
  border-right: 3px solid var(--primary);
  margin-left: 0;
  margin-right: 0;
  padding-left: 0;
  padding-right: 1.25rem;
}

/* Back link */
.docs-back {
  display: inline-flex;
  align-items: center;
  gap: .4rem;
  font-size: .9rem;
  font-weight: 600;
  color: var(--primary);
  margin-top: 2.5rem;
  padding-top: 2rem;
  border-top: 1px solid var(--border-light);
  width: 100%;
}
.docs-back:hover { color: var(--primary-dark); }

/* Hebrew font for docs */
[dir="rtl"] .docs-hero h1,
[dir="rtl"] .docs-article-hero h1,
[dir="rtl"] .docs-prose h2,
[dir="rtl"] .docs-prose h3 {
  font-family: "Noto Sans Hebrew", system-ui, sans-serif;
  font-optical-sizing: auto;
  font-weight: 800;
  letter-spacing: -0.01em;
}

@media (max-width: 767px) {
  .docs-hero { padding: 3rem 0 2rem; }
  .docs-grid { padding: 2.5rem 0 3.5rem; }
  .docs-body { padding: 2.5rem 0 3.5rem; }
  .docs-article-hero { padding: 2rem 0 1.75rem; }
}