/* ============================================================
   COMPONENTS
   ============================================================ */

/* ---- SITE HEADER ----------------------------------------- */
.site-header {
  position: sticky;
  top: 0;
  z-index: 100;
  height: var(--header-height);
  background: rgba(255, 255, 255, 0.95);
  backdrop-filter: blur(8px);
  -webkit-backdrop-filter: blur(8px);
  border-bottom: 1px solid var(--color-border);
  box-shadow: var(--shadow-sm);
}
.header-inner {
  max-width: var(--max-width-wide);
  margin: 0 auto;
  height: 100%;
  display: flex;
  align-items: center;
  justify-content: space-between;
  padding: 0 var(--space-6);
  gap: var(--space-4);
}
.site-logo {
  display: flex;
  align-items: center;
  gap: var(--space-3);
  text-decoration: none;
  color: var(--color-green-700);
  font-weight: var(--weight-bold);
  font-size: var(--text-lg);
  white-space: nowrap;
  flex-shrink: 0;
  transition: color var(--transition-fast);
}
.site-logo:hover { color: var(--color-green-500); text-decoration: none; }
.site-logo svg { width: 2rem; height: 2rem; flex-shrink: 0; }
.logo-text { display: flex; flex-direction: column; line-height: 1.1; }
.logo-text .logo-title { font-size: var(--text-base); font-weight: var(--weight-bold); color: var(--color-green-800); }
.logo-text .logo-sub   { font-size: var(--text-xs); font-weight: var(--weight-medium); color: var(--color-neutral-500); }

/* Main nav */
.site-nav { display: flex; align-items: center; gap: var(--space-2); }
.nav-link {
  display: flex;
  align-items: center;
  gap: var(--space-2);
  padding: var(--space-2) var(--space-3);
  border-radius: var(--radius-md);
  color: var(--color-neutral-700);
  text-decoration: none;
  font-size: var(--text-sm);
  font-weight: var(--weight-medium);
  transition: color var(--transition-fast), background var(--transition-fast);
  white-space: nowrap;
}
.nav-link:hover { color: var(--color-green-700); background: var(--color-green-50); text-decoration: none; }
.nav-link.active, .nav-link[aria-current="page"] {
  color: var(--color-green-700);
  background: var(--color-green-100);
  font-weight: var(--weight-semibold);
}
.nav-link svg { width: 1.1rem; height: 1.1rem; flex-shrink: 0; }

/* Hamburger */
.menu-toggle {
  display: none;
  flex-direction: column;
  justify-content: center;
  gap: 5px;
  width: 2.25rem;
  height: 2.25rem;
  padding: var(--space-2);
  border-radius: var(--radius-md);
  transition: background var(--transition-fast);
}
.menu-toggle:hover { background: var(--color-green-100); }
.menu-toggle span {
  display: block;
  width: 100%;
  height: 2px;
  background: var(--color-neutral-700);
  border-radius: 2px;
  transition: transform var(--transition-base), opacity var(--transition-base);
}
.menu-toggle[aria-expanded="true"] span:nth-child(1) { transform: translateY(7px) rotate(45deg); }
.menu-toggle[aria-expanded="true"] span:nth-child(2) { opacity: 0; }
.menu-toggle[aria-expanded="true"] span:nth-child(3) { transform: translateY(-7px) rotate(-45deg); }

@media (max-width: 768px) {
  .menu-toggle { display: flex; }
  .site-nav {
    display: none;
    position: absolute;
    top: var(--header-height);
    left: 0;
    right: 0;
    flex-direction: column;
    align-items: stretch;
    background: var(--color-white);
    border-bottom: 1px solid var(--color-border);
    padding: var(--space-3) var(--space-4);
    box-shadow: var(--shadow-md);
    gap: var(--space-1);
  }
  .site-nav.is-open { display: flex; }
  .nav-link { padding: var(--space-3) var(--space-4); }
}

