/* MobileVibe Docs - docs.css
   Layers on top of ../styles.css for documentation-specific layout and components.
   All design tokens (colors, spacing, fonts) inherited from the shared stylesheet. */

/* ========================================
   Docs Layout (Sidebar + Content)
   ======================================== */
.docs-layout {
  display: flex;
  min-height: calc(100vh - 200px);
  max-width: 1200px;
  margin: 0 auto;
  padding: 0 var(--space-lg);
}

/* ========================================
   Sidebar Navigation
   ======================================== */
.docs-sidebar {
  width: 240px;
  flex-shrink: 0;
  padding: var(--space-xl) var(--space-lg) var(--space-xl) 0;
  border-right: 1px solid var(--border-subtle);
  position: sticky;
  top: 60px;
  height: fit-content;
  max-height: calc(100vh - 80px);
  overflow-y: auto;
}

.docs-sidebar-toggle {
  display: none;
}

.docs-sidebar-nav {
  display: flex;
  flex-direction: column;
  gap: var(--space-xs);
}

.docs-sidebar-nav a {
  display: block;
  padding: var(--space-sm) var(--space-md);
  color: var(--text-secondary);
  text-decoration: none;
  border-radius: 6px;
  font-size: 0.9375rem;
  transition: background var(--transition-fast), color var(--transition-fast);
}

.docs-sidebar-nav a:hover {
  background: var(--accent-teal-hover);
  color: var(--text-primary);
}

.docs-sidebar-nav a.active {
  background: var(--accent-teal-bg);
  color: var(--accent-teal);
  font-weight: 600;
}

.docs-sidebar-nav .docs-nav-section {
  padding: var(--space-xs) var(--space-md);
  color: var(--text-muted);
  font-size: 0.75rem;
  font-weight: 600;
  text-transform: uppercase;
  letter-spacing: 0.05em;
  margin-top: var(--space-md);
}

.docs-sidebar-nav .docs-nav-section:first-child {
  margin-top: 0;
}

/* ========================================
   Docs Content Area
   ======================================== */
.docs-content {
  flex: 1;
  min-width: 0;
  max-width: 800px;
  padding: var(--space-xl) 0 var(--space-3xl) var(--space-2xl);
}

.docs-content h1 {
  font-size: 2.25rem;
  font-weight: 600;
  color: var(--text-primary);
  margin-bottom: var(--space-md);
  line-height: 1.3;
}

.docs-content h2 {
  font-size: 1.5rem;
  font-weight: 600;
  color: var(--text-primary);
  margin-top: var(--space-2xl);
  margin-bottom: var(--space-md);
  padding-top: var(--space-md);
  border-top: 1px solid var(--border-subtle);
  line-height: 1.3;
}

.docs-content h2:first-of-type {
  border-top: none;
  margin-top: var(--space-xl);
}

.docs-content h3 {
  font-size: 1.125rem;
  font-weight: 600;
  color: var(--text-primary);
  margin-top: var(--space-xl);
  margin-bottom: var(--space-sm);
}

.docs-content p {
  color: var(--text-secondary);
  line-height: 1.7;
  margin-bottom: var(--space-md);
}

.docs-content ul, .docs-content ol {
  color: var(--text-secondary);
  line-height: 1.7;
  margin-bottom: var(--space-md);
  padding-left: var(--space-xl);
}

.docs-content li {
  margin-bottom: var(--space-xs);
}

.docs-content a {
  color: var(--accent-teal);
  text-decoration: none;
}

.docs-content a:hover {
  text-decoration: underline;
}

.docs-intro {
  font-size: 1.125rem;
  color: var(--text-secondary);
  margin-bottom: var(--space-xl);
}

/* ========================================
   Breadcrumb
   ======================================== */
.docs-breadcrumb {
  font-size: 0.875rem;
  color: var(--text-muted);
  margin-bottom: var(--space-lg);
}

.docs-breadcrumb a {
  color: var(--accent-teal);
  text-decoration: none;
}

.docs-breadcrumb a:hover {
  text-decoration: underline;
}

/* ========================================
   Callout Boxes
   ======================================== */
.docs-note,
.docs-warning,
.docs-important {
  border-radius: 6px;
  padding: var(--space-md) var(--space-lg);
  margin-bottom: var(--space-lg);
  font-size: 0.9375rem;
  line-height: 1.6;
}

.docs-note {
  border-left: 3px solid var(--accent-teal);
  background: rgba(78, 201, 176, 0.08);
  color: var(--text-secondary);
}

