/* Docs - Layout, Prose, Navigation, Components */

/* ================================================
   DOCS SIDEBAR — Fixed full-height left navigation
   ================================================ */
.docs-sidebar {
  position: fixed;
  top: 53px;
  left: 0;
  bottom: 0;
  width: 240px;
  border-right: 1px solid var(--color-border);
  background-color: var(--color-background);
  overflow-y: auto;
  z-index: 50;
  padding: var(--space-xl) var(--space-md) var(--space-xl) var(--space-md);
}

.docs-sidebar-nav {
  display: flex;
  flex-direction: column;
  gap: 2px;
}

.docs-sidebar-item {
  font: var(--type-body-medium);
  color: var(--color-gray-light);
  padding: 6px 0 6px var(--space-sm);
  border-left: 2px solid transparent;
}

.docs-sidebar-item:hover {
  color: var(--color-text);
  opacity: 1;
}

.docs-sidebar-item--active {
  color: var(--color-text);
  font-weight: 700;
  border-left-color: var(--color-text);
}

.docs-sidebar-item--active:hover {
  opacity: 1;
}

/* Sub-navigation — section anchors nested under active page */
.docs-sidebar-sub {
  display: flex;
  flex-direction: column;
  gap: 1px;
  padding: var(--space-xs) 0 var(--space-xs) calc(var(--space-sm) + 12px);
}

.docs-sidebar-sub a {
  font-size: 13px;
  color: var(--color-gray-light);
  padding: 3px 0;
  line-height: 1.4;
}

.docs-sidebar-sub a:hover {
  color: var(--color-text);
  opacity: 1;
}

/* ================================================
   DOCS CONTENT — Main area offset by sidebar
   ================================================ */
.docs-content {
  margin-left: 240px;
}

/* ================================================
   DOCS HERO — Section number + title + description
   ================================================ */
.docs-hero {
  padding-top: var(--space-2xl);
  padding-bottom: var(--space-md);
}

.docs-content main > section:first-child {
  padding-top: var(--space-lg);
}

.docs-hero .docs-section-number {
  font-weight: 800;
  font-size: 14px;
  letter-spacing: 0.05em;
  text-transform: uppercase;
  color: var(--color-gray-light);
  margin-bottom: var(--space-sm);
}

/* ================================================
   DOCS PROSE — Typographic content block
   ================================================ */
.docs-prose {
  max-width: 680px;
}

.docs-prose p {
  font: var(--type-body-large);
  margin-bottom: var(--space-md);
}

.docs-prose h3 {
  font: var(--type-title-large);
  margin-top: var(--space-2xl);
  margin-bottom: var(--space-md);
}

.docs-prose h4 {
  font: var(--type-title-medium);
  margin-top: var(--space-xl);
  margin-bottom: var(--space-sm);
}

.docs-prose ul,
.docs-prose ol {
  font: var(--type-body-large);
  margin-bottom: var(--space-md);
  padding-left: var(--space-md);
}

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

.docs-prose code {
  font-family: var(--font-mono);
  font-size: 0.85em;
  background-color: #F5F5F5;
  padding: 2px 6px;
  border-radius: var(--radius-small);
}

.docs-prose strong {
  font-weight: 700;
}

/* ================================================
   DOCS SPLIT — Two-column docs layout
   ================================================ */
.docs-split {
  display: grid;
  grid-template-columns: 55% 1fr;
  gap: var(--space-2xl);
  align-items: start;
}

.docs-split--reversed {
  grid-template-columns: 1fr 55%;
}

.docs-split--reversed > :first-child {
  order: 2;
}

.docs-split--reversed > :last-child {
  order: 1;
}

/* ================================================
   DOCS TABLE — Styled spec/API tables
   ================================================ */
.docs-req-table {
  width: 100%;
  border-collapse: collapse;
  margin-bottom: var(--space-lg);
}

.docs-req-table th {
  font: var(--type-label);
  text-align: left;
  padding: var(--space-sm) var(--space-sm) var(--space-sm) 0;
  border-bottom: 2px solid var(--color-text);
}

.docs-req-table td {
  font: var(--type-body-medium);
  padding: var(--space-sm) var(--space-sm) var(--space-sm) 0;
  border-bottom: 1px solid var(--color-border);
  vertical-align: top;
}

