/* 
 * diBoaS Documentation Redesign CSS
 * Enterprise-grade documentation interface
 * 
 * Extends: ../assets/css/redesign.css
 * Target: Lighthouse 95+, WCAG 2.1 AA
 * Performance: Core Web Vitals optimized
 */

/* ===========================
   DOCUMENTATION LAYOUT
   =========================== */

.docs-layout {
  display: grid;
  grid-template-areas:
    "header header"
    "sidebar content";
  grid-template-columns: 320px 1fr;
  grid-template-rows: auto 1fr;
  min-height: 100vh;
  background: var(--neutral-50);
}

/* ===========================
   HEADER STYLES
   =========================== */

.docs-header {
  grid-area: header;
  background: var(--bg-primary);
  border-bottom: 1px solid var(--neutral-200);
  position: sticky;
  top: 0;
  z-index: 100;
  backdrop-filter: blur(10px);
  -webkit-backdrop-filter: blur(10px);
}

.header-container {
  display: flex;
  align-items: center;
  justify-content: space-between;
  padding: var(--space-4) var(--space-6);
  max-width: 100%;
}

.header-left {
  display: flex;
  align-items: center;
  gap: var(--space-6);
  flex: 1;
}

.mobile-menu-btn {
  display: none;
  flex-direction: column;
  gap: 4px;
  background: none;
  border: none;
  cursor: pointer;
  padding: var(--space-2);
  border-radius: var(--radius-sm);
  transition: background-color 0.2s ease;
}

.mobile-menu-btn:hover {
  background: var(--neutral-100);
}

.mobile-menu-btn .hamburger {
  width: 20px;
  height: 2px;
  background: var(--text-primary);
  border-radius: 1px;
  transition: all 0.3s ease;
}

.mobile-menu-btn[aria-expanded="true"] .hamburger:nth-child(1) {
  transform: rotate(45deg) translate(5px, 5px);
}

.mobile-menu-btn[aria-expanded="true"] .hamburger:nth-child(2) {
  opacity: 0;
}

.mobile-menu-btn[aria-expanded="true"] .hamburger:nth-child(3) {
  transform: rotate(-45deg) translate(7px, -6px);
}

.docs-logo {
  display: flex;
  align-items: center;
  gap: var(--space-3);
  text-decoration: none;
  color: var(--text-primary);
  transition: opacity 0.2s ease;
}

.docs-logo:hover {
  opacity: 0.8;
}

.logo-icon svg {
  display: block;
}

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

.logo-main {
  font-family: var(--font-display);
  font-weight: 700;
  font-size: var(--text-lg);
  color: var(--text-primary);
}

.logo-sub {
  font-family: var(--font-primary);
  font-weight: 500;
  font-size: var(--text-sm);
  color: var(--text-secondary);
}

.breadcrumb {
  display: flex;
  align-items: center;
  gap: var(--space-2);
  font-size: var(--text-sm);
  color: var(--text-secondary);
}

.breadcrumb-link {
  color: var(--text-secondary);
  text-decoration: none;
  transition: color 0.2s ease;
}

.breadcrumb-link:hover {
  color: var(--aqua-primary);
}

.breadcrumb-separator {
  color: var(--text-tertiary);
}

.breadcrumb-current {
  color: var(--text-primary);
  font-weight: 500;
}

.header-right {
  display: flex;
  align-items: center;
  gap: var(--space-4);
}

/* Search Container */
.search-container {
  position: relative;
}

.search-input {
  width: 320px;
  padding: var(--space-3) var(--space-4) var(--space-3) var(--space-10);
  border: 1px solid var(--neutral-200);
  border-radius: var(--radius-lg);
  background: var(--neutral-50);
  font-size: var(--text-sm);
  color: var(--text-primary);
  transition: all 0.2s ease;
  font-family: var(--font-primary);
}

.search-input:focus {
  outline: none;
  border-color: var(--aqua-primary);
  box-shadow: 0 0 0 3px rgba(78, 205, 196, 0.1);
  background: var(--bg-primary);
}

.search-input::placeholder {
  color: var(--text-tertiary);
  font-style: italic;
}

.search-icon {
  position: absolute;
  left: var(--space-3);
  top: 50%;
  transform: translateY(-50%);
  color: var(--text-tertiary);
  width: 16px;
  height: 16px;
  pointer-events: none;
}

