/* ================================================================
   SHARED.CSS — Personal Tech Docs
   Shared Design System for all documentation pages
   Author: Personal Knowledge Base
   Last Updated: July 29, 2026

   This file is the single source of truth for the design system.
   Every documentation page imports this file.
   Page-specific styles go in that page's own style.css.
   ================================================================ */

/* ================================================================
   1. CSS CUSTOM PROPERTIES (Design Tokens)
   ================================================================ */
:root {
  /* ── Palette – Light Theme ── */
  --c-bg:           #f8f9fc;
  --c-bg-alt:       #ffffff;
  --c-bg-card:      #ffffff;
  --c-bg-hover:     #f1f3f8;
  --c-bg-sidebar:   #ffffff;
  --c-bg-code:      #1b1e2e;
  --c-bg-code-hdr:  #252840;
  --c-bg-overlay:   rgba(0, 0, 0, 0.45);

  --c-text:         #0e1117;
  --c-text-2:       #374151;
  --c-text-muted:   #6b7280;
  --c-text-code:    #cdd6f4;
  --c-text-inv:     #ffffff;

  --c-border:       #e5e7eb;
  --c-border-light: #f3f4f6;

  /* ── Accent ── */
  --c-accent:       #4f46e5;
  --c-accent-h:     #4338ca;
  --c-accent-l:     #eef2ff;
  --c-accent-rgb:   79, 70, 229;

  /* ── Semantic Colors ── */
  --c-success:      #059669;
  --c-success-bg:   #ecfdf5;
  --c-success-bd:   #a7f3d0;
  --c-success-text: #065f46;

  --c-warn:         #d97706;
  --c-warn-bg:      #fffbeb;
  --c-warn-bd:      #fcd34d;
  --c-warn-text:    #92400e;

  --c-danger:       #dc2626;
  --c-danger-bg:    #fef2f2;
  --c-danger-bd:    #fca5a5;
  --c-danger-text:  #991b1b;

  --c-info:         #2563eb;
  --c-info-bg:      #eff6ff;
  --c-info-bd:      #93c5fd;
  --c-info-text:    #1e40af;

  /* ── Shadows ── */
  --shadow-xs:  0 1px 2px rgba(0,0,0,0.06);
  --shadow-sm:  0 1px 4px rgba(0,0,0,0.08), 0 0 0 1px rgba(0,0,0,0.04);
  --shadow-md:  0 4px 16px rgba(0,0,0,0.08), 0 1px 4px rgba(0,0,0,0.06);
  --shadow-lg:  0 8px 32px rgba(0,0,0,0.10), 0 2px 8px rgba(0,0,0,0.06);
  --shadow-xl:  0 16px 48px rgba(0,0,0,0.14), 0 4px 12px rgba(0,0,0,0.08);

  /* ── Border Radius ── */
  --r-xs:  4px;
  --r-sm:  6px;
  --r-md:  10px;
  --r-lg:  14px;
  --r-xl:  20px;
  --r-full: 9999px;

  /* ── Spacing ── */
  --space-1:  0.25rem;   /* 4px  */
  --space-2:  0.5rem;    /* 8px  */
  --space-3:  0.75rem;   /* 12px */
  --space-4:  1rem;      /* 16px */
  --space-5:  1.25rem;   /* 20px */
  --space-6:  1.5rem;    /* 24px */
  --space-8:  2rem;      /* 32px */
  --space-10: 2.5rem;    /* 40px */
  --space-12: 3rem;      /* 48px */
  --space-16: 4rem;      /* 64px */

  /* ── Layout ── */
  --sidebar-w:    270px;
  --header-h:     60px;
  --content-max:  800px;

  /* ── Typography ── */
  --font-sans: -apple-system, BlinkMacSystemFont, 'Segoe UI', 'Inter',
               Roboto, Oxygen, Ubuntu, Cantarell, 'Helvetica Neue', sans-serif;
  --font-mono: 'Cascadia Code', 'Fira Code', 'JetBrains Mono', 'Consolas',
               'Menlo', 'Monaco', monospace;

  --text-xs:   0.75rem;
  --text-sm:   0.8125rem;
  --text-base: 0.9375rem;
  --text-lg:   1.0625rem;
  --text-xl:   1.25rem;
  --text-2xl:  1.5rem;
  --text-3xl:  1.875rem;
  --text-4xl:  2.25rem;

  /* ── Transitions ── */
  --t-fast:   0.12s ease;
  --t-base:   0.2s ease;
  --t-slow:   0.35s cubic-bezier(0.4, 0, 0.2, 1);
  --t-spring: 0.4s cubic-bezier(0.34, 1.56, 0.64, 1);
}

/* ── Dark Theme ── */
[data-theme="dark"] {
  --c-bg:           #0c0d12;
  --c-bg-alt:       #0f1018;
  --c-bg-card:      #12141e;
  --c-bg-hover:     #1a1c28;
  --c-bg-sidebar:   #10111a;
  --c-bg-code:      #090b12;
  --c-bg-code-hdr:  #141624;

  --c-text:         #e8eaf0;
  --c-text-2:       #a8afc4;
  --c-text-muted:   #606880;
  --c-text-code:    #cdd6f4;

  --c-border:       #1e2038;
  --c-border-light: #161828;

  --c-accent-l:     #1e1b4b;

  --c-success-bg:   #022c22;
  --c-success-bd:   #065f46;
  --c-success-text: #6ee7b7;

  --c-warn-bg:      #1c1100;
  --c-warn-bd:      #78350f;
  --c-warn-text:    #fcd34d;

  --c-danger-bg:    #1c0808;
  --c-danger-bd:    #7f1d1d;
  --c-danger-text:  #fca5a5;

  --c-info-bg:      #0c1638;
  --c-info-bd:      #1e3a8a;
  --c-info-text:    #93c5fd;

  --shadow-xs:  0 1px 2px rgba(0,0,0,0.4);
  --shadow-sm:  0 1px 4px rgba(0,0,0,0.5), 0 0 0 1px rgba(255,255,255,0.04);
  --shadow-md:  0 4px 16px rgba(0,0,0,0.5), 0 1px 4px rgba(0,0,0,0.3);
  --shadow-lg:  0 8px 32px rgba(0,0,0,0.6), 0 2px 8px rgba(0,0,0,0.4);
  --shadow-xl:  0 16px 48px rgba(0,0,0,0.7), 0 4px 12px rgba(0,0,0,0.5);
}

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

html {
  font-size: 16px;
  scroll-behavior: smooth;
  -webkit-text-size-adjust: 100%;
  text-size-adjust: 100%;
}

body {
  font-family: var(--font-sans);
  font-size: var(--text-base);
  line-height: 1.75;
  color: var(--c-text);
  background-color: var(--c-bg);
  transition: background-color var(--t-slow), color var(--t-slow);
  -webkit-font-smoothing: antialiased;
  -moz-osx-font-smoothing: grayscale;
  overflow-x: hidden;
}

