/* ===================================================
   CLARITY MIGRATE — DOCUMENTATION SITE STYLES
   Mirrors the application's design language exactly.
   Primary: #850bc6  |  Sidebar: #0a0f14
   =================================================== */

/* ===== IMPORTS ===== */
@import url('https://fonts.googleapis.com/css2?family=Inter:ital,opsz,wght@0,14..32,100..900;1,14..32,100..900&display=swap');
@import url('https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.4.0/css/all.min.css');

/* ===== CSS VARIABLES (matching _variables.css) ===== */
:root {
  --clarity-primary: #850bc6;
  --clarity-primary-dark: #6a099e;
  --clarity-primary-darker: #4f0776;
  --clarity-primary-light: rgba(133, 11, 198, 0.15);
  --clarity-primary-lighter: rgba(133, 11, 198, 0.08);
  --clarity-accent: #a855f7;
  --clarity-accent-dark: #9333ea;
  --clarity-accent-light: #c084fc;
  --clarity-highlight: #06b6d4;
  --clarity-text: #1f2937;
  --clarity-text-dark: #111827;
  --clarity-text-muted: #6b7280;
  --clarity-text-light: #9ca3af;
  --clarity-bg-primary: #ffffff;
  --clarity-bg-secondary: #f9fafb;
  --clarity-bg-tertiary: #f3f4f6;
  --clarity-border: #e5e7eb;
  --clarity-border-dark: #d1d5db;
  --clarity-success: #10b981;
  --clarity-success-light: #d1fae5;
  --clarity-success-bg: #ecfdf5;
  --clarity-warning: #f59e0b;
  --clarity-warning-light: #fef3c7;
  --clarity-warning-bg: #fffbeb;
  --clarity-danger: #ef4444;
  --clarity-danger-light: #fee2e2;
  --clarity-danger-bg: #fef2f2;
  --clarity-info: #06b6d4;
  --clarity-info-light: #cffafe;
  --clarity-info-bg: #ecfeff;
  --shadow-sm: 0 1px 3px rgba(0,0,0,0.1), 0 1px 2px rgba(0,0,0,0.06);
  --shadow-md: 0 4px 6px -1px rgba(0,0,0,0.1), 0 2px 4px -1px rgba(0,0,0,0.06);
  --shadow-lg: 0 10px 15px -3px rgba(0,0,0,0.1), 0 4px 6px -2px rgba(0,0,0,0.05);
  --radius-sm: 4px;
  --radius-md: 6px;
  --radius-lg: 8px;
  --radius-xl: 12px;
  --sidebar-bg: #0a0f14;
  --sidebar-text: #d1d5db;
  --sidebar-text-muted: #9ca3af;
  --sidebar-hover-bg: rgba(168, 85, 247, 0.12);
  --sidebar-active-bg: rgba(168, 85, 247, 0.25);
  --sidebar-active-border: #a855f7;
  --sidebar-icon: #6b7280;
  --sidebar-icon-hover: #c084fc;
  --sidebar-width: 268px;
  --topbar-height: 56px;
  --font-family: 'Inter', -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
  --transition: 200ms ease;
}

/* ===== RESET & BASE ===== */
*, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; }

html { font-size: 15px; scroll-behavior: smooth; }

body {
  font-family: var(--font-family);
  color: var(--clarity-text);
  background: var(--clarity-bg-secondary);
  line-height: 1.6;
  -webkit-font-smoothing: antialiased;
}

a { color: var(--clarity-primary); text-decoration: none; }
a:hover { color: var(--clarity-primary-dark); text-decoration: underline; }

/* ===== LAYOUT ===== */
.docs-layout {
  display: flex;
  min-height: 100vh;
}

/* ===== SIDEBAR ===== */
.docs-sidebar {
  width: var(--sidebar-width);
  min-width: var(--sidebar-width);
  background: var(--sidebar-bg);
  display: flex;
  flex-direction: column;
  position: fixed;
  top: 0;
  left: 0;
  height: 100vh;
  overflow-y: auto;
  overflow-x: hidden;
  z-index: 100;
  transition: transform var(--transition);
  scrollbar-width: thin;
  scrollbar-color: rgba(168,85,247,0.3) transparent;
}

.docs-sidebar::-webkit-scrollbar { width: 4px; }
.docs-sidebar::-webkit-scrollbar-track { background: transparent; }
.docs-sidebar::-webkit-scrollbar-thumb { background: rgba(168,85,247,0.3); border-radius: 2px; }

/* Sidebar header / logo */
.sidebar-header {
  padding: 20px 20px 16px;
  border-bottom: 1px solid rgba(255,255,255,0.06);
  flex-shrink: 0;
}

.sidebar-logo {
  display: flex;
  align-items: center;
  gap: 10px;
  text-decoration: none;
}

.sidebar-logo-icon {
  width: 32px;
  height: 32px;
  background: linear-gradient(135deg, var(--clarity-primary), var(--clarity-accent));
  border-radius: var(--radius-md);
  display: flex;
  align-items: center;
  justify-content: center;
  flex-shrink: 0;
}

.sidebar-logo-icon svg {
  width: 18px;
  height: 18px;
  fill: white;
}

.sidebar-logo-text {
  display: flex;
  flex-direction: column;
  line-height: 1.2;
}

.sidebar-logo-name {
  font-size: 0.9375rem;
  font-weight: 700;
  color: #ffffff;
  letter-spacing: -0.01em;
}

.sidebar-logo-sub {
  font-size: 0.6875rem;
  color: var(--sidebar-text-muted);
  font-weight: 400;
  letter-spacing: 0.02em;
  text-transform: uppercase;
}

