/**
 * Documentation Styles
 * Vail ReRBN API Documentation
 */

/* ============================================================================
   CSS Variables
   ========================================================================= */
:root {
  --docs-nav-width: 250px;
  --docs-toc-width: 200px;
  --docs-gap: 2rem;
  --docs-code-bg: #f6f8fa;
  --docs-code-border: #e1e4e8;
  --docs-primary: #2563eb;
  --docs-primary-hover: #1d4ed8;
  --docs-success: #059669;
  --docs-warning: #d97706;
  --docs-error: #dc2626;

  /* Mode badges */
  --mode-cw: #0891b2;
  --mode-ft8: #7c3aed;
  --mode-ft4: #c026d3;
  --mode-rtty: #ea580c;
}

@media (prefers-color-scheme: dark) {
  :root {
    --docs-code-bg: #1f2937;
    --docs-code-border: #374151;
  }
}

/* ============================================================================
   Layout Structure
   ========================================================================= */

/* Documentation wrapper (nav | content | toc) */
.docs-wrapper {
  display: grid;
  grid-template-columns: var(--docs-nav-width) 1fr;
  gap: var(--docs-gap);
  max-width: 1600px;
  margin: 0 auto;
  padding: 2rem 1rem;
}

/* Desktop: Show all 3 columns */
@media (min-width: 1200px) {
  .docs-wrapper {
    grid-template-columns: var(--docs-nav-width) 1fr var(--docs-toc-width);
  }
}

/* Tablet: 2 columns (nav + content) */
@media (min-width: 768px) and (max-width: 1199px) {
  .docs-wrapper {
    grid-template-columns: var(--docs-nav-width) 1fr;
  }

  .toc-sidebar {
    display: none;
  }
}

/* Mobile: Content first, sidebar nav hidden */
@media (max-width: 767px) {
  .docs-wrapper {
    display: block;
    padding: 0;
  }

  /* Hide the docs sidebar nav on mobile (not header nav) */
  .docs-nav {
    display: none;
  }

  /* Hide close button */
  .docs-nav-close {
    display: none;
  }

  .toc-sidebar {
    display: none;
  }
}

/* ============================================================================
   Navigation Sidebar
   ========================================================================= */
.docs-nav {
  position: sticky;
  top: 2rem;
  align-self: start;
  max-height: calc(100vh - 4rem);
  overflow-y: auto;
}

.docs-nav h4 {
  font-size: 0.75rem;
  font-weight: 600;
  text-transform: uppercase;
  letter-spacing: 0.05em;
  color: var(--color-text-secondary);
  margin: 1.5rem 0 0.5rem 0;
}

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

.docs-nav a {
  display: block;
  padding: 0.5rem 0.75rem;
  color: var(--color-text);
  text-decoration: none;
  border-radius: 4px;
  font-size: 0.875rem;
  transition: all 0.15s ease;
}

.docs-nav a:hover {
  background: var(--color-bg-secondary);
  color: var(--docs-primary);
}

.docs-nav a.active {
  background: var(--docs-primary);
  color: white;
  font-weight: 500;
}

/* Nested nav items (sub-items) */
.docs-nav .nav-sub {
  margin-left: 1rem;
  border-left: 2px solid var(--docs-code-border);
  padding-left: 0.5rem;
}

.docs-nav .nav-sub a {
  font-size: 0.8125rem;
  padding: 0.375rem 0.5rem;
}

/* ============================================================================
   Table of Contents Sidebar
   ========================================================================= */
.toc-sidebar {
  position: sticky;
  top: 2rem;
  align-self: start;
  max-height: calc(100vh - 4rem);
  overflow-y: auto;
}

.toc-sidebar h4 {
  font-size: 0.75rem;
  font-weight: 600;
  text-transform: uppercase;
  letter-spacing: 0.05em;
  color: var(--color-text-secondary);
  margin: 0 0 0.5rem 0;
}

.toc-sidebar nav {
  font-size: 0.8125rem;
}

.toc-sidebar a {
  display: block;
  padding: 0.25rem 0;
  color: var(--color-text-secondary);
  text-decoration: none;
  transition: color 0.15s ease;
  border-left: 2px solid transparent;
  padding-left: 0.75rem;
  margin-left: -0.75rem;
}

.toc-sidebar a:hover {
  color: var(--color-text);
}

.toc-sidebar a.active {
  color: var(--docs-primary);
  border-left-color: var(--docs-primary);
  font-weight: 500;
}

/* Nested TOC items (H3s) */
.toc-sidebar .toc-h3 {
  margin-left: 1rem;
  font-size: 0.75rem;
}

/* ============================================================================
   Main Content Area
   ========================================================================= */
.docs-main {
  min-width: 0; /* Allow grid item to shrink below content size */
  max-width: 800px;
}

.docs-main h1 {
  font-size: 2.5rem;
  margin: 0 0 1rem 0;
  color: var(--color-text);
}

.docs-main h2 {
  font-size: 1.75rem;
  margin: 3rem 0 1rem 0;
  padding-bottom: 0.5rem;
  border-bottom: 2px solid var(--docs-code-border);
  color: var(--color-text);
}