/* Loading fade-in — only on initial load */
@keyframes body-fadein {
  from { opacity: 0; }
  to   { opacity: 1; }
}
body {
  animation: body-fadein 0.35s ease forwards;
}

a {
  color: var(--c-accent);
  text-decoration: none;
  transition: color var(--t-base);
}
a:hover { color: var(--c-accent-h); text-decoration: underline; }
a:focus-visible {
  outline: 2px solid var(--c-accent);
  outline-offset: 3px;
  border-radius: var(--r-xs);
}

ul, ol { list-style: none; }

img { max-width: 100%; display: block; }

/* ================================================================
   3. READING PROGRESS BAR
   ================================================================ */
#progress-bar {
  position: fixed;
  top: 0;
  left: 0;
  width: 0%;
  height: 3px;
  background: linear-gradient(90deg, var(--c-accent), #7c3aed, #06b6d4);
  z-index: 10000;
  transition: width 0.1s linear;
  border-radius: 0 var(--r-full) var(--r-full) 0;
}

/* ================================================================
   4. SITE HEADER
   ================================================================ */
#site-header {
  position: sticky;
  top: 0;
  left: 0;
  right: 0;
  height: var(--header-h);
  background: var(--c-bg-alt);
  border-bottom: 1px solid var(--c-border);
  z-index: 1000;
  transition: background-color var(--t-slow), border-color var(--t-slow);
  backdrop-filter: blur(12px);
  -webkit-backdrop-filter: blur(12px);
}

/* Glass effect on header */
[data-theme="light"] #site-header {
  background: rgba(255, 255, 255, 0.85);
}
[data-theme="dark"] #site-header {
  background: rgba(15, 16, 24, 0.85);
}

.header-inner {
  max-width: calc(var(--sidebar-w) + var(--content-max) + var(--space-16));
  margin: 0 auto;
  padding: 0 var(--space-6);
  height: 100%;
  display: flex;
  align-items: center;
  justify-content: space-between;
  gap: var(--space-4);
}

/* Nav Brand */
.nav-brand {
  display: flex;
  align-items: center;
  gap: var(--space-3);
  color: var(--c-text);
  font-weight: 600;
  text-decoration: none;
  flex-shrink: 0;
  border-radius: var(--r-sm);
  padding: var(--space-1) var(--space-2);
  transition: background-color var(--t-base);
}
.nav-brand:hover {
  background: var(--c-bg-hover);
  color: var(--c-text);
  text-decoration: none;
}

