/* ============================================
   DOCUMENTATION PAGES
   ============================================ */

.docs {
  padding-top: calc(var(--space-16) + 80px);
  padding-bottom: var(--space-16);
  min-height: 100vh;
}

/* --- Layout: sidebar + content --- */
.docs__layout {
  display: grid;
  grid-template-columns: 260px 1fr;
  gap: var(--space-12);
  align-items: start;
}

/* --- Sidebar / Table of Contents --- */
.docs__sidebar {
  position: sticky;
  top: calc(var(--header-height) + var(--space-8));
  max-height: calc(100vh - var(--header-height) - var(--space-16));
  overflow-y: auto;
  padding-right: var(--space-4);
  scrollbar-width: thin;
  scrollbar-color: var(--color-border) transparent;
}

.docs__sidebar-title {
  font-family: var(--font-display);
  font-size: 0.6875rem;
  font-weight: 700;
  letter-spacing: 0.08em;
  text-transform: uppercase;
  color: var(--color-text-light);
  margin-bottom: var(--space-4);
  padding-left: var(--space-3);
}

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

.docs__toc li {
  margin-bottom: 2px;
}

.docs__toc a {
  display: block;
  padding: var(--space-2) var(--space-3);
  font-size: 0.875rem;
  line-height: 1.5;
  color: var(--color-text-muted);
  text-decoration: none;
  border-radius: var(--radius-sm);
  transition: color var(--duration-fast) ease, background var(--duration-fast) ease;
}

.docs__toc a:hover {
  color: var(--color-text);
  background: var(--color-bg-muted);
}

.docs__toc a.is-active {
  color: var(--color-primary);
  background: var(--color-accent-soft);
  font-weight: 500;
}

.docs__toc--nested {
  list-style: none;
  padding: 0 0 0 var(--space-4);
  margin: 0;
}

.docs__toc--nested a {
  font-size: 0.8125rem;
  padding: var(--space-1) var(--space-3);
  color: var(--color-text-light);
}

/* --- Main content area --- */
.docs__content {
  max-width: 780px;
  min-width: 0;
}

/* --- Breadcrumb --- */
.docs__breadcrumb {
  display: flex;
  align-items: center;
  gap: var(--space-2);
  font-size: 0.8125rem;
  color: var(--color-text-light);
  margin-bottom: var(--space-6);
}

.docs__breadcrumb a {
  color: var(--color-text-muted);
  text-decoration: none;
  transition: color var(--duration-fast) ease;
}

.docs__breadcrumb a:hover {
  color: var(--color-primary);
}

.docs__breadcrumb svg {
  width: 14px;
  height: 14px;
  opacity: 0.4;
  flex-shrink: 0;
}

/* --- Page header --- */
.docs__header {
  margin-bottom: var(--space-10);
  padding-bottom: var(--space-8);
  border-bottom: 1px solid var(--color-border);
}

.docs__badge {
  display: inline-flex;
  align-items: center;
  gap: var(--space-2);
  padding: var(--space-1) var(--space-3);
  font-size: 0.75rem;
  font-weight: 600;
  color: var(--color-primary);
  background: var(--color-accent-soft);
  border-radius: var(--radius-full);
  margin-bottom: var(--space-4);
  letter-spacing: 0.02em;
}

.docs__badge svg {
  width: 14px;
  height: 14px;
}

.docs__title {
  font-family: var(--font-display);
  font-size: clamp(2rem, 4vw, 2.75rem);
  font-weight: 700;
  line-height: 1.15;
  color: var(--color-text);
  margin-bottom: var(--space-4);
}

.docs__subtitle {
  font-size: 1.125rem;
  line-height: 1.6;
  color: var(--color-text-muted);
  max-width: 600px;
}

/* --- Prose content --- */
.docs__prose {
  font-size: 1rem;
  line-height: 1.75;
  color: var(--color-text-secondary);
}

