/* ============================================================
   components.css — Callouts, Tables, Cards, Badges, Search,
                    Sidebar Nav, TOC, Header controls
   ============================================================ */

/* ── Search Box ── */
.search-box {
  position: relative;
  width: 100%;
}

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

.search-input {
  width: 100%;
  height: 36px;
  padding: 0 12px 0 38px;
  background: var(--clr-bg-subtle);
  border: 1px solid var(--clr-border);
  border-radius: var(--radius-md);
  font-family: var(--font-sans);
  font-size: 0.875rem;
  color: var(--clr-text);
  outline: none;
  transition: border-color var(--transition), box-shadow var(--transition), background var(--transition);
}

.search-input::placeholder {
  color: var(--clr-text-faint);
}

.search-input:focus {
  border-color: var(--clr-primary);
  background: var(--clr-bg);
  box-shadow: 0 0 0 3px rgba(113, 75, 103, 0.15);
}

.search-shortcut {
  position: absolute;
  right: 10px;
  top: 50%;
  transform: translateY(-50%);
  display: flex;
  align-items: center;
  gap: 2px;
}

.search-shortcut kbd {
  display: inline-block;
  padding: 1px 5px;
  background: var(--clr-bg-muted);
  border: 1px solid var(--clr-border-strong);
  border-radius: 4px;
  font-family: var(--font-mono);
  font-size: 0.7rem;
  color: var(--clr-text-muted);
  line-height: 1.6;
}

/* Search Results Dropdown */
.search-results {
  position: absolute;
  top: calc(100% + 6px);
  left: 0;
  right: 0;
  z-index: 500;
  background: var(--clr-surface);
  border: 1px solid var(--clr-border);
  border-radius: var(--radius-lg);
  box-shadow: var(--shadow-lg);
  overflow: hidden;
  display: none;
  max-height: 480px;
  overflow-y: auto;
}

.search-results.visible { display: block; }

.search-result-group-title {
  padding: 10px 16px 6px;
  font-size: 0.7rem;
  font-weight: 700;
  text-transform: uppercase;
  letter-spacing: 0.1em;
  color: var(--clr-text-faint);
}

.search-result-item {
  display: block;
  padding: 10px 16px;
  text-decoration: none;
  transition: background var(--transition);
  cursor: pointer;
  border-top: 1px solid var(--clr-border-muted);
}
.search-result-item:first-child { border-top: none; }
.search-result-item:hover,
.search-result-item.focused {
  background: var(--clr-bg-subtle);
}

.result-page-title {
  font-size: 0.875rem;
  font-weight: 600;
  color: var(--clr-text);
  margin-bottom: 2px;
}

.result-heading {
  font-size: 0.8rem;
  color: var(--clr-primary);
  font-weight: 500;
}

.result-preview {
  font-size: 0.775rem;
  color: var(--clr-text-muted);
  margin-top: 2px;
  white-space: nowrap;
  overflow: hidden;
  text-overflow: ellipsis;
}

.search-no-results {
  padding: 24px 16px;
  text-align: center;
  color: var(--clr-text-muted);
  font-size: 0.875rem;
}

/* Search Modal (mobile / kbd shortcut) */
.search-modal-overlay {
  position: fixed;
  inset: 0;
  background: rgba(0,0,0,0.5);
  z-index: 1000;
  display: none;
  align-items: flex-start;
  justify-content: center;
  padding-top: 80px;
  backdrop-filter: blur(4px);
}
.search-modal-overlay.open { display: flex; }

.search-modal {
  width: 600px;
  max-width: calc(100vw - 2rem);
  background: var(--clr-surface);
  border: 1px solid var(--clr-border);
  border-radius: var(--radius-xl);
  box-shadow: var(--shadow-lg);
  overflow: hidden;
}

.search-modal-header {
  display: flex;
  align-items: center;
  gap: var(--space-3);
  padding: var(--space-4) var(--space-5);
  border-bottom: 1px solid var(--clr-border);
}

.search-modal-input {
  flex: 1;
  border: none;
  background: transparent;
  font-family: var(--font-sans);
  font-size: 1rem;
  color: var(--clr-text);
  outline: none;
}

.search-modal-close {
  background: none;
  border: none;
  cursor: pointer;
  color: var(--clr-text-muted);
  padding: var(--space-1);
  border-radius: var(--radius-sm);
  transition: color var(--transition);
}
.search-modal-close:hover { color: var(--clr-text); }

.search-modal-results {
  max-height: 400px;
  overflow-y: auto;
}