.docs-main h2:first-of-type {
  margin-top: 1rem;
}

.docs-main h3 {
  font-size: 1.25rem;
  margin: 2rem 0 1rem 0;
  color: var(--color-text);
}

.docs-main h4 {
  font-size: 1rem;
  margin: 1.5rem 0 0.75rem 0;
  color: var(--color-text);
  font-weight: 600;
}

.docs-main p {
  line-height: 1.7;
  margin: 0 0 1rem 0;
}

.docs-main ul, .docs-main ol {
  line-height: 1.7;
  margin: 0 0 1rem 0;
  padding-left: 1.5rem;
}

.docs-main li {
  margin: 0.5rem 0;
}

/* ============================================================================
   Breadcrumbs
   ========================================================================= */
.breadcrumbs {
  margin-bottom: 1.5rem;
  font-size: 0.875rem;
}

.breadcrumbs ol {
  display: flex;
  list-style: none;
  padding: 0;
  margin: 0;
  flex-wrap: wrap;
}

.breadcrumbs li {
  margin: 0;
}

.breadcrumbs li + li::before {
  content: "›";
  padding: 0 0.5rem;
  color: var(--color-text-secondary);
}

.breadcrumbs a {
  color: var(--docs-primary);
  text-decoration: none;
}

.breadcrumbs a:hover {
  text-decoration: underline;
}

.breadcrumbs li[aria-current="page"] {
  color: var(--color-text-secondary);
}

/* ============================================================================
   Code Examples Component
   ========================================================================= */

.code-examples-container {
  margin: 1.5rem 0;
  border: 1px solid var(--docs-code-border);
  border-radius: 8px;
  overflow: hidden;
}

/* Language selector tabs */
.language-selector {
  display: flex;
  background: var(--docs-code-bg);
  border-bottom: 1px solid var(--docs-code-border);
  overflow-x: auto;
}

.lang-tab {
  background: transparent;
  border: none;
  padding: 0.75rem 1.25rem;
  font-size: 0.875rem;
  font-weight: 500;
  color: var(--color-text-secondary);
  cursor: pointer;
  border-bottom: 2px solid transparent;
  transition: all 0.15s ease;
  white-space: nowrap;
}

.lang-tab:hover {
  color: var(--color-text);
  background: rgba(0, 0, 0, 0.03);
}

.lang-tab.active {
  color: var(--docs-primary);
  border-bottom-color: var(--docs-primary);
}

.lang-tab:focus {
  outline: 2px solid var(--docs-primary);
  outline-offset: -2px;
}

/* Code pane */
.code-pane {
  display: none;
}

.code-pane.active {
  display: block;
}

.code-header {
  display: flex;
  justify-content: space-between;
  align-items: center;
  padding: 0.75rem 1rem;
  background: var(--docs-code-bg);
  border-bottom: 1px solid var(--docs-code-border);
}

.example-title {
  font-size: 0.875rem;
  font-weight: 500;
  color: var(--color-text);
}

.copy-btn {
  background: transparent;
  border: 1px solid var(--docs-code-border);
  border-radius: 4px;
  padding: 0.25rem 0.75rem;
  font-size: 0.75rem;
  color: var(--color-text-secondary);
  cursor: pointer;
  transition: all 0.15s ease;
  display: flex;
  align-items: center;
  gap: 0.25rem;
}

.copy-btn:hover {
  background: var(--color-bg-secondary);
  color: var(--color-text);
  border-color: var(--color-text-secondary);
}

.copy-btn:active {
  transform: scale(0.95);
}

.copy-btn.copied {
  background: var(--docs-success);
  color: white;
  border-color: var(--docs-success);
}

.code-pane pre {
  margin: 0;
  padding: 1rem;
  overflow-x: auto;
  background: white;
}

@media (prefers-color-scheme: dark) {
  .code-pane pre {
    background: #0d1117;
  }
}

.code-pane code {
  font-family: 'Consolas', 'Monaco', 'Courier New', monospace;
  font-size: 0.875rem;
  line-height: 1.6;
  color: var(--color-text);
}

/* ============================================================================
   Timestamp Helper Component
   ========================================================================= */
.timestamp-helper {
  margin: 1.5rem 0;
  border: 1px solid var(--docs-code-border);
  border-radius: 8px;
  overflow: hidden;
}

.timestamp-tabs {
  display: flex;
  background: var(--docs-code-bg);
  border-bottom: 1px solid var(--docs-code-border);
}

.timestamp-tabs .tab {
  flex: 1;
  background: transparent;
  border: none;
  padding: 0.75rem 1rem;
  font-size: 0.875rem;
  font-weight: 500;
  color: var(--color-text-secondary);
  cursor: pointer;
  border-bottom: 2px solid transparent;
  transition: all 0.15s ease;
}

.timestamp-tabs .tab.active {
  color: var(--docs-primary);
  border-bottom-color: var(--docs-primary);
  background: white;
}

@media (prefers-color-scheme: dark) {
  .timestamp-tabs .tab.active {
    background: #0d1117;
  }
}

.timestamp-content {
  padding: 1.5rem;
  background: white;
}

