/* Nyxever Docs — layout and components */

/* ── Docs layout (sidebar | content | toc) ── */
:root { --docs-nav-h: calc(var(--layout-topbar-height) + 1px); }  /* fixed header + its border */

.docs-layout {
  display: grid;
  grid-template-columns: 260px 1fr 260px;
  min-height: calc(100vh - var(--docs-nav-h));
  align-items: start;
}

/* ── Sidebar ── */
.docs-sidebar {
  position: sticky;
  top: var(--docs-nav-h);
  height: calc(100vh - var(--docs-nav-h));
  overflow-y: auto;
  background: var(--color-base-ground);
  border-right: 1px solid var(--color-base-border-subtle);
  padding: var(--space-6) 0 var(--space-12);
  scrollbar-width: thin;
  scrollbar-color: var(--color-base-border) transparent;
  display: flex;
  flex-direction: column;
}

.docs-sidebar::-webkit-scrollbar { width: 4px; }
.docs-sidebar::-webkit-scrollbar-track { background: transparent; }
.docs-sidebar::-webkit-scrollbar-thumb { background: var(--color-base-border); border-radius: 2px; }

.docs-search {
  margin: 0 var(--space-4) var(--space-5);
  padding: var(--space-2) var(--space-3);
  border: 1px solid var(--color-base-border);
  border-radius: var(--radius-md);
  background: var(--color-base-surface);
  color: var(--color-text-tertiary);
  font-size: var(--text-body-sm);
  font-family: var(--font-sans);
  outline: none;
  width: calc(100% - var(--space-8));
  transition: border-color var(--motion-duration-fast) var(--motion-ease-out);
}
.docs-search:focus { border-color: var(--color-violet-700); color: var(--color-text-primary); }
.docs-search::placeholder { color: var(--color-text-tertiary); }

/* ── Collapsible nav groups ── */
.docs-nav-group {
  border-bottom: 1px solid var(--color-base-border-subtle);
}

.docs-nav-group-btn {
  display: flex;
  align-items: center;
  justify-content: space-between;
  width: 100%;
  padding: var(--space-3) var(--space-5);
  background: none;
  border: none;
  cursor: pointer;
  font-size: var(--text-overline);
  font-weight: var(--font-weight-semibold);
  letter-spacing: 0.1em;
  text-transform: uppercase;
  color: var(--color-text-tertiary);
  text-align: left;
  transition: color var(--motion-duration-fast) var(--motion-ease-out);
}
.docs-nav-group-btn:hover { color: var(--color-text-secondary); }
.docs-nav-group.is-open .docs-nav-group-btn { color: var(--color-text-secondary); }

.docs-nav-chevron {
  width: 14px;
  height: 14px;
  flex-shrink: 0;
  transition: transform var(--motion-duration-fast) var(--motion-ease-out);
}
.docs-nav-group.is-open .docs-nav-chevron { transform: rotate(180deg); }

/* ── Nav group body (collapsible) ── */
.docs-nav-group-body {
  overflow: hidden;
  max-height: 0;
  transition: max-height 0.25s ease;
}

.docs-nav-group-body ul {
  list-style: none;
  padding: 0 0 var(--space-3);
  margin: 0;
}

/* Base nav items */
.docs-nav-group-body ul a {
  display: block;
  padding: var(--space-1) var(--space-5);
  font-size: var(--text-body-sm);
  color: var(--color-text-secondary);
  text-decoration: none;
  border-left: 2px solid transparent;
  line-height: 1.5;
  transition: color var(--motion-duration-fast) var(--motion-ease-out),
              background var(--motion-duration-fast) var(--motion-ease-out),
              border-left-color var(--motion-duration-fast) var(--motion-ease-out);
}
.docs-nav-group-body ul a:hover { color: var(--color-text-primary); background: var(--color-base-surface); }
.docs-nav-group-body ul a.active { color: var(--color-violet-300); border-left-color: var(--color-violet-500); background: rgba(101,88,214,0.06); }
.docs-nav-group-body ul a.placeholder { opacity: 0.4; cursor: default; pointer-events: none; }

/* Sub-area label (not a link) */
.docs-nav-area {
  display: block;
  padding: var(--space-3) var(--space-5) var(--space-1);
  font-size: 0.65rem;
  font-weight: var(--font-weight-semibold);
  letter-spacing: 0.1em;
  text-transform: uppercase;
  color: var(--color-text-tertiary);
  opacity: 0.7;
  margin-top: var(--space-1);
}