.docs__prose h2 {
  font-family: var(--font-display);
  font-size: 1.5rem;
  font-weight: 700;
  color: var(--color-text);
  margin-top: var(--space-12);
  margin-bottom: var(--space-4);
  padding-top: var(--space-8);
  border-top: 1px solid var(--color-border);
  scroll-margin-top: calc(var(--header-height) + var(--space-8));
}

.docs__prose h2:first-child {
  margin-top: 0;
  padding-top: 0;
  border-top: none;
}

.docs__prose h3 {
  font-family: var(--font-display);
  font-size: 1.1875rem;
  font-weight: 600;
  color: var(--color-text);
  margin-top: var(--space-8);
  margin-bottom: var(--space-3);
  scroll-margin-top: calc(var(--header-height) + var(--space-8));
}

.docs__prose p {
  margin-bottom: var(--space-4);
}

.docs__prose ul,
.docs__prose ol {
  margin-bottom: var(--space-4);
  padding-left: var(--space-6);
}

.docs__prose li {
  margin-bottom: var(--space-2);
}

.docs__prose li::marker {
  color: var(--color-primary);
}

.docs__prose a {
  color: var(--color-primary);
  text-decoration: underline;
  text-underline-offset: 2px;
  transition: color var(--duration-fast) ease;
}

.docs__prose a:hover {
  color: var(--color-primary-dark);
}

.docs__prose strong {
  color: var(--color-text);
  font-weight: 600;
}

.docs__prose code {
  font-family: var(--font-mono);
  font-size: 0.875em;
  padding: 0.125em 0.375em;
  background: var(--color-bg-muted);
  border: 1px solid var(--color-border);
  border-radius: var(--radius-sm);
  color: var(--color-text);
}

.docs__prose img {
  max-width: 100%;
  height: auto;
  border-radius: var(--radius-lg);
  border: 1px solid var(--color-border);
  margin: var(--space-4) 0;
  box-shadow: var(--shadow-card);
}

/* --- Step blocks --- */
.docs-step {
  display: flex;
  gap: var(--space-5);
  margin-bottom: var(--space-10);
  padding: var(--space-6);
  background: var(--color-bg-card);
  border: 1px solid var(--color-border);
  border-radius: var(--radius-lg);
  transition: border-color var(--duration-fast) ease, box-shadow var(--duration-fast) ease;
}

.docs-step:hover {
  border-color: var(--color-border-strong);
  box-shadow: var(--shadow-card);
}

.docs-step__number {
  flex-shrink: 0;
  width: 36px;
  height: 36px;
  display: flex;
  align-items: center;
  justify-content: center;
  font-family: var(--font-display);
  font-weight: 700;
  font-size: 0.875rem;
  color: var(--color-primary);
  background: var(--color-accent-soft);
  border-radius: var(--radius-full);
  margin-top: 2px;
}

.docs-step__body h3 {
  font-family: var(--font-display);
  font-size: 1.125rem;
  font-weight: 600;
  color: var(--color-text);
  margin-bottom: var(--space-3);
  margin-top: 0;
  padding-top: 0;
  border-top: none;
}

.docs-step__body p {
  margin-bottom: var(--space-3);
  color: var(--color-text-secondary);
}

.docs-step__body p:last-child {
  margin-bottom: 0;
}

.docs-step__body ul {
  margin-bottom: var(--space-3);
  padding-left: var(--space-5);
}

.docs-step__body li {
  margin-bottom: var(--space-1);
  color: var(--color-text-secondary);
}

.docs-step__body img {
  max-width: 100%;
  height: auto;
  border-radius: var(--radius-md);
  border: 1px solid var(--color-border);
  margin: var(--space-3) 0 var(--space-1);
  box-shadow: var(--shadow-sm);
}

/* --- Callout boxes --- */
.docs-callout {
  display: flex;
  gap: var(--space-4);
  padding: var(--space-5);
  border-radius: var(--radius-md);
  margin-bottom: var(--space-6);
  font-size: 0.9375rem;
  line-height: 1.6;
}

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