@media (prefers-color-scheme: dark) {
  .timestamp-content {
    background: #0d1117;
  }
}

.timestamp-content.hidden {
  display: none;
}

.format-desc {
  font-size: 0.875rem;
  color: var(--color-text-secondary);
  margin: 0 0 1rem 0;
}

.code-example {
  background: var(--docs-code-bg);
  padding: 1rem;
  border-radius: 4px;
  margin: 0 0 1.5rem 0;
}

.code-example code {
  font-family: 'Consolas', 'Monaco', 'Courier New', monospace;
  font-size: 1.125rem;
  color: var(--docs-primary);
  font-weight: 600;
}

.how-to-get h4 {
  font-size: 0.875rem;
  margin: 0 0 1rem 0;
  color: var(--color-text);
}

.lang-examples {
  display: grid;
  gap: 1rem;
}

.lang-example {
  border: 1px solid var(--docs-code-border);
  border-radius: 4px;
  overflow: hidden;
}

.lang-header {
  display: flex;
  justify-content: space-between;
  align-items: center;
  padding: 0.5rem 0.75rem;
  background: var(--docs-code-bg);
  border-bottom: 1px solid var(--docs-code-border);
}

.lang-name {
  font-size: 0.75rem;
  font-weight: 600;
  color: var(--color-text);
  text-transform: uppercase;
  letter-spacing: 0.05em;
}

.lang-example pre {
  margin: 0;
  padding: 0.75rem;
  background: white;
  overflow-x: auto;
}

@media (prefers-color-scheme: dark) {
  .lang-example pre {
    background: #0d1117;
  }
}

.lang-example code {
  font-family: 'Consolas', 'Monaco', 'Courier New', monospace;
  font-size: 0.8125rem;
  line-height: 1.5;
}

/* ============================================================================
   Playground Styles
   ========================================================================= */
.playground-container {
  max-width: 1400px;
}

.playground-split {
  display: grid;
  grid-template-columns: 1fr 1fr;
  gap: 2rem;
  margin: 2rem 0;
}

@media (max-width: 1023px) {
  .playground-split {
    grid-template-columns: 1fr;
  }
}

.query-builder {
  background: var(--color-bg-secondary);
  padding: 1.5rem;
  border-radius: 8px;
  border: 1px solid var(--docs-code-border);
}

.query-builder h2 {
  font-size: 1.5rem;
  margin: 0 0 1.5rem 0;
  border: none;
  padding: 0;
}

.query-builder h3 {
  font-size: 1rem;
  margin: 1.5rem 0 1rem 0;
  color: var(--color-text-secondary);
  text-transform: uppercase;
  letter-spacing: 0.05em;
  font-weight: 600;
  font-size: 0.875rem;
}

.form-section {
  margin-bottom: 1.5rem;
}

.form-group {
  margin-bottom: 1rem;
}

.form-group label {
  display: block;
  font-size: 0.875rem;
  font-weight: 500;
  margin-bottom: 0.5rem;
  color: var(--color-text);
}

.field-help {
  display: inline-block;
  width: 16px;
  height: 16px;
  line-height: 16px;
  text-align: center;
  background: var(--color-text-secondary);
  color: white;
  border-radius: 50%;
  font-size: 0.75rem;
  cursor: help;
  margin-left: 0.25rem;
}

.form-group input[type="text"],
.form-group input[type="number"],
.form-group select {
  width: 100%;
  padding: 0.5rem 0.75rem;
  border: 1px solid var(--docs-code-border);
  border-radius: 4px;
  font-size: 0.875rem;
  background: white;
  color: var(--color-text);
}

@media (prefers-color-scheme: dark) {
  .form-group input[type="text"],
  .form-group input[type="number"],
  .form-group select {
    background: #1f2937;
  }
}

.form-group input:focus,
.form-group select:focus {
  outline: 2px solid var(--docs-primary);
  outline-offset: 0;
}

.form-group small {
  display: block;
  font-size: 0.75rem;
  color: var(--color-text-secondary);
  margin-top: 0.25rem;
}

.checkbox-group {
  display: grid;
  grid-template-columns: repeat(auto-fill, minmax(100px, 1fr));
  gap: 0.5rem;
}

.checkbox {
  display: flex;
  align-items: center;
  font-size: 0.875rem;
  cursor: pointer;
  user-select: none;
}

.checkbox input[type="checkbox"] {
  margin-right: 0.5rem;
  cursor: pointer;
}

.btn-primary {
  background: var(--docs-primary);
  color: white;
  border: none;
  padding: 0.75rem 1.5rem;
  border-radius: 4px;
  font-size: 1rem;
  font-weight: 500;
  cursor: pointer;
  transition: background 0.15s ease;
  width: 100%;
}

.btn-primary:hover {
  background: var(--docs-primary-hover);
}

.btn-primary:active {
  transform: scale(0.98);
}

.btn-large {
  padding: 1rem 1.5rem;
  font-size: 1.125rem;
}

.generated-url {
  margin-top: 2rem;
  padding-top: 2rem;
  border-top: 1px solid var(--docs-code-border);
}