.docs-warning {
  border-left: 3px solid #f0ad4e;
  background: rgba(240, 173, 78, 0.08);
  color: var(--text-secondary);
}

.docs-important {
  border-left: 3px solid #e06c75;
  background: rgba(224, 108, 117, 0.08);
  color: var(--text-secondary);
}

.docs-note strong,
.docs-warning strong,
.docs-important strong {
  color: var(--text-primary);
}

/* ========================================
   Code Styling
   ======================================== */
.docs-content code {
  background: var(--bg-elevated);
  padding: 0.125rem 0.4rem;
  border-radius: 4px;
  font-family: var(--font-mono);
  font-size: 0.875em;
  color: var(--accent-teal);
}

.docs-content pre {
  background: var(--bg-card);
  border: 1px solid var(--border-subtle);
  border-radius: 8px;
  padding: var(--space-lg);
  overflow-x: auto;
  font-family: var(--font-mono);
  font-size: 0.875rem;
  line-height: 1.6;
  margin-bottom: var(--space-lg);
}

.docs-content pre code {
  background: none;
  padding: 0;
  color: var(--text-secondary);
}

/* ========================================
   Screenshots
   ======================================== */
.docs-screenshot {
  margin: var(--space-lg) 0;
  border: 1px solid var(--border-subtle);
  border-radius: 8px;
  overflow: hidden;
  background: var(--bg-darkest);
}

.docs-screenshot img {
  display: block;
  width: 100%;
  height: auto;
}

.docs-screenshot-caption {
  padding: var(--space-sm) var(--space-md);
  font-size: 0.8125rem;
  color: var(--text-muted);
  background: var(--bg-card);
  border-top: 1px solid var(--border-subtle);
  margin: 0;
}

/* Constrained width for desktop screenshots */
.docs-screenshot-desktop {
  max-width: 680px;
}

/* Small screenshot (tray icons, small UI elements) */
.docs-screenshot-small {
  max-width: 440px;
}

/* Phone mockup for mobile screenshots */
.docs-screenshot-phone {
  max-width: 280px;
  margin: var(--space-lg) auto;
  border-radius: 24px;
  border: 3px solid var(--border-subtle);
  overflow: hidden;
  background: var(--bg-darkest);
}

.docs-screenshot-phone img {
  display: block;
  width: 100%;
  height: auto;
}

/* Side-by-side desktop + mobile */
.docs-screenshot-pair {
  display: flex;
  flex-direction: column;
  align-items: center;
  gap: var(--space-lg);
  margin: var(--space-lg) 0;
}

.docs-screenshot-pair .docs-screenshot {
  margin: 0;
  flex: 1;
}

.docs-screenshot-pair .docs-screenshot-phone {
  margin: 0;
}

.docs-screenshot-pair-caption {
  font-size: 0.8125rem;
  color: var(--text-muted);
  text-align: center;
  margin-top: var(--space-sm);
}

/* ========================================
   Step Indicator
   ======================================== */
.docs-step {
  position: relative;
  padding-left: 3rem;
  margin-bottom: var(--space-2xl);
}

.docs-step::before {
  content: '';
  position: absolute;
  left: 15px;
  top: 2rem;
  bottom: -1.5rem;
  width: 2px;
  background: var(--border-subtle);
}

.docs-step:last-of-type::before {
  display: none;
}

.docs-step-number {
  position: absolute;
  left: 0;
  top: 0;
  width: 32px;
  height: 32px;
  border-radius: 50%;
  background: var(--accent-teal);
  color: #1a1a2e;
  font-weight: 700;
  font-size: 0.875rem;
  display: flex;
  align-items: center;
  justify-content: center;
}

.docs-step h3 {
  margin-top: 0;
  margin-bottom: var(--space-sm);
  padding-top: var(--space-xs);
}

/* ========================================
   Hub Page (docs/index.html)
   ======================================== */
.docs-hub {
  max-width: 900px;
  margin: 0 auto;
  padding: var(--space-2xl) var(--space-lg) var(--space-3xl);
}

.docs-hub h1 {
  font-size: 2.5rem;
  font-weight: 600;
  color: var(--text-primary);
  margin-bottom: var(--space-md);
}

.docs-hub > p {
  font-size: 1.125rem;
  color: var(--text-secondary);
  margin-bottom: var(--space-2xl);
  line-height: 1.6;
}

.docs-hub-grid {
  display: grid;
  grid-template-columns: 1fr;
  gap: var(--space-lg);
  margin-bottom: var(--space-2xl);
}