.brand-icon-wrap {
  width: 32px;
  height: 32px;
  background: linear-gradient(135deg, var(--c-accent), #7c3aed);
  border-radius: var(--r-sm);
  display: flex;
  align-items: center;
  justify-content: center;
  color: #fff;
  flex-shrink: 0;
}

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

.brand-name {
  font-weight: 700;
  color: var(--c-text);
  letter-spacing: -0.01em;
}

.brand-sep {
  color: var(--c-border);
  font-weight: 300;
  font-size: 1.1em;
}

.brand-page {
  color: var(--c-text-muted);
  font-weight: 500;
}

/* Header Actions */
.header-actions {
  display: flex;
  align-items: center;
  gap: var(--space-2);
}

.kbd-hint {
  font-size: var(--text-xs);
  color: var(--c-text-muted);
  display: none;
}
@media (min-width: 900px) {
  .kbd-hint { display: inline; }
}

/* Icon Button — used for mobile menu button */
.icon-btn {
  width: 36px;
  height: 36px;
  border: none;
  border-radius: var(--r-sm);
  background: transparent;
  color: var(--c-text-muted);
  cursor: pointer;
  display: flex;
  align-items: center;
  justify-content: center;
  transition: background-color var(--t-base), color var(--t-base);
  flex-shrink: 0;
  position: relative;
}
.icon-btn:hover {
  background: var(--c-bg-hover);
  color: var(--c-text);
}
.icon-btn:focus-visible {
  outline: 2px solid var(--c-accent);
  outline-offset: 2px;
}

/* Menu / Close icon logic */
.icon-close { display: none; }
body.sidebar-open .icon-menu  { display: none; }
body.sidebar-open .icon-close { display: block; }

/* ----------------------------------------------------------------
   THEME TOGGLE — Animated pill switch
---------------------------------------------------------------- */
.theme-toggle {
  position: relative;
  display: inline-flex;
  align-items: center;
  width: 60px;
  height: 30px;
  background: #d1d5db;
  border-radius: var(--r-full);
  border: none;
  cursor: pointer;
  padding: 0 4px;
  gap: 0;
  flex-shrink: 0;
  justify-content: space-between;
  transition: background-color 0.35s cubic-bezier(0.4, 0, 0.2, 1), box-shadow 0.3s ease, filter 0.2s ease;
  outline: none;
  box-shadow: inset 0 2px 4px rgba(0,0,0,0.1);
}

[data-theme="light"] .theme-toggle {
  background: linear-gradient(135deg, #fbbf24, #f59e0b);
}
[data-theme="dark"] .theme-toggle {
  background: linear-gradient(135deg, #4f46e5, #7c3aed);
  box-shadow: inset 0 2px 4px rgba(0,0,0,0.3), 0 0 12px rgba(124, 58, 237, 0.3);
}

.theme-toggle:focus-visible {
  outline: 2px solid var(--c-accent);
  outline-offset: 3px;
  border-radius: var(--r-full);
}
.theme-toggle:hover {
  filter: brightness(1.08);
  transform: scale(1.03);
}
.theme-toggle:active {
  transform: scale(0.97);
}

.theme-toggle-icon {
  display: flex;
  align-items: center;
  justify-content: center;
  width: 20px;
  height: 20px;
  z-index: 1;
  transition: opacity 0.3s ease, transform 0.4s cubic-bezier(0.34, 1.56, 0.64, 1), color 0.3s ease;
  color: #fff;
  flex-shrink: 0;
}

.theme-toggle-sun {
  opacity: 1;
  transform: rotate(0deg) scale(1);
}
[data-theme="dark"] .theme-toggle-sun {
  opacity: 0.4;
  transform: rotate(-90deg) scale(0.75);
}

.theme-toggle-moon {
  opacity: 0.4;
  transform: rotate(90deg) scale(0.75);
}
[data-theme="dark"] .theme-toggle-moon {
  opacity: 1;
  transform: rotate(0deg) scale(1);
}

.theme-toggle-knob {
  position: absolute;
  top: 3px;
  left: 3px;
  width: 24px;
  height: 24px;
  background: #ffffff;
  border-radius: var(--r-full);
  box-shadow: 0 2px 6px rgba(0,0,0,0.25), 0 0 0 1px rgba(0,0,0,0.06);
  transition: transform 0.4s cubic-bezier(0.34, 1.56, 0.64, 1), background-color 0.3s ease;
  z-index: 2;
  pointer-events: none;
}

[data-theme="dark"] .theme-toggle-knob {
  transform: translateX(30px);
  background: #ffffff;
  box-shadow: 0 2px 8px rgba(0,0,0,0.5), 0 0 0 1px rgba(255,255,255,0.1);
}

/* Hide mobile menu btn on desktop */
#mobile-menu-btn {
  display: none;
}

/* ================================================================
   5. PAGE LAYOUT — Sidebar + Main
   ================================================================ */
.page-layout {
  display: flex;
  min-height: calc(100vh - var(--header-h));
  max-width: calc(var(--sidebar-w) + var(--content-max) + var(--space-16));
  margin: 0 auto;
  padding: 0 var(--space-6);
  gap: var(--space-8);
  align-items: flex-start;
}

/* ================================================================
   6. SIDEBAR
   ================================================================ */
#sidebar {
  width: var(--sidebar-w);
  flex-shrink: 0;
  position: sticky;
  top: calc(var(--header-h) + var(--space-6));
  max-height: calc(100vh - var(--header-h) - var(--space-12));
  overflow-y: auto;
  overflow-x: hidden;
  padding: var(--space-2) 0 var(--space-8);
  transition: background-color var(--t-slow);
  scrollbar-width: thin;
  scrollbar-color: var(--c-border) transparent;
}

#sidebar::-webkit-scrollbar { width: 4px; }
#sidebar::-webkit-scrollbar-track { background: transparent; }
#sidebar::-webkit-scrollbar-thumb { background: var(--c-border); border-radius: 2px; }

.sidebar-inner {
  padding-right: var(--space-4);
}

.sidebar-section-label {
  font-size: var(--text-xs);
  font-weight: 700;
  color: var(--c-text-muted);
  text-transform: uppercase;
  letter-spacing: 0.08em;
  padding: 0 var(--space-3);
  margin-bottom: var(--space-3);
}

/* TOC List */
.toc-list {
  display: flex;
  flex-direction: column;
  gap: 2px;
}

.toc-group-label {
  font-size: var(--text-xs);
  font-weight: 600;
  color: var(--c-text-muted);
  text-transform: uppercase;
  letter-spacing: 0.07em;
  padding: var(--space-3) var(--space-3) var(--space-1);
  margin-top: var(--space-2);
}

.toc-link {
  display: flex;
  align-items: center;
  gap: var(--space-2);
  padding: var(--space-2) var(--space-3);
  font-size: var(--text-sm);
  font-weight: 500;
  color: var(--c-text-muted);
  border-radius: var(--r-sm);
  text-decoration: none;
  transition: background-color var(--t-base), color var(--t-base);
  line-height: 1.4;
  white-space: nowrap;
  overflow: hidden;
  text-overflow: ellipsis;
}
.toc-link:hover {
  background: var(--c-bg-hover);
  color: var(--c-text);
  text-decoration: none;
}
.toc-link.active {
  background: var(--c-accent-l);
  color: var(--c-accent);
  font-weight: 600;
}
[data-theme="dark"] .toc-link.active {
  background: rgba(var(--c-accent-rgb), 0.15);
  color: #818cf8;
}

.toc-icon {
  flex-shrink: 0;
  opacity: 0.6;
}
.toc-link.active .toc-icon { opacity: 1; }

.toc-link.toc-step {
  padding-left: var(--space-2);
  gap: var(--space-2);
}

.toc-step-badge {
  width: 20px;
  height: 20px;
  border-radius: var(--r-full);
  background: var(--c-border);
  color: var(--c-text-muted);
  font-size: 0.6875rem;
  font-weight: 700;
  display: flex;
  align-items: center;
  justify-content: center;
  flex-shrink: 0;
  transition: background-color var(--t-base), color var(--t-base);
}
.toc-link.active .toc-step-badge {
  background: var(--c-accent);
  color: #fff;
}

/* Sidebar Divider */
.sidebar-divider {
  height: 1px;
  background: var(--c-border);
  margin: var(--space-4) 0;
}

/* Copy All Commands Button */
.copy-all-btn {
  display: flex;
  align-items: center;
  gap: var(--space-2);
  width: 100%;
  padding: var(--space-2) var(--space-3);
  border: 1px solid var(--c-border);
  border-radius: var(--r-sm);
  background: transparent;
  color: var(--c-text-muted);
  font-size: var(--text-sm);
  font-weight: 500;
  font-family: var(--font-sans);
  cursor: pointer;
  transition: all var(--t-base);
  text-align: left;
}
.copy-all-btn:hover {
  background: var(--c-bg-hover);
  border-color: var(--c-accent);
  color: var(--c-accent);
}
.copy-all-btn:focus-visible {
  outline: 2px solid var(--c-accent);
  outline-offset: 2px;
}

/* Sidebar Meta */
.sidebar-meta {
  margin-top: var(--space-4);
  display: flex;
  flex-direction: column;
  gap: var(--space-2);
}
.sidebar-meta-item {
  display: flex;
  align-items: center;
  gap: var(--space-2);
  font-size: var(--text-xs);
  color: var(--c-text-muted);
  padding: 0 var(--space-3);
}

/* ================================================================
   7. MAIN CONTENT AREA
   ================================================================ */
#main-content {
  flex: 1;
  min-width: 0;
  padding: var(--space-6) 0 var(--space-16);
  max-width: var(--content-max);
}

/* ================================================================
   8. DOCUMENT SECTIONS
   ================================================================ */
.doc-section {
  margin-bottom: var(--space-12);
  scroll-margin-top: calc(var(--header-h) + var(--space-6));
}

/* Scroll animation (respects prefers-reduced-motion) */
@media (prefers-reduced-motion: no-preference) {
  .doc-section {
    opacity: 0;
    transform: translateY(20px);
    transition: opacity 0.55s ease, transform 0.55s ease;
  }
  .doc-section.visible {
    opacity: 1;
    transform: translateY(0);
  }
}
@media (prefers-reduced-motion: reduce) {
  .doc-section { opacity: 1; transform: none; }
}

/* Section typography */
.section-title {
  font-size: var(--text-2xl);
  font-weight: 700;
  color: var(--c-text);
  letter-spacing: -0.02em;
  margin-bottom: var(--space-4);
  line-height: 1.3;
}

.section-intro {
  color: var(--c-text-2);
  margin-bottom: var(--space-6);
  font-size: var(--text-base);
}

/* ================================================================
   9. HERO SECTION
   ================================================================ */
.hero-section {
  padding: var(--space-8) 0 var(--space-6);
  border-bottom: 1px solid var(--c-border);
  margin-bottom: var(--space-10);
}

.hero-eyebrow {
  display: flex;
  align-items: center;
  gap: var(--space-3);
  margin-bottom: var(--space-4);
  flex-wrap: wrap;
}