.docs-req-table td:first-child {
  font-weight: 600;
  white-space: nowrap;
  padding-right: var(--space-lg);
}

.docs-req-table td code {
  font-family: var(--font-mono);
  font-size: 0.85em;
  background-color: #F5F5F5;
  padding: 2px 6px;
  border-radius: var(--radius-small);
}

/* ================================================
   DOCS CALLOUT — Left-bordered pull quote
   ================================================ */
.docs-callout {
  border-left: 3px solid var(--color-text);
  padding-left: var(--space-md);
  margin-top: var(--space-lg);
  margin-bottom: var(--space-lg);
  max-width: 680px;
}

.docs-callout p {
  font: var(--type-body-large);
  font-style: italic;
}

/* ================================================
   DOCS LAYERS — Stacked box diagram
   ================================================ */
.docs-layers {
  display: flex;
  flex-direction: column;
  gap: 0;
  max-width: 480px;
}

.docs-layer {
  border: 1px solid var(--color-border);
  padding: var(--space-sm) var(--space-md);
  font-family: var(--font-mono);
  font-size: 13px;
  text-align: center;
  background-color: var(--color-background);
}

.docs-layer + .docs-layer {
  border-top: none;
}

.docs-layer--active {
  border-color: var(--color-text);
  font-weight: 600;
}

.docs-layer-arrow {
  text-align: center;
  font-family: var(--font-mono);
  font-size: 13px;
  color: var(--color-gray-light);
  padding: var(--space-xs) 0;
}

/* ================================================
   DOCS CODE — Terminal mockup without perspective
   ================================================ */
.docs-code {
  background-color: var(--color-terminal-bg);
  border-radius: 6px;
  overflow: hidden;
  box-shadow: 0 12px 24px rgba(0, 0, 0, 0.08);
  margin-top: var(--space-md);
  margin-bottom: var(--space-lg);
}

.docs-code .terminal-chrome {
  display: flex;
  align-items: center;
  gap: 6px;
  padding: 12px 16px;
  background-color: #1A1A1A;
}

.docs-code .terminal-dot {
  width: 10px;
  height: 10px;
  border-radius: 50%;
  background-color: #333333;
}

.docs-code .terminal-title {
  font-family: var(--font-mono);
  font-size: 11px;
  color: #666666;
  margin-left: 8px;
}

.docs-code .terminal-body {
  padding: 20px;
  font-family: var(--font-mono);
  font-size: 13px;
  line-height: 1.6;
  color: #CCCCCC;
}

.docs-code .terminal-line {
  margin-bottom: 4px;
  white-space: pre-wrap;
  word-break: break-word;
}

.docs-code .terminal-prompt {
  color: #FFFFFF;
  font-weight: 600;
}

.docs-code .terminal-comment {
  color: #666666;
  font-style: italic;
}

.docs-code .terminal-keyword {
  color: #FFFFFF;
  font-weight: 600;
}

.docs-code .terminal-type {
  color: #AAAAAA;
}

.docs-code .terminal-string {
  color: #999999;
}

.docs-code .terminal-response {
  color: #AAAAAA;
}

.docs-code .terminal-file {
  color: #FFFFFF;
  font-weight: 600;
}

.docs-code .terminal-diff-add {
  background-color: rgba(255, 255, 255, 0.06);
  color: #CCCCCC;
}

.docs-code .terminal-diff-remove {
  background-color: rgba(255, 255, 255, 0.03);
  color: #777777;
  text-decoration: line-through;
}

/* ================================================
   DOCS NAV FOOTER — Prev/Next page links
   ================================================ */
.docs-nav-footer {
  border-top: 1px solid var(--color-border);
  padding-top: var(--space-xl);
  margin-top: var(--space-3xl);
  padding-bottom: var(--space-xl);
  display: flex;
  justify-content: space-between;
  align-items: flex-start;
}

.docs-nav-footer a {
  font: var(--type-label);
  display: flex;
  flex-direction: column;
  gap: var(--space-xs);
}

.docs-nav-footer a:hover {
  opacity: 0.7;
}

.docs-nav-footer .docs-nav-label {
  color: var(--color-gray-light);
  font-size: 12px;
  text-transform: uppercase;
  letter-spacing: 0.05em;
}