/* Indented items (within a sub-area) */
.docs-nav-group-body ul a.l1 { padding-left: var(--space-8); }
/* Technology items (deepest level) */
.docs-nav-group-body ul a.l2 { padding-left: var(--space-10); font-size: 0.8rem; color: var(--color-text-tertiary); }
.docs-nav-group-body ul a.l2:hover { color: var(--color-text-secondary); }

/* ── Content wrap ── */
.docs-content-wrap {
  min-width: 0;
  display: flex;
  flex-direction: column;
}

/* ── Breadcrumb (inside content column) ── */
.docs-breadcrumb {
  display: flex;
  align-items: center;
  gap: var(--space-2);
  padding: var(--space-4) var(--space-12);
  font-family: var(--font-mono);
  font-size: var(--text-caption);
  color: var(--color-text-tertiary);
  letter-spacing: 0.04em;
  border-bottom: 1px solid var(--color-base-border-subtle);
  background: var(--color-base-ground);
  position: sticky;
  top: var(--docs-nav-h);
  z-index: 5;
}
.docs-breadcrumb a { color: var(--color-text-tertiary); text-decoration: none; transition: color var(--motion-duration-fast) var(--motion-ease-out); }
.docs-breadcrumb a:hover { color: var(--color-text-secondary); }
.docs-breadcrumb-sep { opacity: 0.4; }

/* ── Main content area ── */
.docs-main {
  min-width: 0;
  padding: var(--space-12) var(--space-12) var(--space-24);
  max-width: 860px;
}

/* ── Content typography ── */
.docs-page-title {
  font-size: var(--text-title-xl);
  font-weight: var(--font-weight-bold);
  letter-spacing: -0.03em;
  line-height: 1.1;
  color: var(--color-text-primary);
  margin-bottom: var(--space-3);
}

.docs-page-lead {
  font-size: var(--text-body-lg);
  line-height: 1.65;
  color: var(--color-text-secondary);
  margin-bottom: var(--space-10);
  max-width: 640px;
}

.docs-section {
  margin-bottom: var(--space-16);
  scroll-margin-top: calc(var(--docs-nav-h) + 48px);
}

.docs-section-title {
  font-size: var(--text-title-md);
  font-weight: var(--font-weight-semibold);
  letter-spacing: -0.02em;
  color: var(--color-text-primary);
  margin-bottom: var(--space-5);
  padding-bottom: var(--space-3);
  border-bottom: 1px solid var(--color-base-border-subtle);
}

.docs-section-body {
  font-size: var(--text-body);
  line-height: 1.75;
  color: var(--color-text-secondary);
  margin-bottom: var(--space-5);
  max-width: 680px;
}

/* ── Card grid ── */
.docs-card-grid {
  display: grid;
  grid-template-columns: repeat(2, 1fr);
  gap: var(--space-4);
  margin-top: var(--space-8);
}

.docs-card {
  background: var(--color-base-surface);
  border: 1px solid var(--color-base-border);
  border-radius: var(--radius-lg);
  padding: var(--space-6);
  text-decoration: none;
  display: grid;
  gap: var(--space-2);
  transition: border-color var(--motion-duration-fast) var(--motion-ease-out),
              background var(--motion-duration-fast) var(--motion-ease-out);
}
.docs-card:hover { border-color: var(--color-violet-700); background: var(--color-base-overlay); }
.docs-card-title { font-size: var(--text-body); font-weight: var(--font-weight-semibold); color: var(--color-text-primary); }
.docs-card-desc { font-size: var(--text-body-sm); color: var(--color-text-tertiary); line-height: 1.6; }

/* ── Glossary ── */
.docs-glossary { margin: var(--space-6) 0; }
.docs-glossary dt {
  font-weight: var(--font-weight-semibold);
  font-family: var(--font-mono);
  font-size: 0.85rem;
  color: var(--color-violet-300);
  margin-top: var(--space-6);
}
.docs-glossary dd {
  margin: var(--space-2) 0 0 var(--space-8);
  font-size: var(--text-body-sm);
  color: var(--color-text-secondary);
  line-height: 1.65;
}

/* ── Placeholder badge ── */
.docs-placeholder {
  display: inline-flex;
  align-items: center;
  gap: var(--space-2);
  padding: var(--space-4) var(--space-5);
  background: var(--color-base-surface);
  border: 1px solid var(--color-base-border);
  border-left: 2px solid var(--color-status-warning);
  border-radius: var(--radius-md);
  font-size: var(--text-body-sm);
  color: var(--color-status-warning);
  margin-bottom: var(--space-6);
}