.docs-hub-card {
  background: var(--bg-card);
  border: 1px solid var(--border-subtle);
  border-radius: 8px;
  padding: var(--space-xl);
  text-decoration: none;
  transition: border-color var(--transition-base), transform var(--transition-base);
  display: block;
}

.docs-hub-card:hover {
  border-color: var(--accent-teal);
  transform: translateY(-2px);
  text-decoration: none;
}

.docs-hub-card h3 {
  color: var(--text-primary);
  font-size: 1.125rem;
  margin-bottom: var(--space-sm);
}

.docs-hub-card p {
  color: var(--text-secondary);
  font-size: 0.9375rem;
  line-height: 1.6;
  margin-bottom: var(--space-sm);
}

.docs-hub-card .docs-card-link {
  color: var(--accent-teal);
  font-size: 0.875rem;
  font-weight: 600;
}

.docs-hub-requirements {
  background: var(--bg-card);
  border: 1px solid var(--border-subtle);
  border-radius: 8px;
  padding: var(--space-xl);
}

.docs-hub-requirements h2 {
  font-size: 1.25rem;
  color: var(--text-primary);
  margin-bottom: var(--space-md);
}

.docs-hub-requirements ul {
  list-style: none;
  padding: 0;
}

.docs-hub-requirements li {
  color: var(--text-secondary);
  padding: var(--space-xs) 0;
  padding-left: var(--space-lg);
  position: relative;
}

.docs-hub-requirements li::before {
  content: '\2713';
  color: var(--accent-teal);
  position: absolute;
  left: 0;
  font-weight: 700;
}

/* ========================================
   Next Steps / Navigation Links
   ======================================== */
.docs-next-steps {
  margin-top: var(--space-2xl);
  padding-top: var(--space-xl);
  border-top: 1px solid var(--border-subtle);
}

.docs-next-steps h2 {
  border-top: none;
  margin-top: 0;
  padding-top: 0;
}

.docs-next-steps ul {
  list-style: none;
  padding: 0;
}

.docs-next-steps li {
  margin-bottom: var(--space-sm);
}

.docs-next-steps a {
  color: var(--accent-teal);
  text-decoration: none;
  font-weight: 500;
}

.docs-next-steps a:hover {
  text-decoration: underline;
}

.docs-next-steps a::after {
  content: ' \2192';
}

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

/* Mobile: sidebar becomes collapsible top bar */
@media (max-width: 767px) {
  .docs-layout {
    flex-direction: column;
    padding: 0 var(--space-md);
  }

  .docs-sidebar {
    width: 100%;
    position: relative;
    top: 0;
    max-height: none;
    border-right: none;
    border-bottom: 1px solid var(--border-subtle);
    padding: var(--space-md) 0;
  }

  .docs-sidebar-toggle {
    display: flex;
    align-items: center;
    justify-content: space-between;
    width: 100%;
    background: var(--bg-card);
    border: 1px solid var(--border-subtle);
    border-radius: 6px;
    padding: var(--space-sm) var(--space-md);
    color: var(--text-primary);
    font-size: 0.9375rem;
    font-weight: 600;
    cursor: pointer;
    font-family: inherit;
  }

  .docs-sidebar-toggle::after {
    content: '\25BC';
    font-size: 0.625rem;
    color: var(--text-muted);
    transition: transform var(--transition-fast);
  }

  .docs-sidebar-toggle.active::after {
    transform: rotate(180deg);
  }

  .docs-sidebar-nav {
    display: none;
    padding-top: var(--space-sm);
  }

  .docs-sidebar-nav.active {
    display: flex;
  }

  .docs-content {
    padding: var(--space-lg) 0 var(--space-2xl);
  }

  .docs-content h1 {
    font-size: 1.75rem;
  }

  .docs-content h2 {
    font-size: 1.25rem;
  }

  .docs-hub h1 {
    font-size: 1.75rem;
  }

  .docs-step {
    padding-left: 2.5rem;
  }

  .docs-screenshot-desktop {
    max-width: 100%;
  }

  .docs-screenshot-small {
    max-width: 100%;
  }

  .docs-screenshot-phone {
    max-width: 240px;
  }
}

/* Tablet and up: two-column hub grid, side-by-side screenshots */
@media (min-width: 640px) {
  .docs-hub-grid {
    grid-template-columns: 1fr 1fr;
  }

  .docs-screenshot-pair {
    flex-direction: row;
    align-items: flex-start;
  }
}

/* Desktop: sidebar visible */
@media (min-width: 768px) {
  .docs-sidebar-toggle {
    display: none;
  }

  .docs-sidebar-nav {
    display: flex;
  }
}