.search-results {
  position: absolute;
  top: calc(100% + var(--space-2));
  left: 0;
  right: 0;
  background: var(--bg-primary);
  border: 1px solid var(--neutral-200);
  border-radius: var(--radius-lg);
  box-shadow: var(--shadow-xl);
  z-index: 1000;
  max-height: 400px;
  overflow-y: auto;
  display: none;
}

.search-results[aria-expanded="true"] {
  display: block;
}

.theme-toggle {
  background: var(--neutral-50);
  border: 1px solid var(--neutral-200);
  border-radius: var(--radius-base);
  padding: var(--space-2);
  cursor: pointer;
  color: var(--text-secondary);
  transition: all 0.2s ease;
  width: 40px;
  height: 40px;
  display: flex;
  align-items: center;
  justify-content: center;
}

.theme-toggle:hover {
  border-color: var(--aqua-primary);
  color: var(--aqua-primary);
  background: var(--bg-primary);
}

.cta-button {
  display: inline-flex;
  align-items: center;
  gap: var(--space-2);
  background: linear-gradient(135deg, var(--aqua-primary), var(--aqua-dark));
  color: white;
  text-decoration: none;
  padding: var(--space-3) var(--space-5);
  border-radius: var(--radius-lg);
  font-weight: 600;
  font-size: var(--text-sm);
  transition: all 0.2s ease;
  border: none;
}

.cta-button:hover {
  transform: translateY(-1px);
  box-shadow: var(--shadow-lg);
}

/* ===========================
   SIDEBAR STYLES
   =========================== */

.docs-sidebar {
  grid-area: sidebar;
  background: var(--bg-primary);
  border-right: 1px solid var(--neutral-200);
  overflow-y: auto;
  height: calc(100vh - 73px);
  position: sticky;
  top: 73px;
}

.sidebar-content {
  padding: var(--space-6) 0;
}

.sidebar-mascot {
  display: flex;
  align-items: flex-start;
  gap: var(--space-3);
  padding: 0 var(--space-6) var(--space-6);
  margin-bottom: var(--space-6);
  border-bottom: 1px solid var(--neutral-100);
}

.mascot-avatar {
  flex-shrink: 0;
}

.mascot-greeting {
  flex: 1;
}

.greeting-text {
  font-size: var(--text-sm);
  color: var(--text-primary);
  margin: 0 0 var(--space-1);
  font-style: italic;
  line-height: 1.4;
}

.greeting-name {
  font-size: var(--text-xs);
  color: var(--aqua-primary);
  font-weight: 600;
  margin: 0;
}

.sidebar-section {
  margin-bottom: var(--space-8);
}

.sidebar-title {
  font-family: var(--font-display);
  font-size: var(--text-sm);
  font-weight: 600;
  color: var(--text-primary);
  text-transform: none;
  letter-spacing: 0;
  padding: 0 var(--space-6) var(--space-3);
  margin: 0;
  display: flex;
  align-items: center;
  gap: var(--space-2);
}

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

.sidebar-nav li {
  margin: 0;
}

.nav-link {
  display: flex;
  align-items: center;
  padding: var(--space-3) var(--space-6);
  color: var(--text-secondary);
  text-decoration: none;
  font-size: var(--text-sm);
  transition: all 0.2s ease;
  border-left: 3px solid transparent;
  position: relative;
}

.nav-link:hover {
  background: var(--neutral-50);
  color: var(--text-primary);
  border-left-color: var(--aqua-light);
}

.nav-link.active {
  background: rgba(78, 205, 196, 0.05);
  color: var(--aqua-dark);
  border-left-color: var(--aqua-primary);
  font-weight: 500;
}

.nav-link.external::after {
  content: '';
  width: 12px;
  height: 12px;
  background-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='12' height='12' viewBox='0 0 24 24' fill='none' stroke='%23757575' stroke-width='2'%3E%3Cpath d='M18 13v6a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V8a2 2 0 0 1 2-2h6'/%3E%3Cpolyline points='15,3 21,3 21,9'/%3E%3Cline x1='10' y1='14' x2='21' y2='3'/%3E%3C/svg%3E");
  background-repeat: no-repeat;
  margin-left: auto;
}