/* ── Dark Mode Toggle ── */
.theme-toggle {
  display: flex;
  align-items: center;
  justify-content: center;
  width: 34px;
  height: 34px;
  background: none;
  border: 1px solid var(--clr-border);
  border-radius: var(--radius-md);
  cursor: pointer;
  color: var(--clr-text-muted);
  transition: color var(--transition), border-color var(--transition), background var(--transition);
}
.theme-toggle:hover {
  color: var(--clr-primary);
  border-color: var(--clr-primary);
  background: var(--clr-bg-subtle);
}

.theme-toggle .icon-sun  { display: none; }
.theme-toggle .icon-moon { display: block; }
[data-theme="dark"] .theme-toggle .icon-sun  { display: block; }
[data-theme="dark"] .theme-toggle .icon-moon { display: none; }

/* ── Hamburger (mobile) ── */
.hamburger {
  display: none;
  align-items: center;
  justify-content: center;
  width: 34px;
  height: 34px;
  background: none;
  border: 1px solid var(--clr-border);
  border-radius: var(--radius-md);
  cursor: pointer;
  color: var(--clr-text-muted);
  transition: color var(--transition), border-color var(--transition);
  flex-shrink: 0;
}
.hamburger:hover {
  color: var(--clr-primary);
  border-color: var(--clr-primary);
}

@media (max-width: 900px) {
  .hamburger {
    display: flex;
    /* Slightly larger tap target on mobile */
    width: 38px;
    height: 38px;
  }
}

/* Mobile overlay backdrop */
.sidebar-backdrop {
  display: none;
  position: fixed;
  inset: 0;
  background: rgba(0,0,0,0.4);
  z-index: 150;
  backdrop-filter: blur(2px);
}
.sidebar-backdrop.visible { display: block; }

/* ── Sidebar Navigation ── */
.sidebar-nav {
  padding: 0 var(--space-3);
}

.sidebar-nav-group {
  margin-bottom: var(--space-6);
}

.sidebar-group-label {
  display: block;
  padding: var(--space-2) var(--space-3);
  font-size: 0.7rem;
  font-weight: 700;
  text-transform: uppercase;
  letter-spacing: 0.1em;
  color: var(--clr-text-faint);
  cursor: default;
  margin-bottom: var(--space-1);
}

.sidebar-link {
  display: flex;
  align-items: center;
  gap: var(--space-3);
  padding: 6px var(--space-3);
  border-radius: var(--radius-md);
  font-size: 0.875rem;
  color: var(--clr-text-muted);
  text-decoration: none;
  transition: color var(--transition), background var(--transition);
  line-height: 1.4;
  position: relative;
}

.sidebar-link:hover {
  color: var(--clr-text);
  background: var(--clr-bg-muted);
}

.sidebar-link.active {
  color: var(--clr-primary);
  background: var(--clr-bg-muted);
  font-weight: 500;
}

.sidebar-link.active::before {
  content: '';
  position: absolute;
  left: 0;
  top: 4px;
  bottom: 4px;
  width: 3px;
  background: var(--clr-primary);
  border-radius: 2px;
}

.sidebar-link .link-icon {
  width: 14px;
  height: 14px;
  flex-shrink: 0;
  opacity: 0.6;
}
.sidebar-link.active .link-icon { opacity: 1; }

/* Sidebar divider */
.sidebar-divider {
  height: 1px;
  background: var(--clr-border-muted);
  margin: var(--space-4) var(--space-3);
}

/* ── TOC (Table of Contents) ── */
.toc-container {
  position: sticky;
  top: calc(var(--header-height) + var(--space-6));
}

.toc-title {
  font-size: 0.7rem;
  font-weight: 700;
  text-transform: uppercase;
  letter-spacing: 0.1em;
  color: var(--clr-text-faint);
  margin-bottom: var(--space-3);
}

.toc-list {
  list-style: none;
  padding: 0;
  border-left: 1px solid var(--clr-border);
}

.toc-item a {
  display: block;
  padding: 4px 14px;
  font-size: 0.8rem;
  color: var(--clr-text-muted);
  text-decoration: none;
  border-left: 2px solid transparent;
  margin-left: -1px;
  transition: color var(--transition), border-color var(--transition);
  line-height: 1.5;
}

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

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

.toc-item.toc-h3 a {
  padding-left: 24px;
  font-size: 0.775rem;
}

/* ── Callout / Admonition Boxes ── */
.callout {
  display: flex;
  gap: var(--space-4);
  padding: var(--space-5);
  border-radius: var(--radius-md);
  margin: var(--space-6) 0;
  border: 1px solid transparent;
}