.generated-url h4 {
  font-size: 0.875rem;
  margin: 0 0 0.75rem 0;
  color: var(--color-text);
}

.url-display {
  display: flex;
  gap: 0.5rem;
  align-items: start;
}

.url-display code {
  flex: 1;
  padding: 0.75rem;
  background: white;
  border: 1px solid var(--docs-code-border);
  border-radius: 4px;
  font-family: 'Consolas', 'Monaco', 'Courier New', monospace;
  font-size: 0.75rem;
  word-break: break-all;
  line-height: 1.5;
}

@media (prefers-color-scheme: dark) {
  .url-display code {
    background: #1f2937;
  }
}

.results-pane {
  background: var(--color-bg-secondary);
  border-radius: 8px;
  border: 1px solid var(--docs-code-border);
  overflow: hidden;
  display: flex;
  flex-direction: column;
}

.results-header {
  display: flex;
  justify-content: space-between;
  align-items: center;
  padding: 1rem 1.5rem;
  border-bottom: 1px solid var(--docs-code-border);
  background: var(--docs-code-bg);
}

.results-header h2 {
  font-size: 1.5rem;
  margin: 0;
  border: none;
  padding: 0;
}

.format-toggle {
  display: flex;
  gap: 0.5rem;
}

.format-toggle button {
  background: transparent;
  border: 1px solid var(--docs-code-border);
  padding: 0.375rem 0.75rem;
  font-size: 0.75rem;
  border-radius: 4px;
  cursor: pointer;
  color: var(--color-text-secondary);
  transition: all 0.15s ease;
}

.format-toggle button.active {
  background: var(--docs-primary);
  color: white;
  border-color: var(--docs-primary);
}

.results-content {
  flex: 1;
  padding: 1.5rem;
  background: white;
  overflow-y: auto;
  max-height: 600px;
}

@media (prefers-color-scheme: dark) {
  .results-content {
    background: #0d1117;
  }
}

.empty-state {
  text-align: center;
  padding: 3rem 1.5rem;
  color: var(--color-text-secondary);
}

.empty-state svg {
  width: 64px;
  height: 64px;
  margin-bottom: 1rem;
  opacity: 0.5;
}

.htmx-indicator {
  display: none;
  text-align: center;
  padding: 2rem;
}

.htmx-indicator.htmx-request {
  display: block;
}

.spinner {
  width: 40px;
  height: 40px;
  border: 4px solid var(--docs-code-border);
  border-top-color: var(--docs-primary);
  border-radius: 50%;
  animation: spin 0.8s linear infinite;
  margin: 0 auto 1rem;
}

@keyframes spin {
  to { transform: rotate(360deg); }
}

.response-metadata {
  display: flex;
  gap: 1.5rem;
  margin-bottom: 1.5rem;
  flex-wrap: wrap;
}

.meta-item {
  font-size: 0.875rem;
  color: var(--color-text-secondary);
}

.meta-item::before {
  content: "• ";
}

.meta-item:first-child::before {
  content: "";
}

.response-table {
  overflow-x: auto;
}

.response-table table {
  width: 100%;
  border-collapse: collapse;
  font-size: 0.875rem;
}

.response-table th {
  text-align: left;
  padding: 0.75rem;
  background: var(--docs-code-bg);
  font-weight: 600;
  color: var(--color-text);
  border-bottom: 2px solid var(--docs-code-border);
}

.response-table td {
  padding: 0.75rem;
  border-bottom: 1px solid var(--docs-code-border);
}

.response-table tr:last-child td {
  border-bottom: none;
}

.mode-badge {
  display: inline-block;
  padding: 0.25rem 0.5rem;
  border-radius: 4px;
  font-size: 0.75rem;
  font-weight: 600;
  color: white;
}

.mode-badge.mode-cw { background: var(--mode-cw); }
.mode-badge.mode-ft8 { background: var(--mode-ft8); }
.mode-badge.mode-ft4 { background: var(--mode-ft4); }
.mode-badge.mode-rtty { background: var(--mode-rtty); }

.raw-json {
  margin-top: 1.5rem;
  border: 1px solid var(--docs-code-border);
  border-radius: 4px;
}

.raw-json summary {
  padding: 0.75rem 1rem;
  background: var(--docs-code-bg);
  cursor: pointer;
  font-size: 0.875rem;
  font-weight: 500;
  user-select: none;
}

.raw-json summary:hover {
  background: var(--color-bg-secondary);
}

.raw-json pre {
  margin: 0;
  padding: 1rem;
  overflow-x: auto;
}

/* ============================================================================
   Pagination Visual Diagrams
   ========================================================================= */
.pagination-comparison {
  display: grid;
  grid-template-columns: 1fr 1fr;
  gap: 2rem;
  margin: 2rem 0;
}

@media (max-width: 1023px) {
  .pagination-comparison {
    grid-template-columns: 1fr;
  }
}

.pagination-method {
  border: 1px solid var(--docs-code-border);
  border-radius: 8px;
  padding: 1.5rem;
  background: var(--color-bg-secondary);
}

.pagination-method h3 {
  margin-top: 0;
}

