/* ==========================================================================
   Orchestra Docs — layout + rendered-markdown typography.
   Design tokens, reset, and base come from ../styles.css.
   ========================================================================== */

:root {
  --docs-topbar-h: 3.5rem;
  --docs-sidebar-w: 264px;
  --docs-toc-w: 200px;
  --docs-content-max: 760px;
}

body.docs {
  background: var(--color-bg);
}

/* --------------------------------------------------------------------------
   Top bar
   -------------------------------------------------------------------------- */

.docs-topbar {
  position: sticky;
  top: 0;
  z-index: 40;
  height: var(--docs-topbar-h);
  display: flex;
  align-items: center;
  justify-content: space-between;
  gap: var(--space-4);
  padding: 0 var(--space-5);
  background: color-mix(in srgb, var(--color-bg) 88%, transparent);
  backdrop-filter: blur(12px);
  border-bottom: 1px solid var(--color-border);
}

.docs-topbar__left,
.docs-topbar__right {
  display: flex;
  align-items: center;
  gap: var(--space-4);
}

.docs-wordmark {
  display: flex;
  align-items: center;
  gap: var(--space-2);
  font-family: var(--font-display);
  font-weight: 600;
  font-size: var(--text-lg);
  color: var(--color-text);
  text-decoration: none;
}

.docs-logo-mark {
  width: 24px;
  height: 24px;
  color: var(--color-accent);
}

.docs-wordmark__tag {
  font-family: var(--font-mono);
  font-size: 11px;
  font-weight: 500;
  color: var(--color-text-faint);
  border: 1px solid var(--color-border);
  border-radius: var(--radius-full);
  padding: 1px 8px;
  margin-left: var(--space-1);
}

.docs-topbar__link {
  font-size: var(--text-sm);
  color: var(--color-text-muted);
  text-decoration: none;
  transition: color var(--duration-fast);
}

.docs-topbar__link:hover {
  color: var(--color-text);
}

.docs-theme-toggle {
  display: inline-flex;
  align-items: center;
  justify-content: center;
  width: 34px;
  height: 34px;
  border-radius: var(--radius-sm);
  border: 1px solid var(--color-border);
  background: transparent;
  color: var(--color-text-muted);
  cursor: pointer;
  transition: all var(--duration-fast);
}

.docs-theme-toggle:hover {
  color: var(--color-text);
  border-color: var(--color-border-strong);
}

.docs-theme-toggle svg {
  width: 16px;
  height: 16px;
}

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

.docs-topbar__menu {
  display: none;
  align-items: center;
  justify-content: center;
  width: 34px;
  height: 34px;
  border-radius: var(--radius-sm);
  border: 1px solid var(--color-border);
  background: transparent;
  color: var(--color-text);
  cursor: pointer;
}

/* --------------------------------------------------------------------------
   Shell: sidebar | content | toc
   -------------------------------------------------------------------------- */

.docs-shell {
  max-width: 1400px;
  margin: 0 auto;
  display: grid;
  grid-template-columns: var(--docs-sidebar-w) minmax(0, 1fr);
  align-items: start;
}

/* --------------------------------------------------------------------------
   Sidebar
   -------------------------------------------------------------------------- */

.docs-sidebar {
  position: sticky;
  top: var(--docs-topbar-h);
  height: calc(100vh - var(--docs-topbar-h));
  overflow-y: auto;
  padding: var(--space-6) var(--space-4) var(--space-10);
  border-right: 1px solid var(--color-border);
}

.docs-nav__group + .docs-nav__group {
  margin-top: var(--space-6);
}

.docs-nav__group-title {
  font-family: var(--font-mono);
  font-size: 10px;
  text-transform: uppercase;
  letter-spacing: 0.08em;
  color: var(--color-text-faint);
  padding: 0 var(--space-3);
  margin-bottom: var(--space-2);
}

.docs-nav__link {
  display: block;
  padding: var(--space-2) var(--space-3);
  border-radius: var(--radius-sm);
  font-size: var(--text-sm);
  color: var(--color-text-muted);
  text-decoration: none;
  border-left: 2px solid transparent;
  transition: all var(--duration-fast);
}