.callout-icon {
  flex-shrink: 0;
  width: 20px;
  height: 20px;
  margin-top: 2px;
}

.callout-body {
  flex: 1;
  min-width: 0;
}

.callout-title {
  font-weight: 600;
  font-size: 0.875rem;
  margin-bottom: var(--space-1);
}

.callout-body p {
  font-size: 0.9rem;
  margin-bottom: 0;
  color: inherit;
}

.callout-body code:not(pre code) {
  font-size: 0.85em;
}

/* Callout variants */
.callout-note {
  background: var(--clr-info-bg);
  border-color: var(--clr-info);
  color: color-mix(in srgb, var(--clr-info) 80%, var(--clr-text));
}
.callout-note .callout-title { color: var(--clr-info); }

.callout-tip {
  background: var(--clr-tip-bg);
  border-color: var(--clr-tip);
  color: color-mix(in srgb, var(--clr-tip) 80%, var(--clr-text));
}
.callout-tip .callout-title { color: var(--clr-tip); }

.callout-warning {
  background: var(--clr-warning-bg);
  border-color: var(--clr-warning);
  color: color-mix(in srgb, var(--clr-warning) 80%, var(--clr-text));
}
.callout-warning .callout-title { color: var(--clr-warning); }

.callout-danger {
  background: var(--clr-danger-bg);
  border-color: var(--clr-danger);
  color: color-mix(in srgb, var(--clr-danger) 80%, var(--clr-text));
}
.callout-danger .callout-title { color: var(--clr-danger); }

.callout-best-practice {
  background: linear-gradient(135deg, color-mix(in srgb, var(--clr-primary) 8%, transparent), color-mix(in srgb, var(--clr-primary) 4%, transparent));
  border-color: var(--clr-primary);
  color: color-mix(in srgb, var(--clr-primary) 90%, var(--clr-text));
}
.callout-best-practice .callout-title { color: var(--clr-primary); }

/* Legacy .note / .tip / .warning compat */
.note, .tip, .warning, .danger {
  display: flex;
  gap: var(--space-4);
  padding: var(--space-5);
  border-radius: var(--radius-md);
  margin: var(--space-6) 0;
  border-left: 4px solid;
}
.note    { background: var(--clr-info-bg);    border-color: var(--clr-info);    color: color-mix(in srgb, var(--clr-info) 80%, var(--clr-text)); }
.tip     { background: var(--clr-tip-bg);     border-color: var(--clr-tip);     color: color-mix(in srgb, var(--clr-tip) 80%, var(--clr-text)); }
.warning { background: var(--clr-warning-bg); border-color: var(--clr-warning); color: color-mix(in srgb, var(--clr-warning) 80%, var(--clr-text)); }
.danger  { background: var(--clr-danger-bg);  border-color: var(--clr-danger);  color: color-mix(in srgb, var(--clr-danger) 80%, var(--clr-text)); }
.note strong, .tip strong, .warning strong, .danger strong { display: block; margin-bottom: var(--space-1); }
.note code:not(pre code), .tip code:not(pre code), .warning code:not(pre code) {
  background: rgba(255,255,255,0.4);
}

/* ── Tables ── */
.table-wrapper {
  width: 100%;
  max-width: 100%;
  overflow-x: auto;
  margin: var(--space-6) 0;
  border-radius: var(--radius-md);
  border: 1px solid var(--clr-border);
  box-shadow: var(--shadow-sm);
  /* Improve scroll momentum on iOS */
  -webkit-overflow-scrolling: touch;
}

table {
  width: 100%;
  border-collapse: collapse;
  font-size: 0.9rem;
}

.table-wrapper table {
  border: none;
}

thead {
  background: var(--clr-bg-subtle);
}

th {
  padding: var(--space-3) var(--space-4);
  text-align: left;
  font-size: 0.8rem;
  font-weight: 600;
  text-transform: uppercase;
  letter-spacing: 0.05em;
  color: var(--clr-text-muted);
  border-bottom: 1px solid var(--clr-border);
  /* Allow wrapping on very narrow screens so the table stays scrollable
     rather than the th being the cause of overflow */
  white-space: normal;
  min-width: 80px;
}

td {
  padding: var(--space-3) var(--space-4);
  border-bottom: 1px solid var(--clr-border-muted);
  color: var(--clr-text);
  vertical-align: top;
  line-height: 1.5;
}

