/* ─── Doc Template Styles ──────────────────────────────────────────────────
   Applies v2 look-and-feel to documentation / user-manual pages.
   Requires v2.css to be loaded first (for CSS custom properties).
   ────────────────────────────────────────────────────────────────────────── */

/* ── Breadcrumb bar ─────────────────────────────────────────────────────── */
.doc-breadcrumb-bar {
  background: var(--v2-bg2);
  border-bottom: 1px solid var(--v2-border);
  padding: 0.75rem 2rem;
}

.doc-breadcrumb {
  max-width: 1100px;
  margin: 0 auto;
  font-size: 0.82rem;
  color: var(--v2-text-muted);
  display: flex;
  align-items: center;
  gap: 0.35rem;
  flex-wrap: wrap;
}

.doc-breadcrumb-link {
  color: var(--v2-accent3);
  text-decoration: none;
}

.doc-breadcrumb-link:hover {
  color: var(--v2-accent);
  text-decoration: underline;
}

.doc-breadcrumb-sep {
  color: var(--v2-text-muted);
  user-select: none;
}

.doc-breadcrumb-current {
  color: var(--v2-text);
  font-weight: 600;
}

/* ── Page title hero ────────────────────────────────────────────────────── */
.doc-title-hero {
  background: var(--v2-bg3);
  border-bottom: 1px solid var(--v2-border);
  padding: 3rem 2rem 2.5rem;
}

.doc-title-hero-inner {
  max-width: 1100px;
  margin: 0 auto;
}

.doc-title-hero-label {
  font-size: 0.75rem;
  font-weight: 700;
  text-transform: uppercase;
  letter-spacing: 1.5px;
  color: var(--v2-accent2);
  margin-bottom: 0.75rem;
}

.doc-title-hero h1 {
  font-size: clamp(1.8rem, 3vw, 2.6rem);
  font-weight: 800;
  letter-spacing: -0.5px;
  color: #fff;
  margin: 0 0 1rem;
}

.doc-title-hero .doc-title-desc {
  font-size: 1.05rem;
  color: var(--v2-text-muted);
  line-height: 1.8;
  max-width: 760px;
  margin: 0;
}

/* ── Main content wrapper ───────────────────────────────────────────────── */
.doc-page-wrap {
  background: var(--v2-bg);
}

.doc-content {
  max-width: 1100px;
  margin: 0 auto;
  padding: 2.5rem 2rem 3rem;
}

/* Hide the in-content <header> h1 since we display it in doc-title-hero */
.doc-content > header {
  display: none;
}

/* ── Section blocks → v2 cards ──────────────────────────────────────────── */
.doc-content .section-block {
  background: var(--v2-bg3);
  border: 1px solid var(--v2-border);
  border-radius: var(--v2-radius);
  padding: 1.75rem;
  margin-bottom: 1.5rem;
}

.doc-content .section-block h2 {
  font-size: 1.15rem;
  font-weight: 700;
  color: var(--v2-accent2);
  margin-top: 0;
  margin-bottom: 1rem;
  padding-bottom: 0.75rem;
  border-bottom: 1px solid var(--v2-border);
}

.doc-content .section-block h3 {
  font-size: 1rem;
  font-weight: 700;
  color: var(--v2-text);
  margin-top: 1.25rem;
  margin-bottom: 0.6rem;
}

.doc-content .section-block p {
  color: var(--v2-text-muted);
  line-height: 1.8;
  margin-bottom: 0.75rem;
}

.doc-content .section-block ul,
.doc-content .section-block ol {
  color: var(--v2-text-muted);
  margin-left: 1.5rem;
  margin-bottom: 0.75rem;
  line-height: 1.8;
}

.doc-content .section-block li {
  margin-bottom: 0.4rem;
}

.doc-content .section-block a {
  color: var(--v2-accent3);
  text-decoration: underline;
}

.doc-content .section-block a:hover {
  color: var(--v2-accent);
}

.doc-content .section-block code,
.doc-content .section-block pre code {
  background: var(--v2-bg2);
  color: var(--v2-accent2);
  padding: 2px 6px;
  border-radius: 4px;
  font-size: 0.88em;
  font-family: 'Courier New', Courier, monospace;
}

.doc-content .section-block strong {
  color: var(--v2-text);
  font-weight: 700;
}