.mascot-indicator {
  width: 8px;
  height: 8px;
  border-radius: 50%;
  margin-right: var(--space-2);
  flex-shrink: 0;
}

.mascot-indicator.aqua {
  background: var(--aqua-primary);
}

.mascot-indicator.verde {
  background: var(--verde-primary);
}

.mascot-indicator.mystic {
  background: var(--mystic-primary);
}

.mascot-indicator.coral {
  background: var(--coral-primary);
}

/* ===========================
   MAIN CONTENT STYLES
   =========================== */

.docs-content {
  grid-area: content;
  padding: var(--space-8) var(--space-6);
  overflow-x: hidden;
  background: var(--bg-primary);
}

.content-wrapper {
  max-width: 900px;
  margin: 0 auto;
}

/* Hero Section */
.docs-hero {
  position: relative;
  text-align: center;
  margin-bottom: var(--space-20);
  padding: var(--space-16) var(--space-8);
  border-radius: var(--radius-xl);
  overflow: hidden;
}

.hero-background {
  position: absolute;
  top: 0;
  left: 0;
  right: 0;
  bottom: 0;
  z-index: 1;
}

.hero-gradient {
  position: absolute;
  top: 0;
  left: 0;
  right: 0;
  bottom: 0;
  background: linear-gradient(135deg, var(--aqua-background), rgba(255, 255, 255, 0.8));
}

.hero-pattern {
  position: absolute;
  top: 0;
  left: 0;
  right: 0;
  bottom: 0;
  background: var(--journey-progress);
  opacity: 0.03;
}

.hero-content {
  position: relative;
  z-index: 2;
}

.hero-mascot {
  margin: 0 auto var(--space-4);
  width: 80px;
  height: 80px;
}

.mascot-animation {
  animation: gentle-float 3s ease-in-out infinite;
}

.hero-greeting {
  font-family: var(--font-display);
  font-size: var(--text-lg);
  color: var(--aqua-dark);
  margin: 0 0 var(--space-6);
  font-weight: 500;
  font-style: italic;
}

.hero-title {
  font-family: var(--font-display);
  font-size: var(--text-4xl);
  font-weight: 700;
  color: var(--text-primary);
  margin: 0 0 var(--space-6);
  line-height: 1.1;
}

.title-highlight {
  background: var(--journey-progress);
  background-clip: text;
  -webkit-background-clip: text;
  -webkit-text-fill-color: transparent;
  background-size: 200% 100%;
  animation: gradient-shift 3s ease-in-out infinite;
}

.hero-subtitle {
  font-size: var(--text-lg);
  color: var(--text-secondary);
  margin: 0 0 var(--space-8);
  max-width: 600px;
  margin-left: auto;
  margin-right: auto;
  line-height: 1.6;
}

.hero-stats {
  display: flex;
  justify-content: center;
  gap: var(--space-8);
  margin-bottom: var(--space-8);
  flex-wrap: wrap;
}

.stat-item {
  text-align: center;
}

.stat-number {
  display: block;
  font-family: var(--font-display);
  font-size: var(--text-2xl);
  font-weight: 700;
  color: var(--aqua-primary);
  line-height: 1;
}

.stat-label {
  display: block;
  font-size: var(--text-sm);
  color: var(--text-secondary);
  margin-top: var(--space-1);
}

.hero-actions {
  display: flex;
  justify-content: center;
  gap: var(--space-4);
  flex-wrap: wrap;
}

/* Value Proposition Section */
.value-proposition {
  margin-bottom: var(--space-20);
  padding: var(--space-12) 0;
}

.value-container {
  max-width: 800px;
  margin: 0 auto;
  text-align: center;
}

.value-title {
  font-family: var(--font-display);
  font-size: var(--text-3xl);
  font-weight: 600;
  color: var(--text-primary);
  margin: 0 0 var(--space-12);
}

.comparison-grid {
  display: grid;
  grid-template-columns: 1fr 1fr;
  gap: var(--space-8);
  margin-bottom: var(--space-12);
}

.comparison-item {
  background: var(--bg-primary);
  border-radius: var(--radius-lg);
  padding: var(--space-8);
  position: relative;
}

.comparison-item.them {
  border: 2px solid var(--neutral-200);
}