.eyebrow-badge {
  display: inline-flex;
  align-items: center;
  gap: var(--space-1);
  background: var(--c-accent-l);
  color: var(--c-accent);
  font-size: var(--text-xs);
  font-weight: 700;
  padding: 3px var(--space-2);
  border-radius: var(--r-full);
  letter-spacing: 0.03em;
  text-transform: uppercase;
}
[data-theme="dark"] .eyebrow-badge {
  background: rgba(var(--c-accent-rgb), 0.15);
  color: #818cf8;
}

.eyebrow-sep { color: var(--c-border); }

.eyebrow-date {
  font-size: var(--text-sm);
  color: var(--c-text-muted);
}

.hero-title {
  font-size: clamp(1.75rem, 4vw, var(--text-4xl));
  font-weight: 800;
  color: var(--c-text);
  letter-spacing: -0.03em;
  line-height: 1.2;
  margin-bottom: var(--space-4);
}

.hero-subtitle {
  font-size: var(--text-lg);
  color: var(--c-text-2);
  line-height: 1.7;
  max-width: 640px;
  margin-bottom: var(--space-8);
}

/* Hero Meta Grid */
.hero-meta-grid {
  display: grid;
  grid-template-columns: repeat(auto-fit, minmax(160px, 1fr));
  gap: var(--space-3);
}

.meta-card {
  display: flex;
  align-items: center;
  gap: var(--space-3);
  background: var(--c-bg-card);
  border: 1px solid var(--c-border);
  border-radius: var(--r-md);
  padding: var(--space-4);
  transition: border-color var(--t-base), transform var(--t-base), box-shadow var(--t-base);
}
.meta-card:hover {
  border-color: rgba(var(--c-accent-rgb), 0.5);
  box-shadow: var(--shadow-sm);
  transform: translateY(-1px);
}

.meta-card-icon { font-size: 1.4rem; flex-shrink: 0; }

.meta-card-label {
  font-size: var(--text-xs);
  color: var(--c-text-muted);
  font-weight: 600;
  text-transform: uppercase;
  letter-spacing: 0.05em;
}

.meta-card-value {
  font-size: var(--text-sm);
  font-weight: 600;
  color: var(--c-text);
  margin-top: 2px;
}

/* Badge */
.badge {
  display: inline-flex;
  align-items: center;
  font-size: var(--text-xs);
  font-weight: 700;
  padding: 2px var(--space-2);
  border-radius: var(--r-full);
  line-height: 1.5;
}

.badge-amber {
  background: var(--c-warn-bg);
  color: var(--c-warn-text);
  border: 1px solid var(--c-warn-bd);
}
.badge-green {
  background: var(--c-success-bg);
  color: var(--c-success-text);
  border: 1px solid var(--c-success-bd);
}
.badge-blue {
  background: var(--c-info-bg);
  color: var(--c-info-text);
  border: 1px solid var(--c-info-bd);
}

/* ================================================================
   10. PREREQUISITES / REQUIREMENTS GRID
   ================================================================ */
.requirements-grid {
  display: grid;
  grid-template-columns: repeat(auto-fit, minmax(240px, 1fr));
  gap: var(--space-3);
  margin-top: var(--space-6);
}

.req-item {
  display: flex;
  align-items: flex-start;
  gap: var(--space-3);
  background: var(--c-bg-card);
  border: 1px solid var(--c-border);
  border-radius: var(--r-md);
  padding: var(--space-4);
  transition: border-color var(--t-base), box-shadow var(--t-base);
}
.req-item:hover {
  border-color: var(--c-accent);
  box-shadow: var(--shadow-sm);
}

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

.req-item-title {
  font-size: var(--text-sm);
  font-weight: 700;
  color: var(--c-text);
  margin-bottom: 2px;
}

.req-item-desc {
  font-size: var(--text-xs);
  color: var(--c-text-muted);
  line-height: 1.5;
}

/* ================================================================
   11. STEP CARDS
   ================================================================ */
.step-section { margin-bottom: var(--space-8); }

.step-card {
  background: var(--c-bg-card);
  border: 1px solid var(--c-border);
  border-radius: var(--r-lg);
  overflow: hidden;
  box-shadow: var(--shadow-sm);
  transition: box-shadow 0.35s cubic-bezier(0.4, 0, 0.2, 1), border-color 0.35s ease, transform 0.35s cubic-bezier(0.34, 1.56, 0.64, 1);
}
.step-card:hover {
  box-shadow: var(--shadow-md), 0 0 0 1px rgba(var(--c-accent-rgb), 0.15);
  transform: translateY(-2px);
}