tbody tr:last-child td {
  border-bottom: none;
}

tbody tr:hover td {
  background: var(--clr-bg-subtle);
}

tbody tr:nth-child(even) td {
  background: color-mix(in srgb, var(--clr-bg-subtle) 50%, transparent);
}

tbody tr:nth-child(even):hover td {
  background: var(--clr-bg-subtle);
}

/* ── Cards ── */
.card-grid {
  display: grid;
  grid-template-columns: repeat(auto-fit, minmax(200px, 1fr));
  gap: var(--space-4);
  margin: var(--space-6) 0;
}

.card {
  background: var(--clr-bg);
  border: 1px solid var(--clr-border);
  border-radius: var(--radius-lg);
  padding: var(--space-5);
  box-shadow: var(--shadow-sm);
  transition: border-color var(--transition), box-shadow var(--transition), transform var(--transition);
}

.card:hover {
  border-color: var(--clr-primary-light);
  box-shadow: var(--shadow-md);
  transform: translateY(-1px);
}

.card-icon {
  font-size: 1.5rem;
  margin-bottom: var(--space-3);
}

.card-title {
  font-size: 0.875rem;
  font-weight: 600;
  color: var(--clr-text);
  margin-bottom: var(--space-2);
}

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

/* ── Badges ── */
.badge {
  display: inline-flex;
  align-items: center;
  gap: 4px;
  padding: 3px 10px;
  border-radius: 999px;
  font-size: 0.75rem;
  font-weight: 500;
  white-space: nowrap;
}

.badge-purple {
  background: color-mix(in srgb, var(--clr-primary) 12%, transparent);
  color: var(--clr-primary);
  border: 1px solid color-mix(in srgb, var(--clr-primary) 25%, transparent);
}

.badge-neutral {
  background: var(--clr-bg-muted);
  color: var(--clr-text-muted);
  border: 1px solid var(--clr-border);
}

.badge-success {
  background: var(--clr-success-bg);
  color: var(--clr-success);
  border: 1px solid color-mix(in srgb, var(--clr-success) 25%, transparent);
}

/* ── Step list ── */
.steps {
  counter-reset: step;
  list-style: none;
  padding: 0;
  margin: var(--space-6) 0;
}

.steps li {
  counter-increment: step;
  display: flex;
  gap: var(--space-4);
  padding: var(--space-4) 0;
  border-bottom: 1px solid var(--clr-border-muted);
  align-items: flex-start;
}
.steps li:last-child { border-bottom: none; }

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

/* ── Buttons ── */
.btn {
  display: inline-flex;
  align-items: center;
  gap: var(--space-2);
  padding: 8px 18px;
  border-radius: var(--radius-md);
  font-family: var(--font-sans);
  font-size: 0.875rem;
  font-weight: 500;
  text-decoration: none;
  cursor: pointer;
  border: 1px solid transparent;
  transition: all var(--transition);
  line-height: 1;
}

.btn-primary {
  background: var(--clr-primary);
  color: white;
  border-color: var(--clr-primary);
}
.btn-primary:hover {
  background: var(--clr-primary-dark);
  border-color: var(--clr-primary-dark);
  text-decoration: none;
  color: white;
}

.btn-outline {
  background: transparent;
  color: var(--clr-primary);
  border-color: var(--clr-primary);
}
.btn-outline:hover {
  background: var(--clr-primary);
  color: white;
  text-decoration: none;
}

/* Legacy .button compat */
.button {
  display: inline-flex;
  align-items: center;
  gap: var(--space-2);
  padding: 8px 18px;
  background: var(--clr-primary);
  color: white;
  border-radius: var(--radius-md);
  font-size: 0.875rem;
  font-weight: 500;
  text-decoration: none;
  transition: background var(--transition);
  border: 1px solid transparent;
}
.button:hover {
  background: var(--clr-primary-dark);
  text-decoration: none;
  color: white;
}

/* ── SVG Diagram container ── */
.diagram-container {
  margin: var(--space-8) 0;
  text-align: center;
}

.diagram-container svg {
  max-width: 100%;
  height: auto;
}

.diagram-caption {
  font-size: 0.8rem;
  color: var(--clr-text-muted);
  margin-top: var(--space-3);
  font-style: italic;
}

/* ── Image with caption ── */
.doc-image {
  margin: var(--space-8) 0;
}

.doc-image img {
  max-width: 100%;
  height: auto;
  border-radius: var(--radius-lg);
  border: 1px solid var(--clr-border);
  box-shadow: var(--shadow-md);
  cursor: zoom-in;
  transition: box-shadow var(--transition);
}
.doc-image img:hover { box-shadow: var(--shadow-lg); }