.comparison-item.us {
  border: 2px solid var(--aqua-primary);
  background: linear-gradient(135deg, rgba(78, 205, 196, 0.02), var(--bg-primary));
}

.comparison-header {
  display: flex;
  align-items: center;
  gap: var(--space-3);
  margin-bottom: var(--space-6);
}

.comparison-icon {
  font-size: var(--text-2xl);
}

.comparison-header h3 {
  font-family: var(--font-display);
  font-size: var(--text-xl);
  font-weight: 600;
  color: var(--text-primary);
  margin: 0;
}

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

.comparison-list li {
  padding: var(--space-3) 0;
  border-bottom: 1px solid var(--neutral-100);
  font-size: var(--text-base);
  color: var(--text-secondary);
  position: relative;
  padding-left: var(--space-6);
}

.comparison-list li:last-child {
  border-bottom: none;
}

.comparison-item.them .comparison-list li::before {
  content: '❌';
  position: absolute;
  left: 0;
  font-size: var(--text-sm);
}

.comparison-item.us .comparison-list li::before {
  content: '✅';
  position: absolute;
  left: 0;
  font-size: var(--text-sm);
}

.value-cta {
  background: var(--aqua-background);
  border-radius: var(--radius-lg);
  padding: var(--space-6);
  border: 1px solid var(--aqua-light);
}

.value-message {
  font-size: var(--text-lg);
  color: var(--text-primary);
  margin: 0;
  line-height: 1.5;
}

/* Quick Help Section */
.quick-help {
  margin-bottom: var(--space-20);
}

.section-header {
  text-align: center;
  margin-bottom: var(--space-12);
}

.section-title {
  font-family: var(--font-display);
  font-size: var(--text-3xl);
  font-weight: 600;
  color: var(--text-primary);
  margin: 0 0 var(--space-4);
  display: flex;
  align-items: center;
  justify-content: center;
  gap: var(--space-3);
}

.title-icon {
  font-size: var(--text-2xl);
}

.section-subtitle {
  font-size: var(--text-lg);
  color: var(--text-secondary);
  margin: 0;
  max-width: 600px;
  margin-left: auto;
  margin-right: auto;
}

.help-grid {
  display: grid;
  grid-template-columns: repeat(auto-fit, minmax(320px, 1fr));
  gap: var(--space-6);
}

.help-card {
  background: var(--bg-primary);
  border: 1px solid var(--neutral-200);
  border-radius: var(--radius-lg);
  padding: var(--space-6);
  transition: all 0.3s ease;
  position: relative;
  overflow: hidden;
  cursor: pointer;
}

.help-card:hover,
.help-card:focus {
  transform: translateY(-4px);
  box-shadow: var(--shadow-xl);
  border-color: var(--aqua-light);
}

.help-card.featured {
  border-color: var(--aqua-primary);
  background: linear-gradient(135deg, rgba(78, 205, 196, 0.02), var(--bg-primary));
}

.help-card::before {
  content: '';
  position: absolute;
  top: 0;
  left: 0;
  right: 0;
  height: 3px;
  background: var(--journey-progress);
  transform: translateX(-100%);
  transition: transform 0.3s ease;
}

.help-card:hover::before,
.help-card:focus::before {
  transform: translateX(0);
}

.card-header {
  display: flex;
  align-items: center;
  justify-content: space-between;
  margin-bottom: var(--space-4);
}

.card-icon {
  width: 48px;
  height: 48px;
  border-radius: var(--radius-base);
  display: flex;
  align-items: center;
  justify-content: center;
  color: white;
  font-size: 24px;
}

.card-icon.getting-started {
  background: linear-gradient(135deg, var(--aqua-primary), var(--aqua-dark));
}

.card-icon.purchase {
  background: linear-gradient(135deg, var(--verde-primary), var(--verde-dark));
}

.card-icon.security {
  background: linear-gradient(135deg, var(--mystic-primary), var(--mystic-dark));
}

.card-icon.fees {
  background: linear-gradient(135deg, var(--coral-primary), var(--coral-dark));
}