/* Sidebar search */
.sidebar-search {
  padding: 12px 16px;
  border-bottom: 1px solid rgba(255,255,255,0.05);
}

.sidebar-search input {
  width: 100%;
  background: rgba(255,255,255,0.06);
  border: 1px solid rgba(255,255,255,0.08);
  border-radius: var(--radius-md);
  padding: 7px 10px 7px 32px;
  font-size: 0.8125rem;
  color: var(--sidebar-text);
  font-family: var(--font-family);
  outline: none;
  transition: border-color var(--transition), background var(--transition);
  background-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='14' height='14' viewBox='0 0 24 24' fill='none' stroke='%236b7280' stroke-width='2' stroke-linecap='round' stroke-linejoin='round'%3E%3Ccircle cx='11' cy='11' r='8'/%3E%3Cpath d='m21 21-4.35-4.35'/%3E%3C/svg%3E");
  background-repeat: no-repeat;
  background-position: 10px center;
}

.sidebar-search input:focus {
  border-color: rgba(168,85,247,0.4);
  background-color: rgba(255,255,255,0.09);
}

.sidebar-search input::placeholder { color: rgba(156,163,175,0.6); }

/* Sidebar nav */
.sidebar-nav {
  flex: 1;
  padding: 8px 0 20px;
}

.nav-section {
  margin-bottom: 4px;
}

.nav-section-header {
  display: flex;
  align-items: center;
  gap: 9px;
  padding: 7px 12px 7px 12px;
  cursor: pointer;
  user-select: none;
  border: none;
  background: none;
  width: 100%;
  text-align: left;
  color: var(--sidebar-text-muted);
  border-radius: 4px;
  margin: 0 4px;
  width: calc(100% - 8px);
  transition: color var(--transition), background var(--transition);
}

.nav-section-header:hover {
  color: var(--sidebar-text);
  background: var(--sidebar-hover-bg);
}

.nav-section-label {
  font-size: 0.8125rem;
  font-weight: 500;
  flex: 1;
}

/* fa-stack icon matching the application sidebar */
.nav-icon-stack {
  font-size: 0.5rem;
  flex-shrink: 0;
  color: var(--clarity-accent-light);
  line-height: 1;
  width: 18px;
  display: inline-flex;
  align-items: center;
  justify-content: center;
}

/* Keep legacy rule in case any page still has the old span */
.nav-section-icon { display: none; }

.nav-chevron {
  font-size: 0.625rem;
  flex-shrink: 0;
  color: var(--sidebar-text-muted);
  transition: transform var(--transition);
}

.nav-section.collapsed .nav-chevron { transform: rotate(-90deg); }
.nav-section.collapsed .nav-items { display: none; }

.nav-items { list-style: none; padding: 0; margin: 0; }

.nav-item a {
  display: block;
  padding: 6px 12px 6px 42px;
  font-size: 0.8125rem;
  color: var(--sidebar-text-muted);
  text-decoration: none;
  border-left: 3px solid transparent;
  transition: all var(--transition);
  white-space: nowrap;
  overflow: hidden;
  text-overflow: ellipsis;
  line-height: 1.4;
}

.nav-item a:hover {
  color: var(--sidebar-text);
  background: var(--sidebar-hover-bg);
  text-decoration: none;
}

.nav-item a.active {
  color: #ffffff;
  background: var(--sidebar-active-bg);
  border-left-color: var(--sidebar-active-border);
  font-weight: 500;
}

/* Sub-group (nested within a section) */
.nav-subgroup-header {
  display: flex;
  align-items: center;
  gap: 6px;
  padding: 6px 12px 6px 42px;
  cursor: pointer;
  user-select: none;
  border: none;
  background: none;
  width: 100%;
  text-align: left;
  color: var(--sidebar-text-muted);
  transition: color var(--transition);
}
.nav-subgroup-header:hover { color: var(--sidebar-text); }

.nav-subgroup-label {
  font-size: 0.8125rem;
  font-weight: 500;
  flex: 1;
}

.nav-subchevron {
  font-size: 0.5625rem;
  flex-shrink: 0;
  color: var(--sidebar-text-muted);
  transition: transform var(--transition);
}

.nav-subgroup.collapsed .nav-subchevron { transform: rotate(-90deg); }
.nav-subgroup.collapsed .nav-subitems  { display: none; }

.nav-subitems { list-style: none; padding: 0; margin: 0; }

.nav-subitems .nav-item a {
  padding-left: 56px;
  font-size: 0.8rem;
}

/* Sidebar footer */
.sidebar-footer {
  padding: 12px 16px;
  border-top: 1px solid rgba(255,255,255,0.06);
  flex-shrink: 0;
}

.sidebar-version {
  font-size: 0.75rem;
  color: var(--sidebar-text-muted);
  text-align: center;
}

/* ===== MAIN CONTENT AREA ===== */
.docs-main {
  flex: 1;
  margin-left: var(--sidebar-width);
  display: flex;
  flex-direction: column;
  min-height: 100vh;
}

/* ===== TOPBAR ===== */
.docs-topbar {
  height: var(--topbar-height);
  background: var(--clarity-bg-primary);
  border-bottom: 1px solid var(--clarity-border);
  display: flex;
  align-items: center;
  gap: 16px;
  padding: 0 24px;
  position: sticky;
  top: 0;
  z-index: 50;
  box-shadow: var(--shadow-sm);
}

.sidebar-toggle {
  display: none;
  background: none;
  border: 1px solid var(--clarity-border);
  border-radius: var(--radius-md);
  width: 36px;
  height: 36px;
  cursor: pointer;
  font-size: 1.125rem;
  color: var(--clarity-text-muted);
  align-items: center;
  justify-content: center;
  transition: all var(--transition);
}