.visual-diagram {
  background: white;
  border: 2px solid var(--docs-code-border);
  border-radius: 8px;
  padding: 1.5rem;
  margin: 1.5rem 0;
}

@media (prefers-color-scheme: dark) {
  .visual-diagram {
    background: #0d1117;
  }
}

.database-representation,
.spot-timeline {
  display: flex;
  flex-wrap: wrap;
  gap: 0.5rem;
  margin: 1rem 0;
}

.spot-block {
  display: inline-flex;
  align-items: center;
  justify-content: center;
  min-width: 50px;
  height: 50px;
  background: var(--docs-primary);
  color: white;
  border-radius: 6px;
  font-weight: 600;
  font-size: 0.875rem;
  padding: 0 0.75rem;
}

.spot-block.new {
  background: var(--docs-success);
  animation: pulse 0.6s ease-in-out;
}

@keyframes pulse {
  0%, 100% { transform: scale(1); }
  50% { transform: scale(1.05); }
}

.cursor-marker {
  position: relative;
  width: 4px;
  background: var(--docs-error);
  margin: 0 0.25rem;
  align-self: stretch;
}

.cursor-marker span {
  position: absolute;
  top: -30px;
  left: 50%;
  transform: translateX(-50%);
  white-space: nowrap;
  font-size: 0.75rem;
  color: var(--docs-error);
  font-weight: 600;
  background: white;
  padding: 0.25rem 0.5rem;
  border-radius: 4px;
  border: 1px solid var(--docs-error);
}

@media (prefers-color-scheme: dark) {
  .cursor-marker span {
    background: #0d1117;
  }
}

.request-visualization {
  margin: 1.5rem 0;
}

.request {
  margin: 1rem 0;
  padding: 1rem;
  background: var(--docs-code-bg);
  border-radius: 6px;
  border-left: 4px solid var(--docs-primary);
}

.request-label {
  font-weight: 600;
  margin-bottom: 0.5rem;
  font-size: 0.875rem;
}

.request code {
  display: block;
  margin: 0.5rem 0;
  font-family: 'Consolas', 'Monaco', 'Courier New', monospace;
  font-size: 0.875rem;
}

.returned-spots {
  display: flex;
  gap: 0.5rem;
  margin-top: 0.75rem;
  flex-wrap: wrap;
}

.returned-spots .spot {
  min-width: 40px;
  height: 40px;
  background: var(--docs-primary);
  color: white;
  border-radius: 4px;
  display: inline-flex;
  align-items: center;
  justify-content: center;
  font-size: 0.75rem;
  font-weight: 600;
  padding: 0 0.5rem;
}

.returned-spots .spot.new {
  background: var(--docs-success);
}

.method-pros-cons {
  display: grid;
  grid-template-columns: 1fr 1fr;
  gap: 1rem;
  margin-top: 1.5rem;
}

@media (max-width: 767px) {
  .method-pros-cons {
    grid-template-columns: 1fr;
  }
}

.pros, .cons {
  padding: 1rem;
  border-radius: 6px;
}

.pros {
  background: #dcfce7;
}

.cons {
  background: #fee2e2;
}

@media (prefers-color-scheme: dark) {
  .pros {
    background: #14532d;
  }
  .cons {
    background: #7f1d1d;
  }
}

.pros h4, .cons h4 {
  margin-top: 0;
  font-size: 0.875rem;
}

.pros ul, .cons ul {
  margin: 0;
  padding-left: 1.25rem;
  font-size: 0.875rem;
}

/* ============================================================================
   Glossary Styles
   ========================================================================= */
.search-box {
  margin-bottom: 2rem;
}

.search-box input {
  width: 100%;
  max-width: 500px;
  padding: 0.75rem 1rem;
  border: 2px solid var(--docs-code-border);
  border-radius: 8px;
  font-size: 1rem;
  background: white;
}

@media (prefers-color-scheme: dark) {
  .search-box input {
    background: #1f2937;
  }
}

.search-box input:focus {
  outline: none;
  border-color: var(--docs-primary);
}

.glossary-terms {
  display: grid;
  gap: 1.5rem;
}

.term-group {
  border: 1px solid var(--docs-code-border);
  border-radius: 8px;
  padding: 1.5rem;
  background: var(--color-bg-secondary);
  scroll-margin-top: 2rem;
}

.term-group dt {
  display: flex;
  align-items: center;
  gap: 0.75rem;
  margin-bottom: 0.75rem;
}

.term-name {
  font-size: 1.25rem;
  font-weight: 600;
  color: var(--color-text);
}

.category-badge {
  display: inline-block;
  padding: 0.25rem 0.75rem;
  background: var(--docs-primary);
  color: white;
  font-size: 0.75rem;
  font-weight: 600;
  border-radius: 12px;
  text-transform: uppercase;
  letter-spacing: 0.05em;
}

.term-group dd {
  margin: 0;
  line-height: 1.7;
  color: var(--color-text);
}

.term-group .example {
  margin-top: 0.75rem;
  padding: 0.75rem;
  background: var(--docs-code-bg);
  border-radius: 4px;
  font-size: 0.875rem;
}