.docs-nav__link:hover {
  color: var(--color-text);
  background: var(--color-bg-subtle);
}

.docs-nav__link.is-active {
  color: var(--color-accent-hover);
  background: var(--color-accent-muted);
  border-left-color: var(--color-accent);
  font-weight: 500;
}

.docs-sidebar__backdrop {
  display: none;
}

/* --------------------------------------------------------------------------
   Main + content column
   -------------------------------------------------------------------------- */

.docs-main {
  display: grid;
  grid-template-columns: minmax(0, 1fr) var(--docs-toc-w);
  gap: var(--space-8);
  padding: var(--space-10) var(--space-8) var(--space-24);
}

.docs-content {
  max-width: var(--docs-content-max);
  min-width: 0;
  width: 100%;
}

.docs-loading {
  color: var(--color-text-faint);
  font-family: var(--font-mono);
  font-size: var(--text-sm);
}

/* --------------------------------------------------------------------------
   On-this-page TOC
   -------------------------------------------------------------------------- */

.docs-toc {
  position: sticky;
  top: calc(var(--docs-topbar-h) + var(--space-10));
  align-self: start;
  max-height: calc(100vh - var(--docs-topbar-h) - var(--space-16));
  overflow-y: auto;
  font-size: var(--text-xs);
}

.docs-toc__title {
  font-family: var(--font-mono);
  font-size: 10px;
  text-transform: uppercase;
  letter-spacing: 0.08em;
  color: var(--color-text-faint);
  margin-bottom: var(--space-3);
}

.docs-toc__link {
  display: block;
  padding: var(--space-1) 0 var(--space-1) var(--space-3);
  border-left: 2px solid var(--color-border);
  color: var(--color-text-faint);
  text-decoration: none;
  line-height: 1.4;
  transition: all var(--duration-fast);
}

.docs-toc__link--h3 {
  padding-left: var(--space-5);
}

.docs-toc__link:hover {
  color: var(--color-text);
}

.docs-toc__link.is-active {
  color: var(--color-accent-hover);
  border-left-color: var(--color-accent);
}

/* --------------------------------------------------------------------------
   Rendered markdown typography
   -------------------------------------------------------------------------- */

.docs-content h1 {
  font-size: var(--text-4xl);
  line-height: 1.15;
  letter-spacing: -0.02em;
  margin-bottom: var(--space-4);
}

.docs-content h2 {
  font-size: var(--text-2xl);
  letter-spacing: -0.01em;
  margin-top: var(--space-12);
  margin-bottom: var(--space-4);
  padding-top: var(--space-2);
  scroll-margin-top: calc(var(--docs-topbar-h) + var(--space-4));
}

.docs-content h3 {
  font-size: var(--text-lg);
  margin-top: var(--space-8);
  margin-bottom: var(--space-3);
  scroll-margin-top: calc(var(--docs-topbar-h) + var(--space-4));
}

.docs-content p,
.docs-content ul,
.docs-content ol {
  color: var(--color-text-muted);
  line-height: 1.7;
  margin-bottom: var(--space-4);
}

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

.docs-content ul,
.docs-content ol {
  padding-left: var(--space-6);
}

.docs-content a {
  color: var(--color-accent-hover);
  text-decoration: none;
  border-bottom: 1px solid transparent;
  transition: border-color var(--duration-fast);
}

.docs-content a:hover {
  border-bottom-color: var(--color-accent-hover);
}

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

.docs-content hr {
  border: none;
  border-top: 1px solid var(--color-border);
  margin: var(--space-10) 0;
}

/* Inline code */
.docs-content :not(pre) > code {
  font-family: var(--font-mono);
  font-size: 0.85em;
  background: var(--color-bg-subtle);
  border: 1px solid var(--color-border);
  border-radius: var(--radius-sm);
  padding: 0.1em 0.4em;
  color: var(--color-text);
}

/* Code blocks */
.docs-content pre {
  position: relative;
  background: var(--color-bg-code);
  border: 1px solid var(--color-border);
  border-radius: var(--radius-md);
  padding: var(--space-4) var(--space-5);
  overflow-x: auto;
  margin-bottom: var(--space-5);
}