.doc-image figcaption {
  font-size: 0.8rem;
  color: var(--clr-text-muted);
  margin-top: var(--space-3);
  text-align: center;
  font-style: italic;
}

/* Image lightbox */
.lightbox-overlay {
  position: fixed;
  inset: 0;
  background: rgba(0,0,0,0.85);
  z-index: 2000;
  display: none;
  align-items: center;
  justify-content: center;
  padding: var(--space-8);
  cursor: zoom-out;
}
.lightbox-overlay.open { display: flex; }
.lightbox-overlay img {
  max-width: 100%;
  max-height: 100%;
  border-radius: var(--radius-md);
  box-shadow: var(--shadow-lg);
}

/* ── Home page quick-start grid ── */
.home-hero {
  padding: var(--space-12) 0 var(--space-8);
  border-bottom: 1px solid var(--clr-border);
  margin-bottom: var(--space-10);
}

.home-hero h1 {
  font-size: 2.4rem;
  font-weight: 700;
  letter-spacing: -0.025em;
  color: var(--clr-text);
  line-height: 1.2;
  margin-bottom: var(--space-4);
}

.home-hero .hero-sub {
  font-size: 1.1rem;
  color: var(--clr-text-muted);
  max-width: 600px;
  margin-bottom: var(--space-6);
}

.home-hero .hero-badges {
  display: flex;
  flex-wrap: wrap;
  gap: var(--space-3);
  margin-bottom: var(--space-8);
}

.nav-card-grid {
  display: grid;
  grid-template-columns: repeat(auto-fit, minmax(240px, 1fr));
  gap: var(--space-4);
  margin: var(--space-8) 0;
}

.nav-card {
  display: block;
  padding: var(--space-6);
  background: var(--clr-bg);
  border: 1px solid var(--clr-border);
  border-radius: var(--radius-lg);
  text-decoration: none;
  color: var(--clr-text);
  transition: border-color var(--transition), box-shadow var(--transition), transform var(--transition);
  box-shadow: var(--shadow-sm);
}

.nav-card:hover {
  border-color: var(--clr-primary);
  box-shadow: var(--shadow-md);
  transform: translateY(-2px);
  text-decoration: none;
}

.nav-card .nav-card-icon {
  font-size: 1.75rem;
  margin-bottom: var(--space-4);
}

.nav-card .nav-card-title {
  font-size: 0.95rem;
  font-weight: 600;
  color: var(--clr-text);
  margin-bottom: var(--space-2);
}

.nav-card .nav-card-desc {
  font-size: 0.8rem;
  color: var(--clr-text-muted);
  line-height: 1.5;
}

/* ── Roadmap steps ── */
.roadmap {
  position: relative;
  margin: var(--space-8) 0;
}

.roadmap-step {
  display: flex;
  gap: var(--space-5);
  padding: var(--space-4) 0;
  align-items: flex-start;
}

.roadmap-num {
  display: flex;
  align-items: center;
  justify-content: center;
  width: 32px;
  height: 32px;
  border-radius: 50%;
  background: var(--clr-primary);
  color: white;
  font-size: 0.8rem;
  font-weight: 700;
  flex-shrink: 0;
}

.roadmap-content a {
  font-weight: 500;
}

/* ── Verification checklist ── */
.verify-list {
  list-style: none;
  padding: 0;
  margin: var(--space-4) 0;
}

.verify-list li {
  display: flex;
  align-items: center;
  gap: var(--space-3);
  padding: var(--space-3) 0;
  border-bottom: 1px solid var(--clr-border-muted);
  font-size: 0.9rem;
}

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

.verify-list .tick {
  display: inline-flex;
  align-items: center;
  justify-content: center;
  width: 20px;
  height: 20px;
  border-radius: 50%;
  background: var(--clr-success-bg);
  color: var(--clr-success);
  font-size: 11px;
  font-weight: 700;
  flex-shrink: 0;
}

/* ── Inline version tag ── */
.version-tag {
  display: inline-flex;
  align-items: center;
  padding: 2px 8px;
  border-radius: 999px;
  font-size: 0.7rem;
  font-weight: 600;
  background: color-mix(in srgb, var(--clr-primary) 12%, transparent);
  color: var(--clr-primary);
  border: 1px solid color-mix(in srgb, var(--clr-primary) 25%, transparent);
  vertical-align: middle;
  margin-left: 4px;
}