.sidebar-toggle:hover {
  background: var(--clarity-bg-tertiary);
  color: var(--clarity-text);
}

.breadcrumb {
  display: flex;
  align-items: center;
  gap: 6px;
  font-size: 0.8125rem;
  color: var(--clarity-text-muted);
  flex: 1;
}

.breadcrumb-sep { color: var(--clarity-border-dark); }
.breadcrumb a { color: var(--clarity-text-muted); }
.breadcrumb a:hover { color: var(--clarity-primary); text-decoration: none; }
.breadcrumb .current { color: var(--clarity-text); font-weight: 500; }

.topbar-search {
  position: relative;
  width: 240px;
}

.topbar-search input {
  width: 100%;
  height: 36px;
  border: 1px solid var(--clarity-border);
  border-radius: var(--radius-md);
  padding: 0 12px 0 34px;
  font-size: 0.8125rem;
  font-family: var(--font-family);
  color: var(--clarity-text);
  background: var(--clarity-bg-secondary);
  outline: none;
  transition: border-color var(--transition), box-shadow var(--transition);
  background-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='14' height='14' viewBox='0 0 24 24' fill='none' stroke='%236b7280' stroke-width='2' stroke-linecap='round' stroke-linejoin='round'%3E%3Ccircle cx='11' cy='11' r='8'/%3E%3Cpath d='m21 21-4.35-4.35'/%3E%3C/svg%3E");
  background-repeat: no-repeat;
  background-position: 10px center;
}

.topbar-search input:focus {
  border-color: var(--clarity-primary);
  box-shadow: 0 0 0 3px rgba(133,11,198,0.1);
  background-color: var(--clarity-bg-primary);
}

/* ===== ARTICLE ===== */
.docs-article {
  flex: 1;
  padding: 32px 40px 60px;
  min-width: 0;
}

/* Page header */
.page-header {
  margin-bottom: 32px;
  padding-bottom: 24px;
  border-bottom: 1px solid var(--clarity-border);
}

.page-badge {
  display: inline-flex;
  align-items: center;
  gap: 5px;
  background: var(--clarity-primary-light);
  color: var(--clarity-primary);
  font-size: 0.75rem;
  font-weight: 600;
  padding: 3px 10px;
  border-radius: var(--radius-pill);
  margin-bottom: 10px;
  text-transform: uppercase;
  letter-spacing: 0.05em;
}

.page-title {
  font-size: 1.875rem;
  font-weight: 700;
  color: var(--clarity-text-dark);
  letter-spacing: -0.03em;
  line-height: 1.2;
  margin-bottom: 10px;
}

.page-title span {
  background: linear-gradient(135deg, var(--clarity-primary), var(--clarity-accent));
  -webkit-background-clip: text;
  -webkit-text-fill-color: transparent;
  background-clip: text;
}

.page-description {
  font-size: 1rem;
  color: var(--clarity-text-muted);
  line-height: 1.65;
  max-width: 680px;
}

/* Section headings */
.docs-article h2 {
  font-size: 1.25rem;
  font-weight: 600;
  color: var(--clarity-text-dark);
  margin: 36px 0 14px;
  padding-bottom: 8px;
  border-bottom: 2px solid var(--clarity-border);
  letter-spacing: -0.01em;
}

.docs-article h3 {
  font-size: 1.0625rem;
  font-weight: 600;
  color: var(--clarity-text-dark);
  margin: 24px 0 10px;
}

.docs-article h4 {
  font-size: 0.9375rem;
  font-weight: 600;
  color: var(--clarity-text);
  margin: 18px 0 8px;
}

.docs-article p {
  margin-bottom: 14px;
  line-height: 1.65;
}

.docs-article ul, .docs-article ol {
  margin-bottom: 14px;
  padding-left: 20px;
}

.docs-article li { margin-bottom: 5px; line-height: 1.6; }

.docs-article code {
  font-family: 'JetBrains Mono', 'Fira Code', Consolas, monospace;
  font-size: 0.8125rem;
  background: var(--clarity-bg-tertiary);
  border: 1px solid var(--clarity-border);
  border-radius: var(--radius-sm);
  padding: 1px 5px;
  color: var(--clarity-primary-dark);
}

/* ===== CALLOUT BOXES ===== */
.callout {
  display: flex;
  gap: 12px;
  padding: 14px 16px;
  border-radius: var(--radius-lg);
  margin: 20px 0;
  border: 1px solid transparent;
}

.callout-icon {
  font-size: 1rem;
  flex-shrink: 0;
  margin-top: 1px;
}

.callout-body { flex: 1; }
.callout-title { font-size: 0.875rem; font-weight: 600; margin-bottom: 3px; }
.callout-text { font-size: 0.875rem; line-height: 1.55; margin: 0; }