.docs-content pre code {
  font-family: var(--font-mono);
  font-size: var(--text-sm);
  line-height: 1.6;
  color: var(--color-text);
  white-space: pre;
}

.docs-copy-btn {
  position: absolute;
  top: var(--space-2);
  right: var(--space-2);
  font-family: var(--font-mono);
  font-size: 10px;
  padding: 3px 8px;
  border-radius: var(--radius-sm);
  border: 1px solid var(--color-border);
  background: var(--color-bg-subtle);
  color: var(--color-text-muted);
  cursor: pointer;
  opacity: 0;
  transition: opacity var(--duration-fast), color var(--duration-fast);
}

.docs-content pre:hover .docs-copy-btn {
  opacity: 1;
}

.docs-copy-btn:hover {
  color: var(--color-text);
}

.docs-copy-btn.is-copied {
  color: var(--color-pass);
  border-color: var(--color-pass);
}

/* Blockquotes → callouts */
.docs-content blockquote {
  border-left: 3px solid var(--color-accent);
  background: var(--color-accent-muted);
  border-radius: var(--radius-sm);
  padding: var(--space-3) var(--space-4);
  margin-bottom: var(--space-5);
}

.docs-content blockquote p {
  margin-bottom: 0;
  color: var(--color-text);
}

/* Tables */
.docs-content table {
  width: 100%;
  border-collapse: collapse;
  margin-bottom: var(--space-6);
  font-size: var(--text-sm);
}

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

.docs-content th {
  color: var(--color-text);
  font-weight: 600;
  border-bottom-color: var(--color-border-strong);
}

.docs-content td {
  color: var(--color-text-muted);
}

.docs-content td code {
  white-space: nowrap;
}

/* Prev / next footer nav */
.docs-pager {
  display: flex;
  justify-content: space-between;
  gap: var(--space-4);
  margin-top: var(--space-16);
  padding-top: var(--space-6);
  border-top: 1px solid var(--color-border);
}

.docs-pager__link {
  display: flex;
  flex-direction: column;
  gap: 2px;
  padding: var(--space-3) var(--space-4);
  border: 1px solid var(--color-border);
  border-radius: var(--radius-md);
  text-decoration: none;
  max-width: 48%;
  transition: border-color var(--duration-fast);
}

.docs-pager__link:hover {
  border-color: var(--color-accent);
}

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

.docs-pager__dir {
  font-family: var(--font-mono);
  font-size: 10px;
  text-transform: uppercase;
  letter-spacing: 0.06em;
  color: var(--color-text-faint);
}

.docs-pager__title {
  font-size: var(--text-sm);
  color: var(--color-text);
  font-weight: 500;
}

/* --------------------------------------------------------------------------
   Responsive
   -------------------------------------------------------------------------- */

@media (max-width: 1080px) {
  .docs-main {
    grid-template-columns: minmax(0, 1fr);
  }
  .docs-toc {
    display: none;
  }
}

@media (max-width: 768px) {
  .docs-shell {
    grid-template-columns: minmax(0, 1fr);
  }
  .docs-topbar__menu {
    display: inline-flex;
  }
  .docs-main {
    padding: var(--space-6) var(--space-5) var(--space-16);
  }

  .docs-sidebar {
    position: fixed;
    top: 0;
    left: 0;
    z-index: 60;
    width: 280px;
    height: 100vh;
    background: var(--color-bg-elevated);
    padding-top: var(--space-6);
    transform: translateX(-100%);
    transition: transform var(--duration-normal) var(--ease-out);
  }
  .docs-sidebar.is-open {
    transform: translateX(0);
  }
  .docs-sidebar__backdrop {
    display: block;
    position: fixed;
    inset: 0;
    z-index: 55;
    background: rgba(0, 0, 0, 0.5);
  }
  .docs-topbar__right .docs-topbar__link {
    display: none;
  }
}

@media (prefers-reduced-motion: reduce) {
  .docs-sidebar {
    transition: none;
  }
}