/* Step-specific accent colors */
.step-card[data-step="1"] { border-left: 4px solid #4f46e5; }
.step-card[data-step="2"] { border-left: 4px solid #7c3aed; }
.step-card[data-step="3"] { border-left: 4px solid #ea580c; }
.step-card[data-step="4"] { border-left: 4px solid #059669; }
.step-card[data-step="5"] { border-left: 4px solid #0891b2; }
.step-card[data-step="6"] { border-left: 4px solid #db2777; }

.step-card-header {
  display: flex;
  align-items: flex-start;
  gap: var(--space-4);
  padding: var(--space-5) var(--space-6);
  border-bottom: 1px solid var(--c-border);
  cursor: default;
  background: var(--c-bg-card);
  transition: background-color var(--t-base);
}
.step-card-header:hover { background: var(--c-bg-hover); }

.step-badge {
  width: 36px;
  height: 36px;
  border-radius: var(--r-full);
  display: flex;
  align-items: center;
  justify-content: center;
  font-size: var(--text-sm);
  font-weight: 800;
  flex-shrink: 0;
  color: #fff;
  margin-top: 2px;
  transition: transform 0.35s cubic-bezier(0.34, 1.56, 0.64, 1), box-shadow 0.3s ease;
}
.step-card:hover .step-badge {
  transform: scale(1.08) rotate(3deg);
  box-shadow: 0 4px 12px rgba(0,0,0,0.18);
}

.step-card[data-step="1"] .step-badge { background: linear-gradient(135deg, #4f46e5, #7c3aed); }
.step-card[data-step="2"] .step-badge { background: linear-gradient(135deg, #7c3aed, #9333ea); }
.step-card[data-step="3"] .step-badge { background: linear-gradient(135deg, #ea580c, #f59e0b); }
.step-card[data-step="4"] .step-badge { background: linear-gradient(135deg, #059669, #0891b2); }
.step-card[data-step="5"] .step-badge { background: linear-gradient(135deg, #0891b2, #4f46e5); }
.step-card[data-step="6"] .step-badge { background: linear-gradient(135deg, #db2777, #ea580c); }

.step-header-info { flex: 1; min-width: 0; }

.step-title {
  font-size: var(--text-xl);
  font-weight: 700;
  color: var(--c-text);
  letter-spacing: -0.02em;
  line-height: 1.3;
  margin-bottom: var(--space-1);
}

.step-desc {
  font-size: var(--text-sm);
  color: var(--c-text-muted);
  line-height: 1.5;
}

/* Collapse Button */
.collapse-btn {
  width: 28px;
  height: 28px;
  border: none;
  border-radius: var(--r-sm);
  background: transparent;
  color: var(--c-text-muted);
  cursor: pointer;
  display: flex;
  align-items: center;
  justify-content: center;
  flex-shrink: 0;
  margin-top: 4px;
  transition: background-color var(--t-base), color var(--t-base), transform 0.3s cubic-bezier(0.34, 1.56, 0.64, 1);
}
.collapse-btn:hover { background: var(--c-bg-hover); color: var(--c-text); transform: scale(1.1); }
.collapse-btn:focus-visible { outline: 2px solid var(--c-accent); outline-offset: 2px; }
.collapse-btn[aria-expanded="false"] svg { transform: rotate(180deg); }
.collapse-btn svg { transition: transform 0.35s cubic-bezier(0.34, 1.56, 0.64, 1); }

/* Step Card Body */
.step-card-body {
  padding: var(--space-6);
  display: flex;
  flex-direction: column;
  gap: var(--space-5);
  transition: all 0.4s cubic-bezier(0.4, 0, 0.2, 1);
  overflow: hidden;
}
.step-card-body.collapsed { padding: 0; height: 0; gap: 0; }

.step-card-body h3 {
  font-size: var(--text-base);
  font-weight: 700;
  color: var(--c-text);
  letter-spacing: -0.01em;
  margin-top: var(--space-2);
  margin-bottom: 0;
}

.step-card-body p {
  color: var(--c-text-2);
  font-size: var(--text-base);
  line-height: 1.75;
  margin: 0;
}

/* ================================================================
   12. ALERT / CALLOUT BOXES
   ================================================================ */
.alert {
  display: flex;
  align-items: flex-start;
  gap: var(--space-3);
  padding: var(--space-4) var(--space-5);
  border-radius: var(--r-md);
  border: 1px solid;
  font-size: var(--text-sm);
  line-height: 1.65;
  transition: transform 0.25s ease, box-shadow 0.25s ease, border-color 0.25s ease;
}
.alert:hover {
  transform: translateX(3px);
  box-shadow: var(--shadow-sm);
}

.alert-body { flex: 1; min-width: 0; }
.alert-body strong {
  display: block;
  font-weight: 700;
  margin-bottom: var(--space-1);
  font-size: var(--text-sm);
}
.alert-body p { margin: 0; color: inherit; font-size: inherit; }
.alert-body ul {
  margin: var(--space-2) 0 0 var(--space-4);
  display: flex;
  flex-direction: column;
  gap: var(--space-1);
  list-style: disc;
}
.alert-body li { list-style: disc; }

.alert-icon {
  flex-shrink: 0;
  margin-top: 1px;
  display: flex;
  align-items: center;
  justify-content: center;
  transition: transform 0.3s cubic-bezier(0.34, 1.56, 0.64, 1);
}
.alert:hover .alert-icon {
  transform: scale(1.15) rotate(4deg);
}

.alert-danger {
  background: var(--c-danger-bg);
  border-color: var(--c-danger-bd);
  border-left: 3px solid var(--c-danger);
  color: var(--c-danger-text);
}
.alert-danger .alert-icon { color: var(--c-danger); }

.alert-warning {
  background: var(--c-warn-bg);
  border-color: var(--c-warn-bd);
  border-left: 3px solid var(--c-warn);
  color: var(--c-warn-text);
}
.alert-warning .alert-icon { color: var(--c-warn); }

.alert-success {
  background: var(--c-success-bg);
  border-color: var(--c-success-bd);
  border-left: 3px solid var(--c-success);
  color: var(--c-success-text);
}
.alert-success .alert-icon { color: var(--c-success); }

.alert-info {
  background: var(--c-info-bg);
  border-color: var(--c-info-bd);
  border-left: 3px solid var(--c-info);
  color: var(--c-info-text);
}
.alert-info .alert-icon { color: var(--c-info); }

/* ================================================================
   13. CODE BLOCKS
   ================================================================ */
.code-block {
  border-radius: var(--r-md);
  overflow: hidden;
  background: var(--c-bg-code);
  box-shadow: var(--shadow-md);
  transition: box-shadow 0.35s cubic-bezier(0.4, 0, 0.2, 1), border-color 0.35s ease, transform 0.3s ease;
  border: 1px solid rgba(255,255,255,0.08);
  position: relative;
}
.code-block:hover {
  box-shadow: 0 12px 32px rgba(0, 0, 0, 0.35), 0 0 0 1px rgba(var(--c-accent-rgb), 0.35);
  border-color: rgba(var(--c-accent-rgb), 0.3);
}

.code-block-header {
  display: flex;
  align-items: center;
  justify-content: space-between;
  padding: var(--space-3) var(--space-4);
  background: var(--c-bg-code-hdr);
  border-bottom: 1px solid rgba(255,255,255,0.07);
  gap: var(--space-3);
}

.code-lang-badge {
  display: flex;
  align-items: center;
  gap: var(--space-2);
  font-size: var(--text-xs);
  font-weight: 700;
  font-family: var(--font-mono);
  color: rgba(205, 214, 244, 0.7);
  text-transform: uppercase;
  letter-spacing: 0.08em;
}
.code-lang-badge svg { opacity: 0.7; transition: transform 0.3s ease; }
.code-block:hover .code-lang-badge svg { transform: rotate(5deg) scale(1.1); color: var(--c-accent); opacity: 1; }

.copy-btn {
  display: flex;
  align-items: center;
  gap: var(--space-2);
  padding: 5px var(--space-3);
  min-width: 72px;
  justify-content: center;
  border: 1px solid rgba(255,255,255,0.14);
  border-radius: var(--r-sm);
  background: rgba(255,255,255,0.06);
  color: rgba(205, 214, 244, 0.72);
  font-size: var(--text-xs);
  font-weight: 600;
  font-family: var(--font-sans);
  cursor: pointer;
  transition: background 0.2s ease, border-color 0.2s ease, color 0.2s ease, transform 0.2s cubic-bezier(0.34, 1.56, 0.64, 1);
  flex-shrink: 0;
  white-space: nowrap;
  letter-spacing: 0.01em;
}
.copy-btn:hover {
  background: rgba(255,255,255,0.16);
  border-color: rgba(255,255,255,0.35);
  color: rgba(205, 214, 244, 1);
  transform: translateY(-1px);
}
.copy-btn:active { transform: scale(0.94); }
.copy-btn:focus-visible { outline: 2px solid var(--c-accent); outline-offset: 2px; }

.copy-btn.copied {
  background: rgba(5, 150, 105, 0.25);
  border-color: rgba(5, 150, 105, 0.5);
  color: #34d399;
  animation: copy-success-bounce 0.45s cubic-bezier(0.34, 1.56, 0.64, 1) forwards;
}
@keyframes copy-success-bounce {
  0%   { transform: scale(0.92); }
  50%  { transform: scale(1.08); }
  100% { transform: scale(1); }
}

.check-icon {
  display: none;
  animation: check-scale-in 0.3s cubic-bezier(0.34, 1.56, 0.64, 1) forwards;
}
@keyframes check-scale-in {
  from { opacity: 0; transform: scale(0.5) rotate(-15deg); }
  to   { opacity: 1; transform: scale(1) rotate(0deg); }
}
.copy-btn.copied .copy-icon { display: none; }
.copy-btn.copied .check-icon { display: block; }

.code-block-body {
  overflow-x: auto;
  scrollbar-width: thin;
  scrollbar-color: rgba(255,255,255,0.15) transparent;
  position: relative;
}
.code-block-body::-webkit-scrollbar { height: 4px; }
.code-block-body::-webkit-scrollbar-track { background: transparent; }
.code-block-body::-webkit-scrollbar-thumb { background: rgba(255,255,255,0.15); border-radius: 2px; }

.code-block-body pre {
  margin: 0;
  padding: var(--space-5) var(--space-6);
  font-family: var(--font-mono);
  font-size: 0.8125rem;
  line-height: 1.8;
  color: var(--c-text-code);
  white-space: pre;
  tab-size: 2;
}

.code-block-body code {
  font-family: inherit;
  background: none;
  padding: 0;
  border: none;
  font-size: inherit;
  color: inherit;
}

/* Inline code */
p code, li code, .alert-body code {
  font-family: var(--font-mono);
  font-size: 0.85em;
  background: var(--c-bg-hover);
  color: var(--c-accent);
  padding: 2px 6px;
  border-radius: var(--r-xs);
  border: 1px solid var(--c-border);
}
[data-theme="dark"] p code,
[data-theme="dark"] li code,
[data-theme="dark"] .alert-body code {
  background: rgba(var(--c-accent-rgb), 0.12);
  border-color: rgba(var(--c-accent-rgb), 0.25);
  color: #a5b4fc;
}
.alert-danger code { color: var(--c-danger-text); background: rgba(220,38,38,0.1); border-color: var(--c-danger-bd); }
.alert-warning code { color: var(--c-warn-text); background: rgba(217,119,6,0.1); border-color: var(--c-warn-bd); }
.alert-info code { color: var(--c-info-text); background: rgba(37,99,235,0.1); border-color: var(--c-info-bd); }
.alert-success code { color: var(--c-success-text); background: rgba(5,150,105,0.1); border-color: var(--c-success-bd); }

/* Keyboard keys */
kbd {
  font-family: var(--font-mono);
  font-size: 0.78em;
  background: var(--c-bg-card);
  color: var(--c-text-2);
  border: 1px solid var(--c-border);
  border-bottom-width: 2px;
  border-radius: var(--r-xs);
  padding: 1px 5px;
  box-shadow: 0 1px 0 var(--c-border);
}

/* ================================================================
   14. FINAL INSTALLATION STEPS
   ================================================================ */
.install-steps {
  display: flex;
  flex-direction: column;
  gap: 0;
  margin-bottom: var(--space-6);
  position: relative;
}

.install-steps::before {
  content: '';
  position: absolute;
  left: 18px;
  top: 36px;
  bottom: 36px;
  width: 2px;
  background: linear-gradient(to bottom, var(--c-accent), var(--c-border));
  border-radius: 1px;
}

.install-step {
  display: flex;
  flex-direction: column;
  gap: var(--space-2);
  padding: var(--space-5) 0;
  padding-left: calc(36px + var(--space-4));
  position: relative;
}

.install-step-header {
  display: flex;
  align-items: center;
  gap: var(--space-3);
  position: relative;
  margin-left: calc(-36px - var(--space-4));
}

.install-step-num {
  width: 36px;
  height: 36px;
  border-radius: var(--r-full);
  background: var(--c-accent);
  color: #fff;
  font-size: var(--text-sm);
  font-weight: 800;
  display: flex;
  align-items: center;
  justify-content: center;
  flex-shrink: 0;
  z-index: 1;
  box-shadow: 0 0 0 3px var(--c-bg);
}

.install-step-title {
  font-size: var(--text-base);
  font-weight: 700;
  color: var(--c-text);
  letter-spacing: -0.01em;
}

.install-step-body {
  color: var(--c-text-2);
  font-size: var(--text-base);
  line-height: 1.75;
}

/* ================================================================
   15. CHECKLIST
   ================================================================ */
.checklist {
  display: flex;
  flex-direction: column;
  gap: var(--space-2);
  margin-bottom: var(--space-6);
}

.check-item {
  display: flex;
  align-items: flex-start;
  gap: var(--space-3);
  padding: var(--space-3) var(--space-4);
  background: var(--c-bg-card);
  border: 1px solid var(--c-border);
  border-radius: var(--r-md);
  cursor: pointer;
  transition: border-color 0.25s ease, background-color 0.25s ease, transform 0.25s cubic-bezier(0.34, 1.56, 0.64, 1), box-shadow 0.25s ease;
  user-select: none;
}
.check-item:hover {
  border-color: var(--c-accent);
  background: var(--c-accent-l);
  transform: translateX(2px);
  box-shadow: var(--shadow-xs);
}
[data-theme="dark"] .check-item:hover {
  background: rgba(var(--c-accent-rgb), 0.08);
}

.check-input {
  position: absolute;
  opacity: 0;
  width: 0;
  height: 0;
}

.check-box {
  width: 20px;
  height: 20px;
  border: 2px solid var(--c-border);
  border-radius: var(--r-xs);
  flex-shrink: 0;
  display: flex;
  align-items: center;
  justify-content: center;
  margin-top: 2px;
  transition: background-color 0.25s ease, border-color 0.25s ease, transform 0.3s cubic-bezier(0.34, 1.56, 0.64, 1), box-shadow 0.25s ease;
  background: transparent;
}

.check-mark {
  opacity: 0;
  transform: scale(0.3) rotate(-20deg);
  transition: opacity 0.2s ease, transform 0.35s cubic-bezier(0.34, 1.56, 0.64, 1);
  color: #fff;
}

.check-input:checked + .check-box {
  background: var(--c-accent);
  border-color: var(--c-accent);
  transform: scale(1.1);
  box-shadow: 0 0 10px rgba(var(--c-accent-rgb), 0.3);
}
.check-input:checked + .check-box .check-mark {
  opacity: 1;
  transform: scale(1) rotate(0deg);
}
.check-input:focus-visible + .check-box {
  outline: 2px solid var(--c-accent);
  outline-offset: 2px;
}

.check-label {
  font-size: var(--text-sm);
  color: var(--c-text-2);
  line-height: 1.55;
  flex: 1;
  transition: color 0.25s ease, opacity 0.25s ease;
}

.check-input:checked ~ .check-label {
  color: var(--c-text-muted);
  text-decoration: line-through;
  opacity: 0.65;
}

.check-item:has(.check-input:checked) {
  border-color: var(--c-success-bd);
  background: var(--c-success-bg);
}

.checklist-actions {
  display: flex;
  justify-content: flex-end;
}

.btn-secondary {
  display: inline-flex;
  align-items: center;
  gap: var(--space-2);
  padding: var(--space-2) var(--space-4);
  border: 1px solid var(--c-border);
  border-radius: var(--r-sm);
  background: transparent;
  color: var(--c-text-muted);
  font-size: var(--text-sm);
  font-weight: 500;
  font-family: var(--font-sans);
  cursor: pointer;
  transition: all var(--t-base);
}
.btn-secondary:hover {
  background: var(--c-bg-hover);
  color: var(--c-danger);
  border-color: var(--c-danger-bd);
}

/* ================================================================
   16. SITE FOOTER
   ================================================================ */
#site-footer {
  border-top: 1px solid var(--c-border);
  background: var(--c-bg-alt);
  transition: background-color var(--t-slow), border-color var(--t-slow);
}

.footer-inner {
  max-width: calc(var(--sidebar-w) + var(--content-max) + var(--space-16));
  margin: 0 auto;
  padding: var(--space-6);
  display: flex;
  align-items: center;
  justify-content: space-between;
  gap: var(--space-4);
  flex-wrap: wrap;
}

.footer-brand {
  display: flex;
  align-items: center;
  gap: var(--space-2);
  font-weight: 700;
  font-size: var(--text-sm);
  color: var(--c-text);
}

.footer-meta {
  display: flex;
  align-items: center;
  gap: var(--space-3);
  font-size: var(--text-xs);
  color: var(--c-text-muted);
  flex-wrap: wrap;
}

.footer-sep { color: var(--c-border); }

.footer-btn {
  display: inline-flex;
  align-items: center;
  gap: var(--space-2);
  padding: var(--space-2) var(--space-3);
  border: 1px solid var(--c-border);
  border-radius: var(--r-sm);
  background: transparent;
  color: var(--c-text-muted);
  font-size: var(--text-xs);
  font-weight: 500;
  font-family: var(--font-sans);
  cursor: pointer;
  transition: all var(--t-base);
}
.footer-btn:hover {
  background: var(--c-bg-hover);
  color: var(--c-text);
  border-color: var(--c-text-muted);
}

/* ================================================================
   17. BACK TO TOP BUTTON
   ================================================================ */
#back-to-top {
  position: fixed;
  bottom: var(--space-6);
  right: var(--space-6);
  width: 44px;
  height: 44px;
  border-radius: var(--r-full);
  background: var(--c-accent);
  color: #fff;
  border: none;
  cursor: pointer;
  display: flex;
  align-items: center;
  justify-content: center;
  box-shadow: var(--shadow-lg);
  z-index: 500;
  opacity: 0;
  transform: translateY(16px) scale(0.9);
  pointer-events: none;
  transition: opacity var(--t-slow), transform var(--t-slow), background-color var(--t-base);
}
#back-to-top:hover {
  background: var(--c-accent-h);
  transform: translateY(0) scale(1.05);
}
#back-to-top:focus-visible {
  outline: 2px solid var(--c-accent);
  outline-offset: 3px;
}
#back-to-top.visible {
  opacity: 1;
  transform: translateY(0) scale(1);
  pointer-events: all;
}

/* ================================================================
   18. TOAST NOTIFICATIONS
   ================================================================ */
#toast-container {
  position: fixed;
  bottom: var(--space-6);
  left: 50%;
  transform: translateX(-50%);
  z-index: 5000;
  display: flex;
  flex-direction: column-reverse;
  gap: var(--space-2);
  pointer-events: none;
  width: max-content;
  max-width: 90vw;
}

.toast {
  display: inline-flex;
  align-items: center;
  gap: var(--space-3);
  padding: var(--space-3) var(--space-5);
  background: var(--c-text);
  color: var(--c-bg);
  border-radius: var(--r-full);
  font-size: var(--text-sm);
  font-weight: 600;
  box-shadow: var(--shadow-xl);
  pointer-events: none;
  white-space: nowrap;
  animation: toast-in 0.35s cubic-bezier(0.34, 1.56, 0.64, 1) forwards;
}
.toast.toast-out { animation: toast-out 0.25s ease forwards; }

@keyframes toast-in {
  from { opacity: 0; transform: translateY(12px) scale(0.9); }
  to   { opacity: 1; transform: translateY(0) scale(1); }
}
@keyframes toast-out {
  from { opacity: 1; transform: translateY(0) scale(1); }
  to   { opacity: 0; transform: translateY(8px) scale(0.95); }
}

.toast-icon { font-size: 1rem; }

/* ================================================================
   19. KEYBOARD SHORTCUTS MODAL
   ================================================================ */
.modal {
  position: fixed;
  inset: 0;
  z-index: 9000;
  display: flex;
  align-items: center;
  justify-content: center;
  padding: var(--space-6);
  pointer-events: none;
  opacity: 0;
  transition: opacity var(--t-base);
}
.modal[aria-hidden="false"] {
  pointer-events: all;
  opacity: 1;
}

.modal-backdrop {
  position: fixed;
  inset: 0;
  background: var(--c-bg-overlay);
  backdrop-filter: blur(4px);
  -webkit-backdrop-filter: blur(4px);
}

.modal-panel {
  position: relative;
  background: var(--c-bg-card);
  border: 1px solid var(--c-border);
  border-radius: var(--r-xl);
  box-shadow: var(--shadow-xl);
  width: 100%;
  max-width: 400px;
  transform: scale(0.96) translateY(8px);
  transition: transform var(--t-slow);
}
.modal[aria-hidden="false"] .modal-panel {
  transform: scale(1) translateY(0);
}

.modal-header {
  display: flex;
  align-items: center;
  justify-content: space-between;
  padding: var(--space-5) var(--space-6);
  border-bottom: 1px solid var(--c-border);
}

.modal-title {
  font-size: var(--text-base);
  font-weight: 700;
  color: var(--c-text);
  letter-spacing: -0.01em;
}

.modal-close {
  width: 28px;
  height: 28px;
  border: none;
  border-radius: var(--r-sm);
  background: transparent;
  color: var(--c-text-muted);
  cursor: pointer;
  display: flex;
  align-items: center;
  justify-content: center;
  transition: all var(--t-base);
}
.modal-close:hover { background: var(--c-bg-hover); color: var(--c-text); }

.modal-body { padding: var(--space-5) var(--space-6); }

.shortcut-list {
  display: flex;
  flex-direction: column;
  gap: var(--space-3);
}

.shortcut-item {
  display: flex;
  align-items: center;
  justify-content: space-between;
  gap: var(--space-4);
}

.shortcut-keys {
  display: flex;
  align-items: center;
  gap: var(--space-1);
}

.shortcut-desc {
  font-size: var(--text-sm);
  color: var(--c-text-2);
}

/* ================================================================
   20. SIDEBAR OVERLAY (Mobile)
   ================================================================ */
.sidebar-overlay {
  position: fixed;
  inset: 0;
  background: var(--c-bg-overlay);
  z-index: 800;
  opacity: 0;
  pointer-events: none;
  transition: opacity var(--t-base);
  backdrop-filter: blur(2px);
  -webkit-backdrop-filter: blur(2px);
}
body.sidebar-open .sidebar-overlay {
  opacity: 1;
  pointer-events: all;
}

/* ================================================================
   21. RESPONSIVE — Mobile & Tablet
   ================================================================ */
@media (max-width: 1023px) {
  .page-layout { padding: 0 var(--space-4); }
}

@media (max-width: 820px) {
  .page-layout { display: block; padding: 0 var(--space-4); }

  #sidebar {
    position: fixed;
    top: 0;
    left: 0;
    bottom: 0;
    width: var(--sidebar-w);
    background: var(--c-bg-sidebar);
    border-right: 1px solid var(--c-border);
    z-index: 900;
    padding: var(--space-16) 0 var(--space-8);
    transform: translateX(-100%);
    transition: transform var(--t-slow), background-color var(--t-slow);
    overflow-y: auto;
    max-height: 100vh;
  }

  body.sidebar-open #sidebar {
    transform: translateX(0);
    box-shadow: var(--shadow-xl);
  }

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

  #main-content { padding-top: var(--space-6); }

  .hero-meta-grid { grid-template-columns: 1fr 1fr; }
}

@media (max-width: 560px) {
  .header-inner { padding: 0 var(--space-4); }
  .brand-page { display: none; }
  .brand-sep { display: none; }

  .theme-toggle { width: 52px; height: 26px; }
  .theme-toggle-knob { width: 20px; height: 20px; top: 3px; }
  [data-theme="dark"] .theme-toggle-knob { transform: translateX(26px); }

  .hero-section { padding: var(--space-6) 0 var(--space-4); }
  .hero-meta-grid { grid-template-columns: 1fr 1fr; gap: var(--space-2); }
  .meta-card { padding: var(--space-3); }
  .step-card-header { padding: var(--space-4); }
  .step-card-body { padding: var(--space-4); }
  .step-title { font-size: var(--text-lg); }
  .requirements-grid { grid-template-columns: 1fr; }

  .install-steps::before { display: none; }
  .install-step { padding-left: 0; }
  .install-step-header { margin-left: 0; }

  .footer-inner { flex-direction: column; align-items: flex-start; gap: var(--space-3); }
  .footer-meta { flex-direction: column; align-items: flex-start; gap: var(--space-1); }
  .footer-sep { display: none; }

  #back-to-top { bottom: var(--space-4); right: var(--space-4); }
}

/* ================================================================
   22. PRINT STYLES
   ================================================================ */
@media print {
  #progress-bar, #site-header, #sidebar, .sidebar-overlay,
  #back-to-top, #toast-container, .shortcuts-modal,
  .collapse-btn, .copy-btn, .copy-all-btn,
  .checklist-actions, .footer-actions, #print-btn {
    display: none !important;
  }

  body { font-size: 11pt; color: #000; background: #fff; }

  .page-layout { display: block; max-width: 100%; padding: 0; }

  #main-content { padding: 0; max-width: 100%; }

  .doc-section {
    opacity: 1 !important;
    transform: none !important;
    break-inside: avoid;
    margin-bottom: 2em;
  }

  .step-card { break-inside: avoid; border: 1px solid #ccc; box-shadow: none; }
  .step-card-header { background: #f5f5f5; }

  .code-block { background: #f5f5f5; border: 1px solid #ccc; box-shadow: none; break-inside: avoid; }
  .code-block-header { background: #e8e8e8; border-bottom: 1px solid #ccc; }
  .code-block-body pre { color: #000; }
  .code-lang-badge { color: #333; }

  .alert { break-inside: avoid; }

  a[href]::after { content: " (" attr(href) ")"; font-size: 0.8em; color: #666; }
  a.nav-brand::after, a.toc-link::after { content: none; }

  #site-footer .footer-inner {
    padding: var(--space-4) 0;
    font-size: 9pt;
    color: #666;
    border-top: 1px solid #ccc;
    justify-content: center;
  }
}

/* ================================================================
   23. FOCUS MANAGEMENT & ACCESSIBILITY
   ================================================================ */
:focus { outline: none; }
:focus-visible {
  outline: 2px solid var(--c-accent);
  outline-offset: 2px;
  border-radius: var(--r-xs);
}

.skip-link {
  position: fixed;
  top: -100%;
  left: var(--space-4);
  background: var(--c-accent);
  color: #fff;
  padding: var(--space-3) var(--space-4);
  border-radius: var(--r-sm);
  font-weight: 600;
  z-index: 99999;
  transition: top 0.1s;
}
.skip-link:focus { top: var(--space-4); }

/* ================================================================
   24. SELECTION COLOR
   ================================================================ */
::selection {
  background: rgba(var(--c-accent-rgb), 0.25);
  color: var(--c-text);
}

/* ================================================================
   25. BREADCRUMB — For documentation pages
   ================================================================ */
.breadcrumb {
  display: flex;
  align-items: center;
  gap: var(--space-2);
  font-size: var(--text-xs);
  color: var(--c-text-muted);
  padding: var(--space-3) var(--space-3);
  margin-bottom: var(--space-2);
  flex-wrap: wrap;
}

.breadcrumb-item {
  display: flex;
  align-items: center;
  gap: var(--space-2);
}

.breadcrumb-link {
  color: var(--c-text-muted);
  font-weight: 500;
  font-size: var(--text-xs);
  text-decoration: none;
  transition: color var(--t-base);
}
.breadcrumb-link:hover {
  color: var(--c-accent);
  text-decoration: none;
}

.breadcrumb-sep {
  color: var(--c-border);
  font-size: 0.7rem;
}

.breadcrumb-current {
  color: var(--c-text-muted);
  font-weight: 500;
  font-size: var(--text-xs);
}

/* ================================================================
   26. GLOBAL MOTION REDUCTION & ACCESSIBILITY (prefers-reduced-motion)
   ================================================================ */
@media (prefers-reduced-motion: reduce) {
  *, ::before, ::after {
    animation-duration: 0.01ms !important;
    animation-iteration-count: 1 !important;
    transition-duration: 0.01ms !important;
    scroll-behavior: auto !important;
  }
  .doc-section, .step-card, .cat-card, .article-card, .meta-card, .req-item, .alert {
    opacity: 1 !important;
    transform: none !important;
  }
  .hero-orb {
    animation: none !important;
  }
}