.docs-callout__content p {
  margin: 0;
}

.docs-callout__content p + p {
  margin-top: var(--space-2);
}

.docs-callout--info {
  background: rgba(10, 147, 150, 0.08);
  border: 1px solid rgba(10, 147, 150, 0.2);
  color: var(--color-text-secondary);
}

.docs-callout--info .docs-callout__icon {
  color: var(--color-info);
}

.docs-callout--warning {
  background: rgba(245, 158, 11, 0.08);
  border: 1px solid rgba(245, 158, 11, 0.2);
  color: var(--color-text-secondary);
}

.docs-callout--warning .docs-callout__icon {
  color: var(--color-warning);
}

.docs-callout--tip {
  background: rgba(15, 123, 87, 0.08);
  border: 1px solid rgba(15, 123, 87, 0.2);
  color: var(--color-text-secondary);
}

.docs-callout--tip .docs-callout__icon {
  color: var(--color-success);
}

/* --- Requirements table --- */
.docs-requirements {
  width: 100%;
  border-collapse: collapse;
  margin-bottom: var(--space-6);
  font-size: 0.9375rem;
  border: 1px solid var(--color-border);
  border-radius: var(--radius-lg);
  overflow: hidden;
}

.docs-requirements th,
.docs-requirements td {
  padding: var(--space-3) var(--space-5);
  text-align: left;
  border-bottom: 1px solid var(--color-border);
}

.docs-requirements th {
  background: var(--color-bg-muted);
  font-weight: 600;
  color: var(--color-text);
  font-size: 0.8125rem;
  text-transform: uppercase;
  letter-spacing: 0.04em;
}

.docs-requirements td:first-child {
  font-weight: 500;
  color: var(--color-text);
  white-space: nowrap;
}

.docs-requirements td:last-child {
  font-family: var(--font-mono);
  font-size: 0.875rem;
  color: var(--color-text-muted);
}

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

.docs-requirements tbody tr:hover {
  background: var(--color-bg-muted);
}

/* --- Path / navigation indicator --- */
.docs-path {
  display: inline-flex;
  align-items: center;
  gap: var(--space-1);
  padding: var(--space-1) var(--space-3);
  font-family: var(--font-mono);
  font-size: 0.8125rem;
  background: var(--color-bg-muted);
  border: 1px solid var(--color-border);
  border-radius: var(--radius-sm);
  color: var(--color-text-muted);
  white-space: nowrap;
}

.docs-path svg {
  width: 12px;
  height: 12px;
  opacity: 0.5;
}

/* --- Next steps / related links --- */
.docs__next {
  margin-top: var(--space-12);
  padding-top: var(--space-8);
  border-top: 1px solid var(--color-border);
}

.docs__next-title {
  font-family: var(--font-display);
  font-size: 1.125rem;
  font-weight: 600;
  color: var(--color-text);
  margin-bottom: var(--space-4);
}

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

.docs__next-card {
  display: flex;
  align-items: center;
  gap: var(--space-4);
  padding: var(--space-5);
  background: var(--color-bg-card);
  border: 1px solid var(--color-border);
  border-radius: var(--radius-lg);
  text-decoration: none;
  transition: border-color var(--duration-fast) ease, box-shadow var(--duration-fast) ease;
}

.docs__next-card:hover {
  border-color: var(--color-primary);
  box-shadow: var(--shadow-card);
}

.docs__next-card-icon {
  flex-shrink: 0;
  width: 40px;
  height: 40px;
  display: flex;
  align-items: center;
  justify-content: center;
  background: var(--color-accent-soft);
  border-radius: var(--radius-md);
  color: var(--color-primary);
}

.docs__next-card-icon svg {
  width: 20px;
  height: 20px;
}

.docs__next-card-text {
  min-width: 0;
}

.docs__next-card-label {
  font-weight: 600;
  font-size: 0.9375rem;
  color: var(--color-text);
  margin-bottom: 2px;
}