.card-icon.ai {
  background: linear-gradient(135deg, var(--success-green), #388E3C);
}

.card-icon.community {
  background: linear-gradient(135deg, var(--warning-orange), #F57C00);
}

.card-meta {
  display: flex;
  flex-direction: column;
  gap: var(--space-2);
  align-items: flex-end;
}

.card-difficulty,
.card-time {
  font-size: var(--text-xs);
  font-weight: 500;
  padding: var(--space-1) var(--space-2);
  border-radius: var(--radius-sm);
}

.card-difficulty.beginner {
  background: rgba(76, 175, 80, 0.1);
  color: var(--success-green);
}

.card-difficulty.intermediate {
  background: rgba(255, 152, 0, 0.1);
  color: var(--warning-orange);
}

.card-difficulty.advanced {
  background: rgba(156, 39, 176, 0.1);
  color: var(--mystic-primary);
}

.card-difficulty.transparent {
  background: rgba(33, 150, 243, 0.1);
  color: #2196F3;
}

.card-difficulty.community {
  background: rgba(255, 87, 34, 0.1);
  color: #FF5722;
}

.card-time {
  background: var(--neutral-100);
  color: var(--text-secondary);
}

.card-title {
  font-family: var(--font-display);
  font-size: var(--text-lg);
  font-weight: 600;
  color: var(--text-primary);
  margin: 0 0 var(--space-3);
  line-height: 1.3;
}

.card-description {
  color: var(--text-secondary);
  margin: 0 0 var(--space-4);
  line-height: 1.5;
  font-size: var(--text-base);
}

.card-features {
  display: flex;
  gap: var(--space-2);
  margin-bottom: var(--space-4);
  flex-wrap: wrap;
}

.feature-tag {
  font-size: var(--text-xs);
  font-weight: 500;
  padding: var(--space-1) var(--space-2);
  background: var(--neutral-100);
  color: var(--text-secondary);
  border-radius: var(--radius-sm);
}

.card-link {
  display: inline-flex;
  align-items: center;
  gap: var(--space-2);
  color: var(--aqua-primary);
  text-decoration: none;
  font-weight: 600;
  font-size: var(--text-sm);
  transition: all 0.2s ease;
  margin-top: auto;
}

.card-link:hover {
  color: var(--aqua-dark);
  gap: var(--space-3);
}

/* Learning Path Section */
.learning-path {
  margin-bottom: var(--space-20);
  background: var(--neutral-50);
  border-radius: var(--radius-xl);
  padding: var(--space-12);
}

.journey-selector {
  background: var(--bg-primary);
  border-radius: var(--radius-lg);
  padding: var(--space-8);
  margin-bottom: var(--space-8);
  border: 1px solid var(--neutral-200);
}

.selector-header {
  text-align: center;
  margin-bottom: var(--space-6);
}

.selector-prompt {
  font-family: var(--font-display);
  font-size: var(--text-xl);
  font-weight: 500;
  color: var(--text-primary);
  margin: 0;
}

.journey-options {
  display: grid;
  grid-template-columns: repeat(auto-fit, minmax(200px, 1fr));
  gap: var(--space-4);
}

.journey-option {
  display: flex;
  align-items: center;
  gap: var(--space-3);
  background: var(--neutral-50);
  border: 2px solid var(--neutral-200);
  border-radius: var(--radius-lg);
  padding: var(--space-4);
  cursor: pointer;
  transition: all 0.2s ease;
  text-align: left;
}

.journey-option:hover {
  border-color: var(--aqua-light);
  background: var(--bg-primary);
}

.journey-option.active {
  border-color: var(--aqua-primary);
  background: rgba(78, 205, 196, 0.05);
}

.option-icon {
  font-size: var(--text-2xl);
  flex-shrink: 0;
}

.option-content h3 {
  font-family: var(--font-display);
  font-size: var(--text-base);
  font-weight: 600;
  color: var(--text-primary);
  margin: 0 0 var(--space-1);
}

.option-content p {
  font-size: var(--text-sm);
  color: var(--text-secondary);
  margin: 0;
}

.journey-content {
  background: var(--bg-primary);
  border-radius: var(--radius-lg);
  padding: var(--space-8);
  border: 1px solid var(--neutral-200);
}

.journey-mascot {
  display: flex;
  align-items: flex-start;
  gap: var(--space-4);
  margin-bottom: var(--space-8);
  padding-bottom: var(--space-6);
  border-bottom: 1px solid var(--neutral-100);
}

.mascot-avatar.aqua {
  flex-shrink: 0;
}

.mascot-speech p {
  font-style: italic;
  color: var(--text-primary);
  margin: 0;
  line-height: 1.5;
  background: var(--aqua-background);
  padding: var(--space-4);
  border-radius: var(--radius-lg);
  border-left: 4px solid var(--aqua-primary);
  position: relative;
}

.journey-steps {
  display: flex;
  flex-direction: column;
  gap: var(--space-6);
}

.step-item {
  display: flex;
  gap: var(--space-4);
  align-items: flex-start;
}

.step-number {
  width: 32px;
  height: 32px;
  background: linear-gradient(135deg, var(--aqua-primary), var(--aqua-dark));
  color: white;
  border-radius: 50%;
  display: flex;
  align-items: center;
  justify-content: center;
  font-weight: 700;
  font-size: var(--text-sm);
  flex-shrink: 0;
}

.step-content h4 {
  font-family: var(--font-display);
  font-size: var(--text-lg);
  font-weight: 600;
  color: var(--text-primary);
  margin: 0 0 var(--space-2);
}

.step-content p {
  color: var(--text-secondary);
  margin: 0 0 var(--space-3);
  line-height: 1.5;
}

.step-link {
  color: var(--aqua-primary);
  text-decoration: none;
  font-weight: 600;
  font-size: var(--text-sm);
  transition: color 0.2s ease;
}

.step-link:hover {
  color: var(--aqua-dark);
}

/* CTA Section */
.docs-cta {
  background: linear-gradient(135deg, var(--aqua-background), rgba(255, 255, 255, 0.5));
  border-radius: var(--radius-xl);
  padding: var(--space-16);
  text-align: center;
  border: 1px solid var(--aqua-light);
  position: relative;
  overflow: hidden;
}

.docs-cta::before {
  content: '';
  position: absolute;
  top: 0;
  left: 0;
  right: 0;
  bottom: 0;
  background: var(--journey-progress);
  opacity: 0.02;
  z-index: 1;
}

.cta-content {
  position: relative;
  z-index: 2;
}

.cta-mascot {
  margin: 0 auto var(--space-4);
  width: 60px;
  height: 60px;
}

.cta-title {
  font-family: var(--font-display);
  font-size: var(--text-3xl);
  font-weight: 700;
  color: var(--text-primary);
  margin: 0 0 var(--space-4);
}

.cta-subtitle {
  font-size: var(--text-lg);
  color: var(--text-secondary);
  margin: 0 0 var(--space-8);
  max-width: 600px;
  margin-left: auto;
  margin-right: auto;
  line-height: 1.6;
}

.cta-buttons {
  display: flex;
  justify-content: center;
  gap: var(--space-4);
  margin-bottom: var(--space-8);
  flex-wrap: wrap;
}

.btn-large {
  padding: var(--space-4) var(--space-8);
  font-size: var(--text-base);
}

.cta-trust-signals {
  display: flex;
  justify-content: center;
  gap: var(--space-8);
  flex-wrap: wrap;
}

.trust-item {
  display: flex;
  align-items: center;
  gap: var(--space-2);
  font-size: var(--text-sm);
  color: var(--text-secondary);
}

.trust-icon {
  font-size: var(--text-base);
}

/* ===========================
   ANIMATIONS
   =========================== */

@keyframes gentle-float {

  0%,
  100% {
    transform: translateY(0px) rotate(0deg);
  }

  50% {
    transform: translateY(-8px) rotate(2deg);
  }
}

@keyframes gradient-shift {

  0%,
  100% {
    background-position: 0% 50%;
  }

  50% {
    background-position: 100% 50%;
  }
}

.spinner-animation {
  animation: spin 1s linear infinite;
}

@keyframes spin {
  from {
    transform: rotate(0deg);
  }

  to {
    transform: rotate(360deg);
  }
}

/* ===========================
   RESPONSIVE DESIGN
   =========================== */

@media (max-width: 1024px) {
  .docs-layout {
    grid-template-areas:
      "header"
      "content";
    grid-template-columns: 1fr;
  }

  .docs-sidebar {
    position: fixed;
    left: -100%;
    top: 73px;
    width: 320px;
    height: calc(100vh - 73px);
    transition: left 0.3s ease;
    z-index: 200;
    box-shadow: var(--shadow-xl);
  }

  .docs-sidebar.active {
    left: 0;
  }

  .sidebar-overlay {
    position: fixed;
    top: 73px;
    left: 0;
    right: 0;
    bottom: 0;
    background: rgba(0, 0, 0, 0.5);
    display: none;
    z-index: 150;
  }

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

  .mobile-menu-btn {
    display: flex;
  }

  .search-input {
    width: 240px;
  }

  .breadcrumb {
    display: none;
  }
}

@media (max-width: 768px) {
  .header-container {
    padding: var(--space-3) var(--space-4);
  }

  .docs-content {
    padding: var(--space-6) var(--space-4);
  }

  .search-input {
    width: 180px;
  }

  .hero-actions {
    flex-direction: column;
    align-items: center;
  }

  .hero-actions .btn {
    width: 100%;
    max-width: 300px;
    justify-content: center;
  }

  .comparison-grid {
    grid-template-columns: 1fr;
    gap: var(--space-6);
  }

  .help-grid {
    grid-template-columns: 1fr;
  }

  .hero-stats {
    gap: var(--space-4);
  }

  .journey-options {
    grid-template-columns: 1fr;
  }

  .cta-buttons {
    flex-direction: column;
    align-items: center;
  }

  .cta-buttons .btn {
    width: 100%;
    max-width: 300px;
    justify-content: center;
  }

  .cta-trust-signals {
    gap: var(--space-4);
  }
}

@media (max-width: 480px) {
  .header-right {
    gap: var(--space-2);
  }

  .search-input {
    width: 140px;
    font-size: var(--text-xs);
  }

  .docs-hero {
    padding: var(--space-12) var(--space-4);
  }

  .hero-title {
    font-size: var(--text-3xl);
  }

  .section-title {
    font-size: var(--text-2xl);
    flex-direction: column;
    gap: var(--space-2);
  }

  .step-item {
    flex-direction: column;
    text-align: center;
  }

  .journey-mascot {
    flex-direction: column;
    text-align: center;
  }
}

/* ===========================
   ACCESSIBILITY & UTILITIES
   =========================== */

.sr-only {
  position: absolute;
  width: 1px;
  height: 1px;
  padding: 0;
  margin: -1px;
  overflow: hidden;
  clip: rect(0, 0, 0, 0);
  white-space: nowrap;
  border: 0;
}

.skip-link {
  position: absolute;
  top: -40px;
  left: 6px;
  background: var(--text-primary);
  color: var(--bg-primary);
  padding: 8px;
  border-radius: 4px;
  text-decoration: none;
  z-index: 1000;
  transition: top 0.3s;
}

.skip-link:focus {
  top: 6px;
}

/* Focus styles */
.search-input:focus,
.theme-toggle:focus,
.cta-button:focus,
.btn:focus,
.nav-link:focus,
.help-card:focus,
.journey-option:focus {
  outline: 2px solid var(--aqua-primary);
  outline-offset: 2px;
}

/* Reduced motion */
@media (prefers-reduced-motion: reduce) {

  .mascot-animation,
  .spinner-animation {
    animation: none;
  }

  .help-card,
  .btn,
  .nav-link,
  .journey-option {
    transition: none;
  }

  .title-highlight {
    animation: none;
    background: var(--aqua-primary);
    background-clip: text;
    -webkit-background-clip: text;
    -webkit-text-fill-color: transparent;
  }
}

/* High contrast mode */
@media (prefers-contrast: high) {
  :root {
    --neutral-200: #000000;
    --text-secondary: #000000;
    --text-tertiary: #000000;
  }

  .help-card,
  .journey-option,
  .comparison-item {
    border-width: 3px;
  }
}

/* Print styles */
@media print {

  .docs-header,
  .docs-sidebar,
  .hero-actions,
  .cta-buttons,
  .mobile-menu-btn,
  .theme-toggle,
  .search-container {
    display: none;
  }

  .docs-layout {
    grid-template-areas: "content";
    grid-template-columns: 1fr;
  }

  .docs-content {
    padding: 0;
  }

  body {
    background: white;
    color: black;
  }

  .help-card,
  .journey-option,
  .docs-hero {
    break-inside: avoid;
  }
}