.term-group .example code {
  font-family: 'Consolas', 'Monaco', 'Courier New', monospace;
  color: var(--docs-primary);
  font-weight: 600;
}

.external-link {
  display: inline-flex;
  align-items: center;
  gap: 0.25rem;
  color: var(--docs-primary);
  text-decoration: none;
  font-size: 0.875rem;
  margin-top: 0.5rem;
}

.external-link:hover {
  text-decoration: underline;
}

/* ============================================================================
   Guides/Recipes Styles
   ========================================================================= */
.guide-grid {
  display: grid;
  grid-template-columns: repeat(auto-fill, minmax(350px, 1fr));
  gap: 2rem;
  margin: 2rem 0;
}

.guide-card {
  border: 1px solid var(--docs-code-border);
  border-radius: 8px;
  padding: 1.5rem;
  background: var(--color-bg-secondary);
  transition: transform 0.15s ease, box-shadow 0.15s ease;
}

.guide-card:hover {
  transform: translateY(-2px);
  box-shadow: 0 4px 12px rgba(0, 0, 0, 0.1);
}

.guide-card h3 {
  margin-top: 0;
  color: var(--docs-primary);
}

.guide-description {
  color: var(--color-text-secondary);
  font-size: 0.875rem;
  margin-bottom: 1.5rem;
}

.guide-steps {
  margin: 1.5rem 0;
}

.step {
  display: flex;
  gap: 1rem;
  margin: 1.5rem 0;
}

.step-number {
  flex-shrink: 0;
  width: 32px;
  height: 32px;
  background: var(--docs-primary);
  color: white;
  border-radius: 50%;
  display: flex;
  align-items: center;
  justify-content: center;
  font-weight: 600;
  font-size: 0.875rem;
}

.step-content {
  flex: 1;
}

.step-content h4 {
  margin-top: 0;
  font-size: 1rem;
}

.guide-result {
  margin-top: 1.5rem;
  padding-top: 1.5rem;
  border-top: 1px solid var(--docs-code-border);
}

.guide-result h4 {
  font-size: 0.875rem;
  margin-bottom: 0.75rem;
}

/* ============================================================================
   Troubleshooting/Error Catalog Styles
   ========================================================================= */
.error-catalog {
  display: grid;
  gap: 2rem;
  margin: 2rem 0;
}

.error-card {
  border: 1px solid var(--docs-code-border);
  border-radius: 8px;
  overflow: hidden;
  background: var(--color-bg-secondary);
}

.error-header {
  padding: 1rem 1.5rem;
  background: var(--docs-code-bg);
  border-bottom: 1px solid var(--docs-code-border);
}

.error-code {
  display: inline-block;
  padding: 0.25rem 0.75rem;
  background: var(--docs-error);
  color: white;
  font-size: 0.75rem;
  font-weight: 600;
  border-radius: 12px;
  text-transform: uppercase;
  letter-spacing: 0.05em;
  margin-bottom: 0.5rem;
}

.error-header h3 {
  margin: 0;
  font-size: 1.25rem;
}

.error-body {
  padding: 1.5rem;
}

.problem, .causes, .solution {
  margin-bottom: 1.5rem;
}

.problem h4, .causes h4, .solution h4 {
  font-size: 1rem;
  margin: 0 0 0.75rem 0;
}

.solution {
  padding: 1rem;
  background: var(--docs-code-bg);
  border-radius: 6px;
  border-left: 4px solid var(--docs-success);
}

.comparison-table {
  width: 100%;
  border-collapse: collapse;
  margin: 1rem 0;
  font-size: 0.875rem;
}

.comparison-table th {
  background: var(--docs-code-bg);
  padding: 0.75rem;
  text-align: left;
  font-weight: 600;
  border-bottom: 2px solid var(--docs-code-border);
}

.comparison-table td {
  padding: 0.75rem;
  border-bottom: 1px solid var(--docs-code-border);
}

.comparison-table tr:last-child td {
  border-bottom: none;
}

.comparison-table code {
  font-family: 'Consolas', 'Monaco', 'Courier New', monospace;
  background: var(--docs-code-bg);
  padding: 0.125rem 0.375rem;
  border-radius: 3px;
  font-size: 0.8125rem;
}

.still-stuck {
  margin-top: 3rem;
  padding: 2rem;
  background: var(--docs-code-bg);
  border-radius: 8px;
  text-align: center;
}

.still-stuck h3 {
  margin-top: 0;
}

.btn-link {
  display: inline-block;
  color: var(--docs-primary);
  text-decoration: none;
  font-weight: 500;
  padding: 0.5rem 1rem;
  border: 2px solid var(--docs-primary);
  border-radius: 4px;
  transition: all 0.15s ease;
}

.btn-link:hover {
  background: var(--docs-primary);
  color: white;
}

/* ============================================================================
   Utility Classes
   ========================================================================= */
.hidden {
  display: none !important;
}

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

.mt-0 { margin-top: 0 !important; }
.mt-1 { margin-top: 1rem !important; }
.mt-2 { margin-top: 2rem !important; }

.mb-0 { margin-bottom: 0 !important; }
.mb-1 { margin-bottom: 1rem !important; }
.mb-2 { margin-bottom: 2rem !important; }