.docs__next-card-desc {
  font-size: 0.8125rem;
  color: var(--color-text-muted);
}

/* --- Back to documentation link --- */
.docs__back-link {
  display: inline-flex;
  align-items: center;
  gap: 6px;
  margin-top: var(--space-8);
  font-size: 0.875rem;
  font-weight: 500;
  color: var(--color-text-muted);
  text-decoration: none;
  transition: color var(--duration-fast) var(--ease-out);
}

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

.docs__back-link svg {
  width: 14px;
  height: 14px;
}

/* --- Hub page (docs index) --- */
.docs__header--hub {
  text-align: center;
  max-width: 640px;
  margin-left: auto;
  margin-right: auto;
}

.docs-hub__grid {
  display: grid;
  grid-template-columns: repeat(auto-fill, minmax(320px, 1fr));
  gap: var(--space-5);
  margin-top: var(--space-8);
}

.docs-hub__card {
  display: flex;
  align-items: center;
  gap: var(--space-5);
  padding: var(--space-6);
  background: var(--color-bg-card);
  border: 1px solid var(--color-border);
  border-radius: var(--radius-lg);
  text-decoration: none;
  transition: border-color var(--duration-fast) ease, box-shadow var(--duration-fast) ease;
}

a.docs-hub__card:hover {
  border-color: var(--color-primary);
  box-shadow: var(--shadow-card);
}

a.docs-hub__card:hover .docs-hub__card-arrow {
  transform: translateX(3px);
}

.docs-hub__card--soon {
  opacity: 0.6;
  cursor: default;
}

.docs-hub__card-icon {
  flex-shrink: 0;
  width: 44px;
  height: 44px;
  display: flex;
  align-items: center;
  justify-content: center;
  background: var(--color-accent-soft);
  border-radius: var(--radius-md);
  color: var(--color-primary);
}

.docs-hub__card-icon svg {
  width: 22px;
  height: 22px;
}

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

.docs-hub__card-title {
  font-family: var(--font-display);
  font-size: 1.0625rem;
  font-weight: 600;
  color: var(--color-text);
  margin-bottom: var(--space-1);
}

.docs-hub__card-desc {
  font-size: 0.875rem;
  line-height: 1.5;
  color: var(--color-text-muted);
}

.docs-hub__card-badge {
  display: inline-block;
  margin-top: var(--space-2);
  padding: 2px var(--space-2);
  font-size: 0.6875rem;
  font-weight: 600;
  text-transform: uppercase;
  letter-spacing: 0.04em;
  color: var(--color-text-light);
  background: var(--color-bg-muted);
  border-radius: var(--radius-sm);
}

.docs-hub__card-arrow {
  flex-shrink: 0;
  width: 16px;
  height: 16px;
  color: var(--color-text-light);
  transition: transform var(--duration-fast) ease;
}

/* --- Mobile: single column --- */
@media (max-width: 1024px) {
  .docs__layout {
    grid-template-columns: 1fr;
    gap: var(--space-6);
  }

  .docs__sidebar {
    position: relative;
    top: 0;
    max-height: none;
    padding: var(--space-5);
    background: var(--color-bg-muted);
    border-radius: var(--radius-lg);
    border: 1px solid var(--color-border);
  }
}

@media (max-width: 640px) {
  .docs {
    padding-top: calc(var(--space-12) + 80px);
    padding-bottom: var(--space-10);
  }

  .docs__title {
    font-size: 1.75rem;
  }

  .docs-step {
    flex-direction: column;
    gap: var(--space-3);
    padding: var(--space-5);
  }

  .docs-step__number {
    width: 32px;
    height: 32px;
    font-size: 0.8125rem;
  }

  .docs-callout {
    flex-direction: column;
    gap: var(--space-2);
  }

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

  .docs-hub__grid {
    grid-template-columns: 1fr;
  }

  .docs-hub__card {
    padding: var(--space-5);
  }

  .docs-hub__card-arrow {
    display: none;
  }
}