/* ---- SITE FOOTER ----------------------------------------- */
.site-footer {
  background: var(--color-neutral-900);
  color: var(--color-neutral-300);
  padding: var(--space-12) var(--space-6) var(--space-8);
  margin-top: auto;
}
.footer-inner {
  max-width: var(--max-width-wide);
  margin: 0 auto;
  display: grid;
  grid-template-columns: repeat(auto-fit, minmax(200px, 1fr));
  gap: var(--space-8);
  margin-bottom: var(--space-8);
}
.footer-section h3 {
  color: var(--color-white);
  font-size: var(--text-sm);
  font-weight: var(--weight-semibold);
  letter-spacing: 0.08em;
  text-transform: uppercase;
  margin-bottom: var(--space-4);
  margin-top: 0;
  border-bottom: none;
  padding-bottom: 0;
}
.footer-links { list-style: none; padding: 0; margin: 0; }
.footer-links li { margin-bottom: var(--space-2); }
.footer-links a {
  color: var(--color-neutral-400);
  text-decoration: none;
  font-size: var(--text-sm);
  transition: color var(--transition-fast);
}
.footer-links a:hover { color: var(--color-green-400); }
.footer-bottom {
  max-width: var(--max-width-wide);
  margin: 0 auto;
  padding-top: var(--space-6);
  border-top: 1px solid var(--color-neutral-700);
  display: flex;
  align-items: center;
  justify-content: space-between;
  flex-wrap: wrap;
  gap: var(--space-4);
  font-size: var(--text-sm);
  color: var(--color-neutral-500);
}
.footer-logo { display: flex; align-items: center; gap: var(--space-2); color: var(--color-neutral-400); text-decoration: none; }
.footer-logo:hover { color: var(--color-green-400); }
.footer-logo svg { width: 1.5rem; height: 1.5rem; }

/* ---- BREADCRUMBS ----------------------------------------- */
.breadcrumbs {
  padding: var(--space-3) 0 var(--space-6);
  margin-bottom: 0;
}
.breadcrumbs ol {
  list-style: none;
  padding: 0;
  margin: 0;
  display: flex;
  flex-wrap: wrap;
  align-items: center;
  gap: var(--space-1);
}
.breadcrumbs li {
  display: flex;
  align-items: center;
  gap: var(--space-1);
  margin: 0;
  font-size: var(--text-sm);
  color: var(--color-neutral-500);
}
.breadcrumbs li + li::before {
  content: '/';
  color: var(--color-neutral-400);
  margin-right: var(--space-1);
}
.breadcrumbs a { color: var(--color-neutral-600); text-decoration: none; }
.breadcrumbs a:hover { color: var(--color-green-600); }
.breadcrumbs [aria-current="page"] { color: var(--color-green-700); font-weight: var(--weight-medium); }

/* ---- CODE BLOCKS + COPY BUTTON -------------------------- */
.code-block-wrapper {
  position: relative;
  margin: var(--space-6) 0;
  border-radius: var(--radius-lg);
  overflow: hidden;
  box-shadow: var(--shadow-md);
  border: 1px solid var(--color-green-200);
}
.copy-btn {
  position: absolute;
  top: var(--space-2);
  right: var(--space-2);
  padding: var(--space-1) var(--space-3);
  background: var(--color-white);
  color: var(--color-green-700);
  border: 1px solid var(--color-green-300);
  border-radius: var(--radius-md);
  font-family: var(--font-sans);
  font-size: var(--text-xs);
  font-weight: var(--weight-semibold);
  cursor: pointer;
  transition: background var(--transition-fast), color var(--transition-fast), border-color var(--transition-fast);
  z-index: 2;
}
.copy-btn:hover { background: var(--color-green-600); color: var(--color-white); border-color: var(--color-green-600); }
.copy-btn.copied { background: var(--color-green-600); color: var(--color-white); border-color: var(--color-green-600); }

