/* ==========================================================================
   Orilyt Documentation — docs.css
   Layout: TOC sidebar card | scrollable content
   Requires tokens.css loaded first.
   ========================================================================== */

/* JetBrains Mono for docs code blocks */
@font-face {
  font-family: 'JetBrains Mono';
  src: url('/assets/fonts/jetbrains-mono/jetbrains-mono-400.woff2') format('woff2');
  font-weight: 400; font-style: normal; font-display: swap;
}
@font-face {
  font-family: 'JetBrains Mono';
  src: url('/assets/fonts/jetbrains-mono/jetbrains-mono-500.woff2') format('woff2');
  font-weight: 500; font-style: normal; font-display: swap;
}

/* ==========================================================================
   DARK TOPBAR OVERRIDES (public/non-logged view only)
   ========================================================================== */

body { background: #f5f7fa; }
body:not(.has-sidebar) { background: var(--navy); }
body:not(.has-sidebar) .topbar { background: var(--navy) !important; border-bottom: 1px solid var(--border-soft); box-shadow: none; }
body:not(.has-sidebar) .topbar .brand-logo--light { display: none !important; }
body:not(.has-sidebar) .topbar .brand-logo--dark  { display: inline !important; }
body:not(.has-sidebar) .topbar, body:not(.has-sidebar) .topbar a, body:not(.has-sidebar) .topbar .nav-item { color: #93B4D8 !important; }
body:not(.has-sidebar) .topbar .nav-item.is-active { color: var(--text-primary) !important; background: rgba(37,99,235,0.08) !important; }
body:not(.has-sidebar) .topbar .nav-item:hover { color: var(--text-primary) !important; background: rgba(255,255,255,0.04) !important; }
body:not(.has-sidebar) .topbar .lang-trigger { background: var(--navy-card) !important; border-color: var(--border) !important; color: var(--text-primary) !important; }
body:not(.has-sidebar) .topbar .lang-trigger:hover { background: var(--navy-card2) !important; border-color: var(--blue) !important; }
body:not(.has-sidebar) .topbar .lang-menu { background: var(--navy-card) !important; border: 1px solid var(--border) !important; box-shadow: 0 10px 25px rgba(0,0,0,.5) !important; }
body:not(.has-sidebar) .topbar .lang-option { color: var(--text-muted) !important; }
body:not(.has-sidebar) .topbar .lang-option:hover,
body:not(.has-sidebar) .topbar .lang-option.is-current { background: var(--blue-dim) !important; color: var(--text-primary) !important; }
body:not(.has-sidebar) .topbar .topbar-user-indicator { background: var(--navy-card) !important; border-color: var(--border) !important; color: var(--text-primary) !important; }
body:not(.has-sidebar) .topbar .topbar-user-indicator:hover { background: var(--navy-card2) !important; border-color: var(--blue) !important; }
body:not(.has-sidebar) .topbar .topbar-user-indicator.is-logged::after { width: 7px !important; height: 7px !important; border-color: var(--navy) !important; box-shadow: 0 0 0 1.5px var(--navy) !important; }
body:not(.has-sidebar) .topbar .topbar-user-menu { background: var(--navy-card) !important; border: 1px solid var(--border) !important; box-shadow: 0 10px 25px rgba(0,0,0,.5) !important; }
body:not(.has-sidebar) .topbar .topbar-user-menu-item,
body:not(.has-sidebar) .topbar .topbar-user-menu-btn { color: var(--text-muted) !important; }
body:not(.has-sidebar) .topbar .topbar-user-menu-item:hover,
body:not(.has-sidebar) .topbar .topbar-user-menu-btn:hover { background: var(--blue-dim) !important; color: var(--text-primary) !important; }
body:not(.has-sidebar) .topbar .topbar-menu-toggle span { background: var(--text-muted) !important; }

/* Dark footer (non-logged only) */
body:not(.has-sidebar) .orilyt-footer { background: var(--navy-mid) !important; border-top-color: var(--border-soft) !important; }
body:not(.has-sidebar) .orilyt-footer-brand { color: var(--text-primary) !important; }
body:not(.has-sidebar) .orilyt-footer-left  { color: var(--text-muted) !important; }
body:not(.has-sidebar) .orilyt-footer-link  { color: var(--text-muted) !important; }
body:not(.has-sidebar) .orilyt-footer-link:hover { color: var(--blue-light) !important; }
body:not(.has-sidebar) .orilyt-footer-sep   { color: var(--text-muted2) !important; }
body:not(.has-sidebar) .orilyt-footer .orilyt-footer-copy { color: var(--text-muted2) !important; }

/* Dark sidebar & content for TOC (non-logged only) */
body:not(.has-sidebar) .docs-sidebar {
  background: var(--navy-mid) !important;
  border: 1px solid var(--border-soft) !important;
  box-shadow: none !important;
}
body:not(.has-sidebar) .docs-nav-label { color: var(--text-muted2) !important; }
body:not(.has-sidebar) .docs-nav-link { color: var(--text-muted) !important; }
body:not(.has-sidebar) .docs-nav-link:hover { color: var(--text-primary) !important; background: rgba(255,255,255,.03) !important; }
body:not(.has-sidebar) .docs-nav-link.active { color: var(--text-primary) !important; background: var(--blue-dim) !important; border-left-color: var(--blue) !important; }
body:not(.has-sidebar) .docs-sidebar::-webkit-scrollbar-thumb { background: rgba(255,255,255,.1); }

body:not(.has-sidebar) .docs-content {
  background: var(--navy-mid) !important;
  border-color: var(--border-soft) !important;
  box-shadow: none !important;
  color: var(--text-secondary, #93B4D8) !important;
}
body:not(.has-sidebar) .doc-title { color: var(--text-primary) !important; }
body:not(.has-sidebar) .doc-lead { color: var(--text-muted) !important; }
body:not(.has-sidebar) .doc-h2, body:not(.has-sidebar) .doc-h3 { color: var(--text-primary) !important; }
body:not(.has-sidebar) .doc-ul li em, body:not(.has-sidebar) .doc-ol li em { color: var(--text-muted2) !important; }

body:not(.has-sidebar) code.inline, body:not(.has-sidebar) .docs-content code {
  background: var(--navy-card) !important; color: var(--blue-light, #3B82F6) !important; border-color: var(--border) !important;
}

body:not(.has-sidebar) .doc-table-wrap { border-color: var(--border) !important; }
body:not(.has-sidebar) table.doc-table th { background: var(--navy-card) !important; color: var(--text-primary) !important; border-color: var(--border) !important; }
body:not(.has-sidebar) table.doc-table td { border-color: var(--border-soft) !important; }

body:not(.has-sidebar) .doc-alert--info { background: rgba(37,99,235,.08) !important; border-color: rgba(37,99,235,.2) !important; color: #93c5fd !important; }
body:not(.has-sidebar) .doc-alert--warn { background: rgba(245,158,11,.08) !important; border-color: rgba(245,158,11,.2) !important; color: #fbbf24 !important; }
body:not(.has-sidebar) .doc-alert--tip { background: rgba(16,185,129,.08) !important; border-color: rgba(16,185,129,.2) !important; color: #6ee7b7 !important; }

body:not(.has-sidebar) .not-logged-banner { background: var(--navy-card) !important; border-color: var(--border) !important; }

body:not(.has-sidebar) .docs-print-btn {
  background: var(--navy-card) !important; border-color: var(--border) !important; color: var(--text-muted) !important;
}
body:not(.has-sidebar) .docs-print-btn:hover {
  color: var(--text-primary) !important; border-color: var(--blue-light) !important; background: var(--blue-dim) !important;
}

/* ==========================================================================
   LAYOUT — 2-column: TOC card | content (scrollable page)
   ========================================================================== */

.docs-shell {
  display: grid;
  grid-template-columns: 240px 1fr;
  gap: 20px;
  max-width: 1100px;
  margin: 0 auto;
  padding: 24px 0;
  align-items: start;
}
/* Public view (topbar + footer): fixed viewport layout, content scrolls inside card */
body:not(.has-sidebar) {
  overflow: hidden;
  height: 100vh;
}
body:not(.has-sidebar) .docs-shell {
  padding-top: 80px;
  height: calc(100vh - 80px);
  overflow: hidden;
}
body:not(.has-sidebar) .docs-sidebar {
  position: static;
  max-height: calc(100vh - 180px);
  overflow-y: auto;
}
body:not(.has-sidebar) .docs-content {
  max-height: calc(100vh - 180px);
  overflow-y: auto;
}

/* Logged view (sidebar): also fixed layout */
body.has-sidebar .docs-shell {
  height: calc(100vh - 20px);
  overflow: hidden;
}
body.has-sidebar .docs-sidebar {
  position: static;
  max-height: calc(100vh - 68px);
  overflow-y: auto;
}
body.has-sidebar .docs-content {
  max-height: calc(100vh - 68px);
  overflow-y: auto;
}

/* ==========================================================================
   LEFT: TABLE OF CONTENTS (light card, sticky)
   ========================================================================== */

.docs-sidebar {
  position: sticky;
  top: 20px;
  background: #fff;
  border: 1px solid rgba(0,0,0,.06);
  border-radius: var(--r-lg);
  box-shadow: 0 1px 4px rgba(0,0,0,.04);
  overflow-y: auto;
  max-height: calc(100vh - 40px);
  padding: 20px 0;
}

.docs-sidebar::-webkit-scrollbar { width: 3px; }
.docs-sidebar::-webkit-scrollbar-track { background: transparent; }
.docs-sidebar::-webkit-scrollbar-thumb { background: rgba(0,0,0,.08); border-radius: 3px; }

.docs-nav-section { margin-bottom: 14px; }
.docs-nav-section:last-child { margin-bottom: 0; }

.docs-nav-label {
  font-size: 0.5625rem;
  font-weight: 700;
  color: var(--text-body-muted);
  text-transform: uppercase;
  letter-spacing: 1.2px;
  padding: 0 16px;
  margin-bottom: 2px;
  font-family: var(--font-body);
}

.docs-nav-link {
  display: block;
  padding: 5px 16px 5px 18px;
  font-size: 0.8125rem;
  font-weight: 500;
  color: var(--text-body-muted);
  text-decoration: none;
  border-left: 2px solid transparent;
  transition: all .15s;
  font-family: var(--font-body);
  cursor: pointer;
  line-height: 1.4;
}
.docs-nav-link:hover {
  color: var(--text-body);
  background: rgba(0,0,0,.03);
}
.docs-nav-link.active {
  color: var(--blue);
  background: rgba(37,99,235,.05);
  border-left-color: var(--blue);
  font-weight: 600;
}

.docs-nav-link .nav-text { white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }

/* ==========================================================================
   MAIN CONTENT AREA (all sections visible, scrollable page)
   ========================================================================== */

.docs-content {
  background: #fff;
  border: 1px solid rgba(0,0,0,.06);
  border-radius: var(--r-lg);
  box-shadow: 0 1px 4px rgba(0,0,0,.04);
  padding: 36px 44px 48px;
  font-family: var(--font-body);
  font-size: 1rem;
  line-height: 1.75;
  color: var(--text-body);
  min-width: 0;
}

/* All sections visible — no tab switching */
.doc-section {
  display: block;
  margin-bottom: 48px;
  scroll-margin-top: 20px;
}
.doc-section:last-child {
  margin-bottom: 0;
}

/* Hide prev/next pagination */
.docs-pagination { display: none; }

/* ---------- Typography ---------- */
.doc-title {
  font-family: var(--font-body);
  font-size: 1.75rem;
  font-weight: 700;
  color: var(--navy);
  letter-spacing: -0.3px;
  margin: 0 0 12px;
  line-height: 1.25;
}
.doc-lead {
  font-size: 1.0625rem;
  color: var(--text-body-mid);
  line-height: 1.65;
  margin: 0 0 28px;
}
.doc-h2 {
  font-family: var(--font-body);
  font-size: 1.25rem;
  font-weight: 700;
  color: var(--text-body);
  margin: 40px 0 14px;
  scroll-margin-top: 24px;
}
.doc-section .doc-h2:first-of-type {
  margin-top: 0;
}
.doc-h3 {
  font-size: 1.125rem;
  font-weight: 600;
  color: var(--text-body);
  margin: 28px 0 10px;
  scroll-margin-top: 24px;
}
.doc-p {
  margin: 0 0 16px;
  line-height: 1.75;
}
.doc-a {
  color: var(--blue);
  text-decoration: underline;
  text-underline-offset: 2px;
  cursor: pointer;
}
.doc-a:hover { color: var(--blue-light); }

.doc-ul, .doc-ol {
  padding-left: 1.4em;
  margin: 0 0 16px;
  line-height: 1.75;
}
.doc-ul li, .doc-ol li {
  margin-bottom: 6px;
}
.doc-ul { list-style-type: disc; }
.doc-ol { list-style-type: decimal; }

.doc-ul li em, .doc-ol li em {
  color: var(--text-body-muted);
  font-style: italic;
}

/* ==========================================================================
   INLINE CODE
   ========================================================================== */

code.inline,
.docs-content code {
  font-family: var(--font-mono);
  font-size: 0.8125rem;
  background: #F0F4FF;
  color: #2563EB;
  padding: 2px 6px;
  border-radius: 4px;
  border: 1px solid rgba(37,99,235,.1);
}

/* ==========================================================================
   CODE BLOCKS
   ========================================================================== */

.code-block {
  background: #0F172A;
  color: #E2E8F0;
  border-radius: var(--r-md);
  padding: 16px 20px;
  margin: 16px 0 20px;
  overflow-x: auto;
  border: 1px solid rgba(0,0,0,.1);
}
.code-block code {
  font-family: var(--font-mono) !important;
  font-size: 0.8125rem;
  line-height: 1.7;
  color: #E2E8F0 !important;
  background: none !important;
  border: none !important;
  padding: 0 !important;
}
.code-block .code-label {
  display: block;
  font-size: 0.625rem;
  color: #64748B;
  text-transform: uppercase;
  letter-spacing: 0.8px;
  margin-bottom: 8px;
  font-family: var(--font-body);
  font-weight: 600;
}

/* ==========================================================================
   ALERTS / CALLOUTS
   ========================================================================== */

.doc-alert {
  border-radius: var(--r-md);
  padding: 14px 16px;
  font-size: 0.875rem;
  line-height: 1.55;
  display: flex;
  gap: 10px;
  align-items: flex-start;
  margin: 16px 0;
}
.doc-alert p { margin: 0; }
.alert-icon { flex-shrink: 0; margin-top: 1px; }
.alert-icon svg { width: 16px; height: 16px; }

.doc-alert--info {
  background: #EFF6FF;
  border: 1px solid rgba(37,99,235,.1);
  color: #1E3A5F;
}
.doc-alert--info .alert-icon { color: #2563EB; }

.doc-alert--warn {
  background: #FFFBEB;
  border: 1px solid rgba(245,158,11,.15);
  color: #78350F;
}
.doc-alert--warn .alert-icon { color: #D97706; }

.doc-alert--tip {
  background: #ECFDF5;
  border: 1px solid rgba(16,185,129,.12);
  color: #064E3B;
}
.doc-alert--tip .alert-icon { color: #10B981; }

/* ==========================================================================
   TABLES
   ========================================================================== */

.doc-table-wrap {
  overflow-x: auto;
  margin: 16px 0 20px;
  border: 1px solid rgba(0,0,0,.08);
  border-radius: var(--r-md);
}
table.doc-table {
  width: 100%;
  border-collapse: collapse;
  font-size: 0.875rem;
  line-height: 1.5;
}
table.doc-table th {
  text-align: left;
  padding: 10px 14px;
  font-weight: 600;
  color: var(--text-body);
  border-bottom: 1px solid rgba(0,0,0,.08);
  background: var(--bg-light-alt);
  white-space: nowrap;
}
table.doc-table td {
  padding: 10px 14px;
  border-bottom: 1px solid rgba(0,0,0,.04);
  vertical-align: top;
}
table.doc-table tbody tr:last-child td { border-bottom: 0; }
table.doc-table code { font-size: 0.75rem; }

/* ==========================================================================
   NOT-LOGGED BANNER
   ========================================================================== */

.not-logged-banner {
  background: var(--bg-light-alt);
  border: 1px solid rgba(0,0,0,.06);
  border-radius: var(--r-md);
  padding: 20px 24px;
  margin: 24px 0;
}
.btn-docs-cta {
  display: inline-block;
  padding: 10px 24px;
  border-radius: var(--r-md);
  font-weight: 600;
  font-size: 0.875rem;
  text-decoration: none;
  background: var(--blue);
  color: #fff;
  transition: background .15s;
}
.btn-docs-cta:hover { background: var(--blue-light); }
.btn-group { display: flex; gap: 10px; }

/* ==========================================================================
   RESPONSIVE
   ========================================================================== */

@media (max-width: 900px) {
  .docs-shell {
    grid-template-columns: 1fr;
    padding: 16px 0;
  }
  .docs-sidebar {
    position: static;
    max-height: none;
    border-radius: var(--r-md);
  }
  .docs-content { padding: 24px 24px 32px; }
  .doc-title { font-size: 1.5rem; }
  .doc-h2 { font-size: 1.125rem; margin-top: 28px; }
  .doc-h3 { font-size: 1rem; }
  .code-block { padding: 12px 14px; }
  .code-block code { white-space: pre-wrap; word-break: break-all; font-size: 0.75rem; }
  .doc-table-wrap { margin: 12px -16px; border-radius: 0; border-left: none; border-right: none; }
  table.doc-table { font-size: 0.8125rem; }
  table.doc-table th, table.doc-table td { padding: 8px 10px; }
  .not-logged-banner .btn-group { flex-direction: column; }
}

/* Print button (reuses blog-print-btn from blog-article.css) */
.docs-print-btn {
  display: inline-flex;
  align-items: center;
  justify-content: center;
  width: 32px;
  height: 32px;
  border-radius: var(--r-md);
  background: var(--navy-card);
  border: 1px solid var(--border);
  color: var(--text-muted);
  cursor: pointer;
  transition: all .15s;
}
.docs-print-btn:hover {
  color: var(--text-primary);
  border-color: var(--blue-light, #3B82F6);
  background: var(--blue-dim);
}

/* ==========================================================================
   PRINT — white background, TOC at top
   ========================================================================== */

@media print {
  body { background: #fff !important; color: #1a1a2e !important; overflow: visible !important; height: auto !important; }

  .topbar, .app-sidebar, .orilyt-footer, .not-logged-banner,
  .docs-print-btn, .blog-print-btn, .btn-docs-cta, .btn-group { display: none !important; }

  .docs-shell {
    display: block !important;
    max-width: 100% !important;
    padding: 0 !important;
    height: auto !important;
    overflow: visible !important;
  }

  /* Hide TOC sidebar in print */
  .docs-sidebar { display: none !important; }

  /* Content area */
  .docs-content {
    background: #fff !important;
    border: none !important;
    box-shadow: none !important;
    padding: 0 !important;
    max-height: none !important;
    overflow: visible !important;
  }

  .doc-title { color: #1a1a2e !important; }
  .doc-lead { color: #374151 !important; }
  .doc-h2, .doc-h3 { color: #1a1a2e !important; }
  .doc-p, .doc-ul li, .doc-ol li { color: #374151 !important; }
  .doc-ul li em, .doc-ol li em { color: #4b5563 !important; font-style: italic; }
  .doc-a { color: #2563eb !important; }

  code.inline, .docs-content code {
    background: #f0f4ff !important; color: #2563eb !important; border-color: rgba(37,99,235,.15) !important;
  }
  .code-block { background: #0f172a !important; border-color: rgba(0,0,0,.1) !important; }
  .code-block code { color: #e2e8f0 !important; }

  .doc-alert--info { background: #eff6ff !important; border-color: rgba(37,99,235,.1) !important; color: #1e3a5f !important; }
  .doc-alert--warn { background: #fffbeb !important; border-color: rgba(245,158,11,.15) !important; color: #78350f !important; }
  .doc-alert--tip { background: #ecfdf5 !important; border-color: rgba(16,185,129,.12) !important; color: #064e3b !important; }

  .doc-table-wrap { border-color: rgba(0,0,0,.08) !important; }
  table.doc-table th { background: #f8faff !important; color: #1a1a2e !important; border-color: rgba(0,0,0,.08) !important; }
  table.doc-table td { color: #374151 !important; border-color: rgba(0,0,0,.04) !important; }

  .doc-section { page-break-inside: avoid; }
}