/* ── Subpage links → full-width stacked cards ───────────────────────────── */
.doc-content .subpagelinks {
  display: flex;
  flex-direction: column;
  gap: 1rem;
  margin: 0 0 1.5rem;
}

.doc-content .subpagelink {
  background: var(--v2-bg3);
  border: 1px solid var(--v2-border);
  border-left: 3px solid var(--v2-accent3);
  border-radius: var(--v2-radius);
  padding: 1.25rem 1.5rem;
  transition: border-color 0.2s, transform 0.2s, box-shadow 0.2s;
  margin-bottom: 0;
  border-bottom: 1px solid var(--v2-border); /* override main.css */
}

.doc-content .subpagelink:hover {
  border-color: var(--v2-accent);
  border-left-color: var(--v2-accent);
  transform: translateY(-2px);
  box-shadow: 0 6px 24px rgba(90, 145, 224, 0.12);
}

.doc-content .subpagelink a {
  font-size: 1.05rem;
  font-weight: 700;
  color: #fff;
  text-decoration: none;
  display: block;
  margin-bottom: 0.5rem;
  background: none;
  padding: 0;
}

.doc-content .subpagelink a:hover {
  color: var(--v2-accent);
  text-decoration: underline;
  background: none;
}

.doc-content .subpagelink p {
  font-size: 0.9rem;
  color: var(--v2-text-muted) !important;
  line-height: 1.7;
  margin: 0;
}

/* ── Copy button ────────────────────────────────────────────────────────── */
.copy-btn {
  background: var(--v2-accent3);
  color: var(--v2-text);
  border: none;
  border-radius: 6px;
  padding: 6px 14px;
  cursor: pointer;
  font-size: 0.85rem;
  transition: background 0.2s;
}

.copy-btn:hover,
.copy-btn.copied {
  background: var(--v2-button-hover);
  color: var(--v2-text);
}

/* ── Back navigation ────────────────────────────────────────────────────── */
.doc-back-nav {
  background: var(--v2-bg2);
  border-top: 1px solid var(--v2-border);
  padding: 2rem;
}

.doc-back-nav-inner {
  max-width: 1100px;
  margin: 0 auto;
  display: flex;
  align-items: center;
  gap: 1rem;
  flex-wrap: wrap;
}

.doc-back-nav .section-label {
  font-size: 0.75rem;
  font-weight: 700;
  text-transform: uppercase;
  letter-spacing: 1.5px;
  color: var(--v2-accent2);
  margin-right: 0.5rem;
}

/* ── Legal prose typography ─────────────────────────────────────────────── */
.legal-prose {
  max-width: 860px;
  color: var(--v2-text-muted);
  line-height: 1.8;
}

.legal-prose h2 {
  font-size: 1.15rem;
  font-weight: 700;
  color: var(--v2-accent2);
  margin: 2rem 0 0.75rem;
  padding-bottom: 0.5rem;
  border-bottom: 1px solid var(--v2-border);
}

.legal-prose h3 {
  font-size: 1rem;
  font-weight: 700;
  color: var(--v2-text);
  margin: 1.25rem 0 0.5rem;
}

.legal-prose h4 {
  font-size: 0.95rem;
  font-weight: 600;
  color: var(--v2-text);
  margin: 1rem 0 0.4rem;
}

.legal-prose p {
  margin-bottom: 0.85rem;
}

.legal-prose ul,
.legal-prose ol {
  margin-left: 1.5rem;
  margin-bottom: 0.85rem;
}

.legal-prose li {
  margin-bottom: 0.4rem;
}

.legal-prose a {
  color: var(--v2-accent3);
  text-decoration: underline;
}

.legal-prose a:hover {
  color: var(--v2-accent);
}

.legal-prose strong {
  color: var(--v2-text);
  font-weight: 700;
}

.legal-prose img {
  max-width: 100%;
  height: auto;
  margin: 1rem 0;
}

/* ── Responsive ─────────────────────────────────────────────────────────── */
@media (max-width: 768px) {
  .doc-breadcrumb-bar {
    padding: 0.75rem 1rem;
  }

  .doc-title-hero {
    padding: 2rem 1rem 1.5rem;
  }

  .doc-content {
    padding: 1.5rem 1rem 2rem;
  }


  .doc-back-nav {
    padding: 1.5rem 1rem;
  }
}