/* ---- ACCORDION / FAQ ------------------------------------ */
details.faq {
  border: 1px solid var(--color-border);
  border-radius: var(--radius-lg);
  margin-bottom: var(--space-3);
  overflow: hidden;
  transition: box-shadow var(--transition-fast);
}
details.faq:hover { box-shadow: var(--shadow-md); }
details.faq[open] { border-color: var(--color-green-300); box-shadow: var(--shadow-md); }
details.faq summary {
  display: flex;
  align-items: center;
  justify-content: space-between;
  padding: var(--space-4) var(--space-5);
  background: var(--color-neutral-50);
  cursor: pointer;
  font-weight: var(--weight-semibold);
  color: var(--color-neutral-800);
  list-style: none;
  transition: background var(--transition-fast);
  gap: var(--space-3);
}
details.faq summary::-webkit-details-marker { display: none; }
details.faq[open] summary { background: var(--color-green-50); color: var(--color-green-800); }
details.faq summary::after {
  content: '+';
  font-size: var(--text-xl);
  color: var(--color-green-600);
  font-weight: var(--weight-bold);
  flex-shrink: 0;
  transition: transform var(--transition-base);
}
details.faq[open] summary::after { transform: rotate(45deg); }
.faq-body {
  padding: var(--space-5);
  background: var(--color-white);
  border-top: 1px solid var(--color-border);
}
.faq-body > *:last-child { margin-bottom: 0; }

/* ---- MERMAID DIAGRAMS ----------------------------------- */
.mermaid {
  background: var(--color-green-50);
  border: 1px solid var(--color-green-200);
  border-radius: var(--radius-lg);
  padding: var(--space-6);
  margin: var(--space-6) 0;
  overflow-x: auto;
  text-align: center;
}
.mermaid svg { max-width: 100%; height: auto; }

/* ---- SECTION CARDS (homepage & section indexes) --------- */
.section-cards {
  display: grid;
  grid-template-columns: repeat(auto-fit, minmax(280px, 1fr));
  gap: var(--space-6);
  margin: var(--space-8) 0;
}
.section-card {
  display: flex;
  flex-direction: column;
  background: var(--color-white);
  border: 1px solid var(--color-border);
  border-radius: var(--radius-xl);
  padding: var(--space-6);
  text-decoration: none;
  color: inherit;
  transition: transform var(--transition-base), box-shadow var(--transition-base), border-color var(--transition-base);
  box-shadow: var(--shadow-sm);
}
.section-card:hover {
  transform: translateY(-3px);
  box-shadow: var(--shadow-lg);
  border-color: var(--color-green-400);
  text-decoration: none;
}
.section-card-icon {
  width: 3rem;
  height: 3rem;
  margin-bottom: var(--space-4);
  border-radius: var(--radius-lg);
  display: flex;
  align-items: center;
  justify-content: center;
}
.section-card-icon svg { width: 1.75rem; height: 1.75rem; }
.section-card h3 {
  font-size: var(--text-lg);
  margin-top: 0;
  margin-bottom: var(--space-2);
  color: var(--color-neutral-900);
}
.section-card p {
  font-size: var(--text-sm);
  color: var(--color-text-muted);
  margin: 0;
  flex: 1;
  max-width: unset;
}
.card-arrow {
  display: flex;
  align-items: center;
  gap: var(--space-2);
  margin-top: var(--space-4);
  font-size: var(--text-sm);
  font-weight: var(--weight-semibold);
  color: var(--color-green-600);
  transition: gap var(--transition-fast);
}
.section-card:hover .card-arrow { gap: var(--space-3); }

/* ---- HERO ----------------------------------------------- */
.hero {
  background: linear-gradient(135deg, var(--color-green-50) 0%, var(--color-yellow-50) 50%, var(--color-teal-100) 100%);
  border-radius: var(--radius-xl);
  padding: var(--space-16) var(--space-10);
  margin-bottom: var(--space-12);
  text-align: center;
  border: 1px solid var(--color-green-200);
}
@media (max-width: 768px) {
  .hero { padding: var(--space-10) var(--space-6); }
}
.hero h1 { margin-bottom: var(--space-5); }
.hero p {
  font-size: var(--text-lg);
  color: var(--color-neutral-700);
  max-width: 60ch;
  margin: 0 auto var(--space-5);
}
.hero-actions {
  display: flex;
  flex-wrap: wrap;
  gap: var(--space-4);
  justify-content: center;
  margin-top: var(--space-8);
}