/* ============================================================================
   Mobile Bottom Navigation
   ========================================================================= */

/* Hidden on desktop */
.mobile-docs-nav {
  display: none;
}

@media (max-width: 767px) {
  .mobile-docs-nav {
    display: block;
    margin-top: 3rem;
    padding-top: 2rem;
    border-top: 2px solid var(--docs-code-border);
  }

  .mobile-docs-nav h4 {
    font-size: 0.75rem;
    font-weight: 600;
    text-transform: uppercase;
    letter-spacing: 0.05em;
    color: var(--color-text-secondary);
    margin: 0 0 1rem 0;
  }

  .mobile-nav-grid {
    display: grid;
    grid-template-columns: 1fr 1fr;
    gap: 0.5rem;
  }

  .mobile-nav-grid a {
    display: block;
    padding: 0.75rem 1rem;
    background: var(--color-bg-secondary);
    border: 1px solid var(--docs-code-border);
    border-radius: 6px;
    color: var(--color-text);
    text-decoration: none;
    font-size: 0.875rem;
    font-weight: 500;
    text-align: center;
    transition: all 0.15s ease;
  }

  .mobile-nav-grid a:hover {
    background: var(--docs-primary);
    color: white;
    border-color: var(--docs-primary);
  }

  .mobile-nav-grid a.active {
    background: var(--docs-primary);
    color: white;
    border-color: var(--docs-primary);
  }
}

/* ============================================================================
   Mobile Responsive Overhaul
   ========================================================================= */

/* Hide close button on desktop */
@media (min-width: 768px) {
  .docs-nav-close {
    display: none;
  }
}

/* Tablet adjustments */
@media (max-width: 1023px) {
  .docs-main {
    max-width: none;
  }

  .docs-main h1 {
    font-size: 2rem;
  }

  .docs-main h2 {
    font-size: 1.5rem;
  }

  /* Guide cards single column earlier */
  .guide-grid {
    grid-template-columns: 1fr;
  }
}