.docs-nav-footer .docs-nav-title {
  font-weight: 700;
  font-size: 16px;
  color: var(--color-text);
}

.docs-nav-footer .docs-nav-next {
  text-align: right;
  margin-left: auto;
}

/* ================================================
   DOCS-SPECIFIC — Principles, Phase Timeline, Grid
   ================================================ */
.docs-principles {
  list-style: none;
  padding: 0;
  counter-reset: principle;
}

.docs-principles li {
  counter-increment: principle;
  padding: var(--space-md) 0;
  border-bottom: 1px solid var(--color-border);
  font: var(--type-body-large);
}

.docs-principles li::before {
  content: counter(principle, decimal-leading-zero);
  font-weight: 800;
  font-size: 14px;
  letter-spacing: 0.05em;
  color: var(--color-gray-light);
  display: block;
  margin-bottom: var(--space-xs);
}

.docs-principles li strong {
  font-weight: 700;
}

.docs-phase-timeline {
  display: flex;
  flex-direction: column;
  gap: 0;
}

.docs-phase {
  display: grid;
  grid-template-columns: 80px 1fr;
  gap: var(--space-md);
  padding: var(--space-sm) 0;
  border-bottom: 1px solid var(--color-border);
  align-items: baseline;
}

.docs-phase-label {
  font-weight: 800;
  font-size: 14px;
  letter-spacing: 0.05em;
  text-transform: uppercase;
  color: var(--color-gray-light);
}

.docs-phase-desc {
  font: var(--type-body-medium);
}

.docs-phase--current .docs-phase-label {
  color: var(--color-accent);
}

.docs-phase--current .docs-phase-desc {
  font-weight: 600;
}

.docs-page-grid {
  display: grid;
  grid-template-columns: repeat(3, 1fr);
  gap: var(--space-lg);
  margin-top: var(--space-xl);
}

.docs-page-card {
  border: 1px solid var(--color-border);
  padding: var(--space-md);
  display: flex;
  flex-direction: column;
  gap: var(--space-xs);
}

.docs-page-card:hover {
  border-color: var(--color-text);
  opacity: 1;
}

.docs-page-card .docs-page-card-number {
  font-weight: 800;
  font-size: 14px;
  letter-spacing: 0.05em;
  color: var(--color-gray-light);
}

.docs-page-card .docs-page-card-title {
  font: var(--type-title-medium);
}

.docs-page-card .docs-page-card-desc {
  font: var(--type-body-medium);
  color: var(--color-gray-light);
}

/* Active nav link */
.nav-link--active {
  font-weight: 700 !important;
}

/* Full-width nav on docs pages */
.nav--docs .container {
  max-width: none;
}

/* ================================================
   RESPONSIVE
   ================================================ */
@media (max-width: 1024px) {
  .docs-split,
  .docs-split--reversed {
    grid-template-columns: 1fr;
    gap: var(--space-lg);
  }

  .docs-split--reversed > :first-child {
    order: 1;
  }

  .docs-split--reversed > :last-child {
    order: 2;
  }

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

@media (max-width: 768px) {
  .docs-sidebar {
    position: static;
    width: auto;
    border-right: none;
    border-bottom: 1px solid var(--color-border);
    padding: var(--space-sm) var(--space-md);
    overflow-y: visible;
  }

  .docs-sidebar-nav {
    flex-direction: row;
    flex-wrap: wrap;
    gap: 0;
  }

  .docs-sidebar-item {
    border-left: none;
    border-bottom: 2px solid transparent;
    padding: var(--space-xs) var(--space-sm);
  }

  .docs-sidebar-item--active {
    border-left-color: transparent;
    border-bottom-color: var(--color-text);
  }

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

  .docs-content {
    margin-left: 0;
  }
}

@media (max-width: 640px) {
  .docs-hero {
    padding-top: var(--space-xl);
    padding-bottom: var(--space-lg);
  }

  .docs-nav-footer {
    flex-direction: column;
    gap: var(--space-lg);
  }

  .docs-nav-footer .docs-nav-next {
    text-align: left;
    margin-left: 0;
  }

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

  .docs-phase {
    grid-template-columns: 60px 1fr;
  }

  .docs-code .terminal-body {
    padding: 16px;
    font-size: 12px;
  }
}