/* ---- BUTTONS -------------------------------------------- */
.btn {
  display: inline-flex;
  align-items: center;
  gap: var(--space-2);
  padding: var(--space-3) var(--space-5);
  border-radius: var(--radius-lg);
  font-weight: var(--weight-semibold);
  font-size: var(--text-sm);
  text-decoration: none;
  transition: background var(--transition-fast), transform var(--transition-fast), box-shadow var(--transition-fast);
  border: 2px solid transparent;
  cursor: pointer;
}
.btn:hover { transform: translateY(-1px); box-shadow: var(--shadow-md); text-decoration: none; }
.btn-primary { background: var(--color-green-600); color: var(--color-white); }
.btn-primary:hover { background: var(--color-green-700); color: var(--color-white); }
.btn-yellow  { background: var(--color-yellow-400); color: var(--color-neutral-900); }
.btn-yellow:hover  { background: var(--color-yellow-300); color: var(--color-neutral-900); }
.btn-teal    { background: var(--color-teal-500); color: var(--color-white); }
.btn-teal:hover    { background: var(--color-teal-600); color: var(--color-white); }
.btn-outline { background: transparent; border-color: var(--color-green-600); color: var(--color-green-700); }
.btn-outline:hover { background: var(--color-green-600); color: var(--color-white); }
.btn svg { width: 1.2rem; height: 1.2rem; }

/* ---- IMPLEMENTATION CHECKLIST BLOCKS -------------------- */
/* Bold labels like **WCAG 2.2 Alignment:** */
p > strong:first-child {
  display: inline-block;
}

/* ---- PAGE NAV (prev/next) -------------------------------- */
.page-nav {
  display: flex;
  justify-content: space-between;
  gap: var(--space-4);
  margin-top: var(--space-12);
  padding-top: var(--space-6);
  border-top: 2px solid var(--color-border);
  flex-wrap: wrap;
}
.page-nav a {
  display: flex;
  align-items: center;
  gap: var(--space-2);
  padding: var(--space-4) var(--space-5);
  border: 1px solid var(--color-border);
  border-radius: var(--radius-lg);
  text-decoration: none;
  color: var(--color-text);
  font-weight: var(--weight-medium);
  font-size: var(--text-sm);
  max-width: 45%;
  transition: border-color var(--transition-fast), box-shadow var(--transition-fast), background var(--transition-fast);
}
.page-nav a:hover { border-color: var(--color-green-400); box-shadow: var(--shadow-md); background: var(--color-green-50); text-decoration: none; }
.page-nav .prev { margin-right: auto; }
.page-nav .next { margin-left: auto; text-align: right; }

/* ---- TOPIC LINK LIST (sub-section index pages) ---------- */
.topic-list {
  list-style: none;
  padding: 0;
  margin: var(--space-6) 0;
  display: flex;
  flex-direction: column;
  gap: var(--space-3);
}
.topic-list li { margin: 0; }
.topic-list a {
  display: flex;
  align-items: center;
  justify-content: space-between;
  padding: var(--space-4) var(--space-5);
  border: 1px solid var(--color-border);
  border-radius: var(--radius-lg);
  text-decoration: none;
  color: var(--color-text);
  font-weight: var(--weight-medium);
  background: var(--color-white);
  transition: border-color var(--transition-fast), box-shadow var(--transition-fast), background var(--transition-fast), transform var(--transition-fast);
}
.topic-list a:hover {
  border-color: var(--color-green-400);
  box-shadow: var(--shadow-md);
  background: var(--color-green-50);
  transform: translateX(3px);
  text-decoration: none;
}
.topic-list a svg { color: var(--color-green-500); flex-shrink: 0; }