/* Mobile: comprehensive overhaul */
@media (max-width: 767px) {
  /* Prevent horizontal overflow/zoom - but NOT on header */
  .docs-layout {
    overflow-x: hidden;
    max-width: 100vw;
  }

  /* Don't hide overflow on header container - nav dropdown needs to show */
  .docs-layout .header .container {
    overflow: visible;
  }

  /* Only apply overflow hidden to main content container, not header */
  .docs-layout > .container {
    padding: 0;
    max-width: 100%;
    overflow-x: hidden;
  }

  /* Main content full width with padding */
  .docs-main {
    padding: 1rem;
    max-width: 100%;
    overflow-x: hidden;
    box-sizing: border-box;
  }

  /* Typography scaling */
  .docs-main h1 {
    font-size: 1.75rem;
    line-height: 1.2;
    margin-bottom: 0.75rem;
  }

  .docs-main h2 {
    font-size: 1.35rem;
    margin: 2rem 0 0.75rem 0;
  }

  .docs-main h3 {
    font-size: 1.1rem;
    margin: 1.5rem 0 0.75rem 0;
  }

  .docs-main h4 {
    font-size: 1rem;
    margin: 1.25rem 0 0.5rem 0;
  }

  .docs-main p {
    font-size: 0.9375rem;
    line-height: 1.6;
  }

  .docs-main ul, .docs-main ol {
    padding-left: 1.25rem;
  }

  /* Breadcrumbs smaller */
  .breadcrumbs {
    font-size: 0.8rem;
    margin-bottom: 1rem;
    padding: 0 1rem;
  }

  /* Code examples */
  .code-examples-container {
    margin: 1rem -1rem; /* Bleed to edges */
    border-radius: 0;
    border-left: none;
    border-right: none;
  }

  .language-selector {
    padding: 0;
  }

  .lang-tab {
    padding: 0.625rem 0.875rem;
    font-size: 0.8rem;
    min-height: 44px;
  }

  .code-header {
    padding: 0.5rem 0.75rem;
    flex-wrap: wrap;
    gap: 0.5rem;
  }

  .example-title {
    font-size: 0.8rem;
  }

  .copy-btn {
    padding: 0.375rem 0.625rem;
    font-size: 0.7rem;
    min-height: 36px;
  }

  .code-pane pre {
    padding: 0.75rem;
    overflow-x: auto;
    max-width: 100%;
  }

  .code-pane code {
    font-size: 0.75rem;
    line-height: 1.5;
    word-break: break-all;
  }

  /* Ensure all code blocks scroll horizontally */
  pre, code {
    max-width: 100%;
    overflow-x: auto;
  }

  /* Timestamp helper */
  .timestamp-helper {
    margin: 1rem -1rem;
    border-radius: 0;
    border-left: none;
    border-right: none;
  }

  .timestamp-tabs .tab {
    padding: 0.625rem 0.5rem;
    font-size: 0.8rem;
    min-height: 44px;
  }

  .timestamp-content {
    padding: 1rem;
  }

  .code-example code {
    font-size: 0.9375rem;
  }

  .lang-examples {
    gap: 0.75rem;
  }

  .lang-example code {
    font-size: 0.75rem;
  }

  /* Playground mobile */
  .query-builder {
    padding: 1rem;
    margin: 0 -1rem;
    border-radius: 0;
    border-left: none;
    border-right: none;
  }

  .query-builder h2 {
    font-size: 1.25rem;
    margin-bottom: 1rem;
  }

  .query-builder h3 {
    font-size: 0.8rem;
    margin: 1rem 0 0.75rem 0;
  }

  .form-group label {
    font-size: 0.8125rem;
  }

  .form-group input[type="text"],
  .form-group input[type="number"],
  .form-group select {
    font-size: 1rem; /* Prevent iOS zoom */
    padding: 0.625rem 0.75rem;
    min-height: 44px;
  }

  .checkbox-group {
    grid-template-columns: repeat(2, 1fr);
  }

  .checkbox {
    min-height: 44px;
    padding: 0.5rem 0;
  }

  .btn-primary {
    padding: 0.875rem 1rem;
    font-size: 1rem;
    min-height: 48px;
  }

  .generated-url {
    margin-top: 1.5rem;
    padding-top: 1.5rem;
  }

  .url-display {
    flex-direction: column;
  }

  .url-display code {
    font-size: 0.7rem;
    padding: 0.625rem;
  }

  .url-display .copy-btn {
    width: 100%;
    justify-content: center;
    min-height: 44px;
  }

  /* Results pane */
  .results-pane {
    margin: 1rem -1rem 0;
    border-radius: 0;
    border-left: none;
    border-right: none;
  }

  .results-header {
    padding: 0.75rem 1rem;
    flex-wrap: wrap;
    gap: 0.5rem;
  }

  .results-header h2 {
    font-size: 1.25rem;
    width: 100%;
  }

  .format-toggle button {
    min-height: 36px;
    padding: 0.375rem 0.625rem;
  }

  .results-content {
    padding: 1rem;
    max-height: 400px;
  }

  .response-metadata {
    gap: 0.75rem;
    margin-bottom: 1rem;
  }

  .meta-item {
    font-size: 0.8rem;
  }

  .response-table table {
    font-size: 0.75rem;
  }

  .response-table th,
  .response-table td {
    padding: 0.5rem;
  }

  /* Pagination diagrams */
  .pagination-method {
    padding: 1rem;
  }

  .visual-diagram {
    padding: 1rem;
    margin: 1rem -1rem;
    border-radius: 0;
    border-left: none;
    border-right: none;
  }

  .spot-block {
    min-width: 40px;
    height: 40px;
    font-size: 0.75rem;
    padding: 0 0.5rem;
  }

  .request {
    padding: 0.75rem;
  }

  .request code {
    font-size: 0.75rem;
    word-break: break-all;
  }

  .returned-spots .spot {
    min-width: 32px;
    height: 32px;
    font-size: 0.65rem;
  }

  /* Glossary */
  .search-box input {
    font-size: 1rem; /* Prevent iOS zoom */
    padding: 0.75rem;
    min-height: 48px;
  }

  .term-group {
    padding: 1rem;
  }

  .term-group dt {
    flex-wrap: wrap;
    gap: 0.5rem;
  }

  .term-name {
    font-size: 1.1rem;
    width: 100%;
  }

  .category-badge {
    font-size: 0.65rem;
    padding: 0.2rem 0.5rem;
  }

  /* Guide cards */
  .guide-card {
    padding: 1rem;
  }

  .guide-card h3 {
    font-size: 1.1rem;
  }

  .step {
    gap: 0.75rem;
  }

  .step-number {
    width: 28px;
    height: 28px;
    font-size: 0.8rem;
  }

  .step-content h4 {
    font-size: 0.9375rem;
  }

  /* Error cards */
  .error-header {
    padding: 0.75rem 1rem;
  }

  .error-header h3 {
    font-size: 1.1rem;
  }

  .error-body {
    padding: 1rem;
  }

  .solution {
    padding: 0.75rem;
  }

  /* Tables */
  .comparison-table {
    font-size: 0.8rem;
    display: block;
    overflow-x: auto;
    -webkit-overflow-scrolling: touch;
  }

  .comparison-table th,
  .comparison-table td {
    padding: 0.5rem;
    white-space: nowrap;
  }

  /* Still stuck section */
  .still-stuck {
    padding: 1.5rem 1rem;
    margin: 2rem -1rem 0;
    border-radius: 0;
  }

  .btn-link {
    display: block;
    text-align: center;
    min-height: 48px;
    line-height: 32px;
  }

}

/* Very small screens */
@media (max-width: 374px) {
  .docs-main {
    padding: 0.75rem;
  }

  .docs-main h1 {
    font-size: 1.5rem;
  }

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

  .checkbox-group {
    grid-template-columns: 1fr;
  }

  .lang-tab {
    padding: 0.5rem 0.625rem;
    font-size: 0.75rem;
  }

  .spot-block {
    min-width: 32px;
    height: 32px;
    font-size: 0.65rem;
  }

  .returned-spots .spot {
    min-width: 28px;
    height: 28px;
    font-size: 0.6rem;
  }
}