/* ── Callout box ── */
.docs-callout {
  padding: var(--space-5) var(--space-6);
  border: 1px solid var(--color-base-border);
  border-left: 3px solid var(--color-violet-600);
  border-radius: var(--radius-md);
  background: var(--color-base-surface);
  font-size: var(--text-body-sm);
  line-height: 1.7;
  color: var(--color-text-secondary);
  margin: var(--space-6) 0;
}
.docs-callout strong { color: var(--color-text-primary); font-weight: var(--font-weight-semibold); display: block; margin-bottom: var(--space-1); }

/* ── Right panel (TOC + related) ── */
.docs-toc-panel {
  position: sticky;
  top: var(--docs-nav-h);
  height: calc(100vh - var(--docs-nav-h));
  overflow-y: auto;
  padding: var(--space-8) var(--space-5) var(--space-12);
  border-left: 1px solid var(--color-base-border-subtle);
  scrollbar-width: thin;
  scrollbar-color: var(--color-base-border) transparent;
}
.docs-toc-panel::-webkit-scrollbar { width: 4px; }
.docs-toc-panel::-webkit-scrollbar-track { background: transparent; }
.docs-toc-panel::-webkit-scrollbar-thumb { background: var(--color-base-border); border-radius: 2px; }

.docs-toc-label {
  font-size: var(--text-overline);
  font-weight: var(--font-weight-semibold);
  letter-spacing: 0.1em;
  text-transform: uppercase;
  color: var(--color-text-tertiary);
  margin-bottom: var(--space-3);
}

.docs-toc-list {
  list-style: none;
  padding: 0;
  margin: 0 0 var(--space-8);
  display: grid;
  gap: var(--space-1);
}
.docs-toc-list a {
  display: block;
  font-size: var(--text-body-sm);
  color: var(--color-text-tertiary);
  text-decoration: none;
  padding: var(--space-1) 0;
  border-left: 2px solid transparent;
  padding-left: var(--space-3);
  line-height: 1.45;
  transition: color var(--motion-duration-fast) var(--motion-ease-out),
              border-left-color var(--motion-duration-fast) var(--motion-ease-out);
}
.docs-toc-list a:hover { color: var(--color-text-secondary); }
.docs-toc-list a.toc-active { color: var(--color-violet-300); border-left-color: var(--color-violet-600); }

.docs-toc-divider {
  border: none;
  border-top: 1px solid var(--color-base-border-subtle);
  margin: var(--space-6) 0;
}

.docs-related-list {
  list-style: none;
  padding: 0;
  margin: 0;
  display: grid;
  gap: var(--space-2);
}
.docs-related-list a {
  display: block;
  font-size: var(--text-body-sm);
  color: var(--color-text-tertiary);
  text-decoration: none;
  line-height: 1.45;
  transition: color var(--motion-duration-fast) var(--motion-ease-out);
}
.docs-related-list a:hover { color: var(--color-text-secondary); }

/* ── Area divider (sub-area heading within a section page) ── */
.docs-area-divider {
  font-size: var(--text-overline);
  font-weight: var(--font-weight-semibold);
  letter-spacing: 0.12em;
  text-transform: uppercase;
  color: var(--color-violet-400);
  margin: var(--space-16) 0 var(--space-6);
  padding-bottom: var(--space-3);
  border-bottom: 1px solid rgba(101, 88, 214, 0.25);
  scroll-margin-top: calc(var(--docs-nav-h) + 52px);
}

/* ── Technology entry heading (h3 within a sub-area) ── */
.docs-tech-heading {
  font-size: var(--text-body-lg);
  font-weight: var(--font-weight-semibold);
  letter-spacing: -0.01em;
  color: var(--color-text-primary);
  margin: var(--space-8) 0 var(--space-4);
  scroll-margin-top: calc(var(--docs-nav-h) + 52px);
  display: flex;
  align-items: center;
  gap: var(--space-3);
}

.docs-tech-heading::before {
  content: '';
  display: inline-block;
  width: 6px;
  height: 6px;
  border-radius: 50%;
  background: var(--color-violet-500);
  flex-shrink: 0;
}

/* ── Responsive ── */
@media (max-width: 1200px) {
  .docs-layout { grid-template-columns: 260px 1fr; }
  .docs-toc-panel { display: none; }
}

@media (max-width: 900px) {
  .docs-layout { grid-template-columns: 1fr; }
  .docs-sidebar { position: static; height: auto; border-right: none; border-bottom: 1px solid var(--color-base-border-subtle); }
  .docs-breadcrumb { padding: var(--space-3) var(--space-6); position: static; }
  .docs-main { padding: var(--space-8) var(--space-6) var(--space-16); }
  .docs-card-grid { grid-template-columns: 1fr; }
}