.callout-tip {
  background: var(--clarity-success-bg);
  border-color: var(--clarity-success-light);
  color: #065f46;
}
.callout-tip .callout-title { color: #047857; }

.callout-info {
  background: var(--clarity-info-bg);
  border-color: var(--clarity-info-light);
  color: #164e63;
}
.callout-info .callout-title { color: #0891b2; }

.callout-warning {
  background: var(--clarity-warning-bg);
  border-color: var(--clarity-warning-light);
  color: #78350f;
}
.callout-warning .callout-title { color: #d97706; }

.callout-danger {
  background: var(--clarity-danger-bg);
  border-color: var(--clarity-danger-light);
  color: #7f1d1d;
}
.callout-danger .callout-title { color: #dc2626; }

/* ===== STEP LIST ===== */
.steps { counter-reset: step-counter; margin: 20px 0; }

.step {
  display: flex;
  gap: 16px;
  padding: 16px 0;
  position: relative;
}

.step:not(:last-child) {
  border-bottom: 1px solid var(--clarity-border);
}

.step-number {
  width: 28px;
  height: 28px;
  background: var(--clarity-primary);
  color: white;
  border-radius: 50%;
  display: flex;
  align-items: center;
  justify-content: center;
  font-size: 0.75rem;
  font-weight: 700;
  flex-shrink: 0;
  margin-top: 1px;
}

.step-content { flex: 1; }
.step-title { font-size: 0.9375rem; font-weight: 600; color: var(--clarity-text-dark); margin-bottom: 5px; }
.step-desc { font-size: 0.875rem; color: var(--clarity-text-muted); line-height: 1.6; margin: 0; }
.step-desc p { margin-bottom: 6px; }
.step-desc ul { margin: 4px 0 0 16px; }
.step-desc li { margin-bottom: 3px; font-size: 0.875rem; }

/* ===== FIELDS TABLE ===== */
.fields-table {
  width: 100%;
  border-collapse: collapse;
  margin: 16px 0 24px;
  font-size: 0.875rem;
}

.fields-table th {
  background: var(--clarity-bg-tertiary);
  padding: 9px 14px;
  text-align: left;
  font-size: 0.75rem;
  font-weight: 600;
  color: var(--clarity-text-muted);
  text-transform: uppercase;
  letter-spacing: 0.05em;
  border-bottom: 2px solid var(--clarity-border-dark);
  border-top: 1px solid var(--clarity-border);
}

.fields-table th:first-child { border-left: 1px solid var(--clarity-border); border-radius: var(--radius-sm) 0 0 0; }
.fields-table th:last-child { border-right: 1px solid var(--clarity-border); border-radius: 0 var(--radius-sm) 0 0; }

.fields-table td {
  padding: 10px 14px;
  border-bottom: 1px solid var(--clarity-border);
  vertical-align: top;
  line-height: 1.5;
}

.fields-table td:first-child {
  border-left: 1px solid var(--clarity-border);
  white-space: nowrap;
}

.fields-table td:last-child { border-right: 1px solid var(--clarity-border); }

.fields-table tr:last-child td:first-child { border-radius: 0 0 0 var(--radius-sm); }
.fields-table tr:last-child td:last-child { border-radius: 0 0 var(--radius-sm) 0; }

.fields-table tr:hover td { background: var(--clarity-bg-secondary); }

.field-name {
  font-weight: 600;
  color: var(--clarity-primary-dark);
  font-family: 'JetBrains Mono', Consolas, monospace;
  font-size: 0.8125rem;
}

.field-required {
  display: inline-block;
  background: var(--clarity-danger-bg);
  color: var(--clarity-danger);
  font-size: 0.6875rem;
  font-weight: 600;
  padding: 1px 5px;
  border-radius: var(--radius-sm);
  margin-left: 6px;
  vertical-align: middle;
  text-transform: uppercase;
  letter-spacing: 0.04em;
}

.field-optional {
  display: inline-block;
  background: var(--clarity-bg-tertiary);
  color: var(--clarity-text-muted);
  font-size: 0.6875rem;
  font-weight: 500;
  padding: 1px 5px;
  border-radius: var(--radius-sm);
  margin-left: 6px;
  vertical-align: middle;
}

/* ===== FEATURE CARDS ===== */
.feature-grid {
  display: grid;
  grid-template-columns: repeat(auto-fill, minmax(240px, 1fr));
  gap: 14px;
  margin: 16px 0 24px;
}

.feature-card {
  background: var(--clarity-bg-primary);
  border: 1px solid var(--clarity-border);
  border-radius: var(--radius-lg);
  padding: 16px;
  transition: box-shadow var(--transition), border-color var(--transition);
}

.feature-card:hover {
  box-shadow: var(--shadow-md);
  border-color: var(--clarity-primary-light);
}

.feature-card-icon {
  width: 36px;
  height: 36px;
  background: var(--clarity-primary-lighter);
  border-radius: var(--radius-md);
  display: flex;
  align-items: center;
  justify-content: center;
  margin-bottom: 10px;
  font-size: 1rem;
}
.feature-card-icon i { font-size: 0.9rem; color: var(--clarity-primary); }

.feature-card-title {
  font-size: 0.875rem;
  font-weight: 600;
  color: var(--clarity-text-dark);
  margin-bottom: 4px;
}

.feature-card-desc {
  font-size: 0.8125rem;
  color: var(--clarity-text-muted);
  line-height: 1.5;
}

/* ===== NAV CARDS (module index pages) ===== */
.nav-cards {
  display: grid;
  grid-template-columns: repeat(auto-fill, minmax(260px, 1fr));
  gap: 16px;
  margin: 20px 0;
}

.nav-card {
  background: var(--clarity-bg-primary);
  border: 1px solid var(--clarity-border);
  border-radius: var(--radius-xl);
  padding: 20px;
  text-decoration: none;
  display: flex;
  flex-direction: column;
  gap: 6px;
  transition: all var(--transition);
  position: relative;
  overflow: hidden;
}

.nav-card::before {
  content: '';
  position: absolute;
  top: 0;
  left: 0;
  right: 0;
  height: 3px;
  background: linear-gradient(90deg, var(--clarity-primary), var(--clarity-accent));
  transform: scaleX(0);
  transform-origin: left;
  transition: transform var(--transition);
}

.nav-card:hover {
  box-shadow: var(--shadow-lg);
  border-color: rgba(133,11,198,0.2);
  text-decoration: none;
}

.nav-card:hover::before { transform: scaleX(1); }

.nav-card-icon { font-size: 1.375rem; margin-bottom: 4px; display: flex; align-items: center; justify-content: center; }
.nav-card-icon i { font-size: 1.375rem; color: var(--clarity-primary); }
.nav-card-title { font-size: 0.9375rem; font-weight: 600; color: var(--clarity-text-dark); }
.nav-card-desc { font-size: 0.8125rem; color: var(--clarity-text-muted); line-height: 1.5; }
.nav-card-arrow { margin-top: auto; padding-top: 10px; color: var(--clarity-primary); font-size: 0.8125rem; font-weight: 500; }

/* ===== WORKFLOW EXAMPLE BOX ===== */
.workflow-example {
  background: linear-gradient(135deg, var(--clarity-primary-lighter) 0%, rgba(168,85,247,0.05) 100%);
  border: 1px solid var(--clarity-primary-light);
  border-radius: var(--radius-xl);
  padding: 24px;
  margin: 24px 0;
}

.workflow-example-header {
  font-size: 0.75rem;
  font-weight: 700;
  text-transform: uppercase;
  letter-spacing: 0.08em;
  color: var(--clarity-primary);
  margin-bottom: 12px;
  display: flex;
  align-items: center;
  gap: 6px;
}

.workflow-example-title {
  font-size: 1rem;
  font-weight: 600;
  color: var(--clarity-text-dark);
  margin-bottom: 10px;
}

.workflow-example p {
  font-size: 0.875rem;
  color: var(--clarity-text);
  margin-bottom: 8px;
}

/* ===== COMMON MISTAKES BOX ===== */
.mistakes-list {
  list-style: none;
  padding: 0;
  margin: 14px 0;
}

.mistakes-list li {
  display: flex;
  gap: 10px;
  padding: 10px 0;
  border-bottom: 1px solid var(--clarity-border);
  font-size: 0.875rem;
  line-height: 1.55;
}

.mistakes-list li:last-child { border-bottom: none; }
.mistakes-list .mistake-icon { flex-shrink: 0; margin-top: 1px; }

/* ===== STATUS BADGES ===== */
.badge {
  display: inline-flex;
  align-items: center;
  gap: 4px;
  padding: 2px 8px;
  border-radius: var(--radius-pill);
  font-size: 0.75rem;
  font-weight: 500;
  white-space: nowrap;
}

.badge-success { background: var(--clarity-success-bg); color: #065f46; border: 1px solid var(--clarity-success-light); }
.badge-warning { background: var(--clarity-warning-bg); color: #78350f; border: 1px solid var(--clarity-warning-light); }
.badge-danger  { background: var(--clarity-danger-bg);  color: #7f1d1d; border: 1px solid var(--clarity-danger-light); }
.badge-info    { background: var(--clarity-info-bg);    color: #164e63; border: 1px solid var(--clarity-info-light); }
.badge-primary { background: var(--clarity-primary-light); color: var(--clarity-primary-dark); border: 1px solid rgba(133,11,198,0.2); }
.badge-neutral { background: var(--clarity-bg-tertiary); color: var(--clarity-text-muted); border: 1px solid var(--clarity-border); }

/* ===== QUICK REFERENCE GRID ===== */
.qr-grid {
  display: grid;
  grid-template-columns: repeat(auto-fill, minmax(280px, 1fr));
  gap: 12px;
  margin: 16px 0;
}

.qr-card {
  background: var(--clarity-bg-primary);
  border: 1px solid var(--clarity-border);
  border-left: 3px solid var(--clarity-primary);
  border-radius: var(--radius-md);
  padding: 12px 14px;
}

.qr-label { font-size: 0.75rem; font-weight: 600; color: var(--clarity-primary); text-transform: uppercase; letter-spacing: 0.05em; margin-bottom: 4px; }
.qr-value { font-size: 0.875rem; color: var(--clarity-text); font-weight: 500; }
.qr-desc  { font-size: 0.8125rem; color: var(--clarity-text-muted); margin-top: 2px; }

/* ===== HOMEPAGE SPECIFIC ===== */
.home-hero {
  background: linear-gradient(135deg, #0a0f14 0%, #1a0a2e 100%);
  border-radius: var(--radius-xl);
  padding: 48px 40px;
  margin-bottom: 36px;
  position: relative;
  overflow: hidden;
}

.home-hero::after {
  content: '';
  position: absolute;
  top: -60px;
  right: -60px;
  width: 280px;
  height: 280px;
  background: radial-gradient(circle, rgba(133,11,198,0.25) 0%, transparent 70%);
  pointer-events: none;
}

.home-hero-badge {
  display: inline-flex;
  align-items: center;
  gap: 6px;
  background: rgba(133,11,198,0.2);
  border: 1px solid rgba(133,11,198,0.3);
  color: var(--clarity-accent-light);
  font-size: 0.75rem;
  font-weight: 600;
  padding: 4px 12px;
  border-radius: var(--radius-pill);
  text-transform: uppercase;
  letter-spacing: 0.06em;
  margin-bottom: 16px;
}

.home-hero h1 {
  font-size: 2.25rem;
  font-weight: 800;
  color: #ffffff;
  letter-spacing: -0.04em;
  line-height: 1.15;
  margin-bottom: 14px;
}

.home-hero h1 span {
  background: linear-gradient(135deg, var(--clarity-accent-light), var(--clarity-accent));
  -webkit-background-clip: text;
  -webkit-text-fill-color: transparent;
  background-clip: text;
}

.home-hero p {
  font-size: 1rem;
  color: rgba(209,213,219,0.9);
  max-width: 580px;
  line-height: 1.65;
  margin-bottom: 24px;
}

.hero-buttons {
  display: flex;
  gap: 12px;
  flex-wrap: wrap;
}

.btn-hero-primary {
  display: inline-flex;
  align-items: center;
  gap: 7px;
  background: var(--clarity-primary);
  color: white;
  padding: 10px 20px;
  border-radius: var(--radius-lg);
  font-size: 0.875rem;
  font-weight: 600;
  text-decoration: none;
  transition: all var(--transition);
  box-shadow: 0 4px 14px rgba(133,11,198,0.4);
}

.btn-hero-primary:hover {
  background: var(--clarity-primary-dark);
  transform: translateY(-1px);
  text-decoration: none;
  color: white;
}

.btn-hero-secondary {
  display: inline-flex;
  align-items: center;
  gap: 7px;
  background: rgba(255,255,255,0.08);
  color: rgba(255,255,255,0.85);
  border: 1px solid rgba(255,255,255,0.15);
  padding: 10px 20px;
  border-radius: var(--radius-lg);
  font-size: 0.875rem;
  font-weight: 500;
  text-decoration: none;
  transition: all var(--transition);
}

.btn-hero-secondary:hover {
  background: rgba(255,255,255,0.12);
  color: white;
  text-decoration: none;
}

/* Module overview cards on homepage */
.module-grid {
  display: grid;
  grid-template-columns: repeat(auto-fill, minmax(300px, 1fr));
  gap: 16px;
  margin: 20px 0 32px;
}

.module-card {
  background: var(--clarity-bg-primary);
  border: 1px solid var(--clarity-border);
  border-radius: var(--radius-xl);
  padding: 20px;
  display: flex;
  flex-direction: column;
  gap: 8px;
  transition: all var(--transition);
  text-decoration: none;
}

.module-card:hover {
  box-shadow: var(--shadow-lg);
  border-color: rgba(133,11,198,0.2);
  transform: translateY(-2px);
  text-decoration: none;
}

.module-card-header {
  display: flex;
  align-items: center;
  gap: 12px;
  margin-bottom: 4px;
}

.module-card-icon {
  width: 40px;
  height: 40px;
  border-radius: var(--radius-lg);
  display: flex;
  align-items: center;
  justify-content: center;
  font-size: 1.125rem;
  flex-shrink: 0;
}
.module-card-icon i { font-size: 1.125rem; color: #fff; }

.module-card-title { font-size: 1rem; font-weight: 600; color: var(--clarity-text-dark); }
.module-card-desc  { font-size: 0.8375rem; color: var(--clarity-text-muted); line-height: 1.5; }
.module-card-links { margin-top: 10px; display: flex; flex-wrap: wrap; gap: 6px; }

.module-card-link {
  font-size: 0.8125rem;
  color: var(--clarity-primary);
  text-decoration: none;
  display: inline-flex;
  align-items: center;
  gap: 3px;
  background: var(--clarity-primary-lighter);
  padding: 3px 9px;
  border-radius: var(--radius-pill);
  transition: background var(--transition);
}

.module-card-link:hover {
  background: var(--clarity-primary-light);
  text-decoration: none;
}

/* Icon background colours per module */
.icon-purple { background: var(--clarity-primary-light); }
.icon-cyan   { background: rgba(6,182,212,0.12); }
.icon-green  { background: rgba(16,185,129,0.12); }
.icon-amber  { background: rgba(245,158,11,0.12); }
.icon-blue   { background: rgba(59,130,246,0.12); }
.icon-red    { background: rgba(239,68,68,0.12); }
.icon-indigo { background: rgba(99,102,241,0.12); }
.icon-teal   { background: rgba(20,184,166,0.12); }

/* ===== SECTION DIVIDER ===== */
.section-divider {
  display: flex;
  align-items: center;
  gap: 12px;
  margin: 36px 0 20px;
}

.section-divider-line { flex: 1; height: 1px; background: var(--clarity-border); }
.section-divider-label { font-size: 0.75rem; font-weight: 600; color: var(--clarity-text-muted); text-transform: uppercase; letter-spacing: 0.08em; white-space: nowrap; }

/* ===== TABLE OF CONTENTS ===== */
.toc {
  background: var(--clarity-bg-secondary);
  border: 1px solid var(--clarity-border);
  border-radius: var(--radius-lg);
  padding: 16px 20px;
  margin-bottom: 28px;
}

.toc-title {
  font-size: 0.75rem;
  font-weight: 700;
  text-transform: uppercase;
  letter-spacing: 0.08em;
  color: var(--clarity-text-muted);
  margin-bottom: 10px;
}

.toc-list {
  list-style: none;
  padding: 0;
  margin: 0;
}

.toc-list li { margin-bottom: 5px; }

.toc-list a {
  font-size: 0.8375rem;
  color: var(--clarity-text-muted);
  display: flex;
  align-items: center;
  gap: 6px;
  transition: color var(--transition);
}

.toc-list a::before {
  content: '';
  width: 4px;
  height: 4px;
  background: var(--clarity-border-dark);
  border-radius: 50%;
  flex-shrink: 0;
  transition: background var(--transition);
}

.toc-list a:hover { color: var(--clarity-primary); text-decoration: none; }
.toc-list a:hover::before { background: var(--clarity-primary); }

/* ===== RESPONSIVE ===== */
@media (max-width: 1024px) {
    .phase-grid { grid-template-columns: repeat(2, 1fr); }
  .docs-sidebar {
    transform: translateX(-100%);
  }
  .docs-sidebar.open {
    transform: translateX(0);
  }
  .docs-main {
    margin-left: 0;
  }
  .sidebar-toggle {
    display: flex;
  }
  .docs-article {
    padding: 24px 20px 48px;
  }
}

@media (max-width: 640px) {
  .feature-grid, .nav-cards, .module-grid { grid-template-columns: 1fr; }
  .home-hero { padding: 28px 20px; }
  .home-hero h1 { font-size: 1.625rem; }
  .page-title { font-size: 1.5rem; }
  .topbar-search { display: none; }
}

/* ===== SIDEBAR OVERLAY ===== */
.sidebar-overlay {
  display: none;
  position: fixed;
  inset: 0;
  background: rgba(0,0,0,0.5);
  z-index: 99;
}

.sidebar-overlay.visible { display: block; }

/* ===== ON-PAGE NAV (right side) ===== */
.docs-wrapper {
  display: flex;
  flex: 1;
}

.docs-on-page-nav {
  width: 220px;
  min-width: 220px;
  padding: 32px 20px 32px 0;
  position: sticky;
  top: var(--topbar-height);
  height: calc(100vh - var(--topbar-height));
  overflow-y: auto;
  flex-shrink: 0;
}

.on-page-nav-title {
  font-size: 0.6875rem;
  font-weight: 700;
  text-transform: uppercase;
  letter-spacing: 0.08em;
  color: var(--clarity-text-muted);
  margin-bottom: 10px;
  padding-left: 12px;
}

.on-page-nav-list { list-style: none; padding: 0; margin: 0; }

.on-page-nav-list li a {
  display: block;
  font-size: 0.8125rem;
  color: var(--clarity-text-muted);
  padding: 5px 12px;
  border-left: 2px solid var(--clarity-border);
  transition: all var(--transition);
  line-height: 1.4;
}

.on-page-nav-list li a:hover,
.on-page-nav-list li a.active {
  color: var(--clarity-primary);
  border-left-color: var(--clarity-primary);
  background: var(--clarity-primary-lighter);
  text-decoration: none;
}

@media (max-width: 1280px) {
  .docs-on-page-nav { display: none; }
}

/* ===== HOME PAGE JOURNEY LAYOUT ===== */

.hero-intro {
  font-size: 1rem;
  line-height: 1.7;
  color: rgba(255,255,255,0.82);
  max-width: 680px;
  margin-bottom: 28px;
}

/* Journey flow removed */

/* Journey flow bar */
.journey-flow {
  display: flex;
  flex-direction: column;
  align-items: center;
  gap: 8px;
  margin: 0 0 32px;
  padding: 16px 24px;
  background: var(--clarity-bg-secondary);
  border: 1px solid var(--clarity-border);
  border-radius: var(--radius-xl);
}
.journey-governance {
  display: flex;
  justify-content: center;
}
.journey-step-gov {
  justify-content: center;
  background: rgba(245,158,11,0.08);
  border-color: rgba(245,158,11,0.3);
  text-decoration: none;
}
.journey-step-gov .journey-step-num { background: #f59e0b; }
.journey-phases {
  display: flex;
  align-items: center;
  justify-content: center;
  gap: 8px;
}
.journey-step { display: inline-flex; align-items: center; gap: 8px; padding: 8px 18px; border-radius: var(--radius-md); font-size: 0.8125rem; font-weight: 600; text-decoration: none; transition: all 0.15s ease; letter-spacing: 0.01em; }
.journey-step-discovery { background: rgba(6,182,212,0.12);  border: 1px solid rgba(6,182,212,0.35);  color: #06b6d4; }
.journey-step-planning  { background: rgba(139,92,246,0.12); border: 1px solid rgba(139,92,246,0.35); color: #a78bfa; }
.journey-step-execution { background: rgba(16,185,129,0.12); border: 1px solid rgba(16,185,129,0.35); color: #10b981; }
.journey-step-discovery:hover { background: rgba(6,182,212,0.22);  border-color: #06b6d4;  text-decoration: none; }
.journey-step-planning:hover  { background: rgba(139,92,246,0.22); border-color: #a78bfa; text-decoration: none; }
.journey-step-execution:hover { background: rgba(16,185,129,0.22); border-color: #10b981; text-decoration: none; }
.journey-step-gov { background: rgba(245,158,11,0.12); border: 1px solid rgba(245,158,11,0.35); color: #f59e0b; display: inline-flex; align-items: center; padding: 8px 18px; border-radius: var(--radius-md); font-size: 0.8125rem; font-weight: 600; transition: all 0.15s ease; text-decoration: none; }
.journey-step-gov:hover { background: rgba(245,158,11,0.22); border-color: #f59e0b; text-decoration: none; }
.journey-step-label { color: inherit; }
.journey-connector { color: var(--clarity-text-muted); font-size: 0.7rem; }
.journey-step-num { display: none; }
.journey-step-label {
  font-size: 0.8125rem;
  font-weight: 600;
  color: var(--clarity-text-dark);
}
.journey-connector {
  color: var(--clarity-text-muted);
  font-size: 0.7rem;
}

/* Phase sections */
.phase-section {
  margin-bottom: 40px;
  border: 1px solid var(--clarity-border);
  border-radius: var(--radius-xl);
  overflow: hidden;
}
.phase-header {
  display: flex;
  align-items: flex-start;
  gap: 16px;
  padding: 22px 24px;
  border-bottom: 1px solid var(--clarity-border);
}
.phase-discovery .phase-header { background: linear-gradient(135deg, rgba(6,182,212,0.06) 0%, var(--clarity-bg-secondary) 100%); }
.phase-planning .phase-header  { background: linear-gradient(135deg, rgba(139,92,246,0.07) 0%, var(--clarity-bg-secondary) 100%); }
.phase-execution .phase-header { background: linear-gradient(135deg, rgba(16,185,129,0.06) 0%, var(--clarity-bg-secondary) 100%); }

.phase-icon {
  width: 40px;
  height: 40px;
  border-radius: var(--radius-md);
  display: flex;
  align-items: center;
  justify-content: center;
  font-size: 1rem;
  flex-shrink: 0;
}
.phase-icon-sm {
  width: 32px;
  height: 32px;
  font-size: 0.875rem;
}
.phase-discovery .phase-icon { background: rgba(6,182,212,0.15); color: #06b6d4; }
.phase-planning  .phase-icon { background: rgba(139,92,246,0.15); color: var(--clarity-primary); }
.phase-execution .phase-icon { background: rgba(16,185,129,0.15); color: #10b981; }
.phase-governance .phase-icon { background: rgba(245,158,11,0.15); color: #f59e0b; }
.phase-governance .phase-header { background: linear-gradient(135deg, rgba(245,158,11,0.06) 0%, var(--clarity-bg-secondary) 100%); }

.phase-num {
  font-size: 0.6875rem;
  font-weight: 700;
  text-transform: uppercase;
  letter-spacing: 0.08em;
  color: var(--clarity-text-muted);
  margin-bottom: 2px;
}
.phase-title {
  font-size: 1.0625rem;
  font-weight: 700;
  color: var(--clarity-text-dark);
  margin-bottom: 4px;
}
.phase-desc {
  font-size: 0.875rem;
  color: var(--clarity-text-muted);
  line-height: 1.55;
}

.phase-grid {
  display: grid;
  grid-template-columns: repeat(4, 1fr);
  gap: 1px;
  background: var(--clarity-border);
}
.phase-card {
  background: var(--clarity-bg-primary);
  padding: 18px 20px;
  display: flex;
  flex-direction: column;
  gap: 6px;
}
.phase-card-title {
  font-size: 0.875rem;
  font-weight: 600;
  color: var(--clarity-text-dark);
  margin-bottom: 2px;
}
.phase-card-text {
  font-size: 0.8rem;
  color: var(--clarity-text-muted);
  line-height: 1.5;
  margin: 0 0 6px 0;
}
.phase-card-link {
  display: inline-block;
  font-size: 0.8125rem;
  font-weight: 500;
  color: var(--clarity-primary);
  text-decoration: none;
  line-height: 1.8;
}
.phase-card-link:hover { text-decoration: underline; }

.phase-workflow-link {
  display: flex;
  align-items: center;
  gap: 8px;
  padding: 14px 24px;
  background: var(--clarity-bg-tertiary);
  border-top: 1px solid var(--clarity-border);
  color: var(--clarity-primary);
  font-size: 0.8375rem;
  font-weight: 500;
  text-decoration: none;
  transition: background var(--transition);
}
.phase-workflow-link:hover { background: var(--clarity-primary-light); text-decoration: none; }

/* Governance band */
.governance-band {
  border: 1px solid var(--clarity-border);
  border-radius: var(--radius-xl);
  overflow: hidden;
  margin-bottom: 40px;
}
.governance-band-header {
  display: flex;
  align-items: center;
  gap: 14px;
  padding: 18px 24px;
  background: linear-gradient(135deg, rgba(245,158,11,0.07) 0%, var(--clarity-bg-secondary) 100%);
  border-bottom: 1px solid var(--clarity-border);
}
.governance-band .phase-icon { background: rgba(245,158,11,0.15); color: #f59e0b; }
.governance-band-title {
  font-size: 0.9375rem;
  font-weight: 700;
  color: var(--clarity-text-dark);
  margin-bottom: 2px;
}
.governance-band-desc {
  font-size: 0.8125rem;
  color: var(--clarity-text-muted);
}
.governance-links {
  display: flex;
  flex-wrap: wrap;
  gap: 0;
  background: var(--clarity-border);
}
.gov-link {
  flex: 1;
  min-width: 160px;
  background: var(--clarity-bg-primary);
  padding: 14px 18px;
  text-decoration: none;
  font-size: 0.8375rem;
  font-weight: 500;
  color: var(--clarity-text);
  display: flex;
  align-items: center;
  gap: 8px;
  transition: background var(--transition);
}
.gov-link i { color: #f59e0b; font-size: 0.875rem; }
.gov-link:hover { background: var(--clarity-bg-secondary); color: var(--clarity-text-dark); text-decoration: none; }


/* ===== MARKDOWN-GENERATED TABLE STYLING ===== */
/* Ensures plain <table> from Markdown renders like .fields-table */
.docs-article table {
  width: 100%;
  border-collapse: collapse;
  margin: 16px 0 24px;
  font-size: 0.875rem;
}
.docs-article table th {
  background: var(--clarity-bg-tertiary);
  padding: 9px 14px;
  text-align: left;
  font-size: 0.75rem;
  font-weight: 600;
  color: var(--clarity-text-muted);
  text-transform: uppercase;
  letter-spacing: 0.05em;
  border-bottom: 2px solid var(--clarity-border-dark);
  border-top: 1px solid var(--clarity-border);
}
.docs-article table th:first-child { border-left: 1px solid var(--clarity-border); border-radius: var(--radius-sm) 0 0 0; }
.docs-article table th:last-child  { border-right: 1px solid var(--clarity-border); border-radius: 0 var(--radius-sm) 0 0; }
.docs-article table td {
  padding: 10px 14px;
  border-bottom: 1px solid var(--clarity-border);
  vertical-align: top;
  line-height: 1.5;
}
.docs-article table td:first-child { border-left: 1px solid var(--clarity-border); }
.docs-article table td:last-child  { border-right: 1px solid var(--clarity-border); }
.docs-article table tr:last-child td:first-child { border-radius: 0 0 0 var(--radius-sm); }
.docs-article table tr:last-child td:last-child  { border-radius: 0 0 var(--radius-sm) 0; }
.docs-article table tr:hover td { background: var(--clarity-bg-secondary); }