/**
 * Documentation Page Styles
 * File: public/css/doc.css
 *
 * Accent colours drawn from the site palette defined in style.css:
 *   --color-primary: #667eea  (periwinkle blue-purple)
 *   --color-gold:    #a39367  (warm gold)
 */

/* ============================================================
   Doc Accent Variables
   ============================================================ */

:root {
  --doc-accent:      #667eea;
  --doc-accent-dark: #1e1e1e;
}

/* ============================================================
   Page Layout
   ============================================================ */

.doc-page-body .container {
  max-width: 900px;
}

/* ============================================================
   Horizontal Doc Navigation (nav-pills)
   ============================================================ */

.doc-nav {
  margin-bottom: 2rem;
}

.doc-nav .nav-pills {
  gap: 0.5rem;
  flex-wrap: wrap;
}

.doc-nav .nav-link {
  color: var(--bs-secondary);
  padding: 0.4rem 1rem;
  border-radius: 2rem;
  font-size: 0.9rem;
  transition: background-color 0.2s, color 0.2s;
}

.doc-nav .nav-link:hover {
  background-color: var(--doc-accent-dark);
  color: #ffffff;
  font-weight: 600;
}

.doc-nav .nav-link.active {
  background-color: var(--doc-accent-dark);
  color: #ffffff;
  font-weight: 600;
}

/* ============================================================
   Documentation Content
   ============================================================ */

.doc-content {
  line-height: 1.8;
}

.doc-content h1 {
  text-align: center;
  border-bottom: 2px solid var(--doc-accent);
  padding-bottom: 0.5rem;
  margin-bottom: 0.25rem;
}

/* H2 subtitle that immediately follows H1 -- also centered */
.doc-content h1 + h2 {
  text-align: center;
  font-size: 1rem;
  font-weight: 400;
  color: var(--bs-secondary);
  margin-bottom: 2rem;
  border: none;
}

.doc-content h2 {
  margin-top: 2.5rem;
  padding-bottom: 0.3rem;
  border-bottom: 1px solid var(--bs-border-color);
  color: var(--doc-accent);
}

.doc-content h3 {
  margin-top: 1.75rem;
  color: var(--bs-emphasis-color);
}

.doc-content h4 {
  margin-top: 1.25rem;
}

.doc-content p {
  margin-bottom: 1rem;
}

/* ============================================================
   Blockquotes -- Push/Pop actions in scenarios
   ============================================================ */

.doc-content blockquote {
  border-left: 4px solid var(--doc-accent);
  padding: 0.5rem 1rem;
  margin: 1rem 0;
  border-radius: 0 4px 4px 0;
  background-color: var(--bs-tertiary-bg);
  color: var(--bs-body-color);
}

.doc-content blockquote p {
  margin-bottom: 0;
}

/* ============================================================
   Tables -- Quick Reference and scenario stack tables
   ============================================================ */

.doc-content table {
  width: 100%;
  border-collapse: collapse;
  margin: 1.25rem 0;
  font-size: 0.95rem;
}

.doc-content thead th {
  background-color: var(--doc-accent-dark);
  color: #ffffff;
  padding: 0.6rem 0.85rem;
  text-align: left;
  font-weight: 600;
}

.doc-content tbody td {
  padding: 0.55rem 0.85rem;
  border-bottom: 1px solid var(--bs-border-color);
  vertical-align: top;
}

.doc-content tbody tr:last-child td {
  border-bottom: none;
}

.doc-content tbody tr:nth-child(even) td {
  background-color: var(--bs-tertiary-bg);
}

/* ============================================================
   Code and Pre blocks
   ============================================================ */

.doc-content code {
  background-color: var(--bs-tertiary-bg);
  padding: 0.15rem 0.4rem;
  border-radius: 3px;
  font-size: 0.88em;
  color: var(--bs-emphasis-color);
}

.doc-content pre {
  background-color: var(--bs-tertiary-bg);
  border: 1px solid var(--bs-border-color);
  border-radius: 6px;
  padding: 1rem 1.25rem;
  overflow-x: auto;
  margin: 1.25rem 0;
}

.doc-content pre code {
  background: none;
  padding: 0;
  font-size: 0.9rem;
  color: var(--bs-body-color);
}

/* ============================================================
   Horizontal Rules -- section dividers
   ============================================================ */

.doc-content hr {
  border-color: var(--bs-border-color);
  margin: 2rem 0;
}

/* ============================================================
   Responsive
   ============================================================ */

@media (max-width: 576px) {
  .doc-nav .nav-link {
    font-size: 0.82rem;
    padding: 0.35rem 0.75rem;
  }

  .doc-content h1 {
    font-size: 1.5rem;
  }

  .doc-content h2 {
    font-size: 1.2rem;
  }

  .doc-content table {
    font-size: 0.85rem;
  }
}
