/* ─────────────────────────────────────────────────────────────
   docs.css — Documentation layout and typography
───────────────────────────────────────────────────────────── */

body { padding-top: var(--nav-h); }

/* ── Layout shell ────────────────────────────────────────── */
.docs-shell {
  display: flex;
  min-height: calc(100vh - var(--nav-h));
}

/* ── Left sidebar ────────────────────────────────────────── */
.docs-sidebar {
  position: fixed;
  top: var(--nav-h);
  left: 0;
  bottom: 0;
  width: var(--sidebar-w);
  overflow-y: auto;
  background: var(--bg-2);
  border-right: 1px solid var(--border-1);
  display: flex;
  flex-direction: column;
  z-index: 50;
}
.docs-sidebar::-webkit-scrollbar { width: 4px; }
.docs-sidebar::-webkit-scrollbar-thumb { background: rgba(255,255,255,0.08); }

.sidebar-search-wrap {
  padding: 16px 14px 12px;
  border-bottom: 1px solid var(--border-1);
  flex-shrink: 0;
}
.sidebar-search-btn {
  display: flex;
  align-items: center;
  gap: 8px;
  width: 100%;
  padding: 8px 12px;
  background: rgba(255,255,255,0.04);
  border: 1px solid var(--border-1);
  border-radius: var(--r-sm);
  color: var(--text-3);
  font-size: var(--text-xs);
  font-weight: 500;
  cursor: pointer;
  transition: all var(--t-fast);
  text-align: left;
}
.sidebar-search-btn:hover {
  border-color: var(--border-2);
  color: var(--text-2);
  background: rgba(255,255,255,0.06);
}
.sidebar-search-btn svg { flex-shrink: 0; opacity: 0.6; }
.sidebar-search-kbd {
  margin-left: auto;
  font-size: 10px;
  background: rgba(255,255,255,0.06);
  border: 1px solid var(--border-1);
  border-radius: 4px;
  padding: 1px 6px;
  font-family: var(--font-mono);
  color: var(--text-4);
}

.sidebar-nav { padding: 12px 0 24px; flex: 1; }

.sidebar-group { margin-bottom: 4px; }
.sidebar-group-label {
  padding: 8px 16px 4px;
  font-size: 10px;
  font-weight: 700;
  letter-spacing: 0.14em;
  text-transform: uppercase;
  color: var(--text-4);
}
.sidebar-link {
  display: flex;
  align-items: center;
  gap: 8px;
  padding: 6px 16px 6px 20px;
  font-size: var(--text-sm);
  font-weight: 500;
  color: var(--text-2);
  border-left: 2px solid transparent;
  transition: all var(--t-fast);
  cursor: pointer;
  text-decoration: none;
  line-height: 1.4;
}
.sidebar-link:hover {
  color: var(--text-1);
  background: rgba(255,255,255,0.035);
}
.sidebar-link.is-active {
  color: var(--accent);
  background: var(--accent-dim);
  border-left-color: var(--accent);
  font-weight: 600;
}
.sidebar-link-icon {
  display: flex;
  align-items: center;
  justify-content: center;
  flex-shrink: 0;
  width: 18px;
  height: 18px;
}
.sidebar-link-icon svg {
  width: 15px;
  height: 15px;
  display: block;
  overflow: visible;
  transition: transform 0.12s ease;
}

/* ── Duotone icon layers ─────────────────────────────────── */
.sidebar-link-icon .icon-bg {
  fill: rgba(255,255,255,0.045);
  transition: fill 0.22s ease;
}
/* line elements used as bg (e.g. slider tracks in bg) */
.sidebar-link-icon line.icon-bg {
  fill: none;
  stroke: var(--text-4);
  stroke-width: 1.5;
  stroke-linecap: round;
  transition: stroke 0.22s ease;
}
.sidebar-link-icon .icon-fg {
  fill: none;
  stroke: var(--text-3);
  stroke-width: 1.5;
  stroke-linecap: round;
  stroke-linejoin: round;
  transition: stroke 0.22s ease, fill 0.22s ease;
}
.sidebar-link-icon .icon-dot {
  fill: var(--text-4);
  stroke: none;
  transition: fill 0.22s ease;
}

/* Hover */
.sidebar-link:hover .sidebar-link-icon .icon-bg      { fill: rgba(180,255,201,0.07); }
.sidebar-link:hover .sidebar-link-icon line.icon-bg  { stroke: var(--text-3); }
.sidebar-link:hover .sidebar-link-icon .icon-fg      { stroke: var(--text-2); }
.sidebar-link:hover .sidebar-link-icon .icon-dot     { fill: var(--text-3); }

/* Active */
.sidebar-link.is-active .sidebar-link-icon .icon-bg     { fill: rgba(180,255,201,0.13); }
.sidebar-link.is-active .sidebar-link-icon line.icon-bg { stroke: rgba(180,255,201,0.35); }
.sidebar-link.is-active .sidebar-link-icon .icon-fg     { stroke: var(--accent); }
.sidebar-link.is-active .sidebar-link-icon .icon-dot    { fill: var(--accent); }

/* Active entry animation — fires when page loads with is-active set */
.sidebar-link.is-active .sidebar-link-icon svg {
  animation: icon-activate 0.38s cubic-bezier(0.34,1.56,0.64,1) 0.08s backwards;
}
@keyframes icon-activate {
  from { transform: scale(0.65); opacity: 0.3; }
  to   { transform: scale(1);    opacity: 1;   }
}

/* Click press */
.sidebar-link:active .sidebar-link-icon svg { transform: scale(0.85); }

/* ── Main content area ───────────────────────────────────── */
.docs-main {
  margin-left: var(--sidebar-w);
  margin-right: var(--toc-w);
  min-width: 0;
  flex: 1;
  padding: 48px 56px 96px;
}

/* ── Right TOC ───────────────────────────────────────────── */
.docs-toc {
  position: fixed;
  top: var(--nav-h);
  right: 0;
  bottom: 0;
  width: var(--toc-w);
  overflow-y: auto;
  padding: 32px 20px 32px 16px;
  border-left: 1px solid var(--border-1);
}
.docs-toc::-webkit-scrollbar { width: 4px; }
.docs-toc-label {
  font-size: 10px;
  font-weight: 700;
  letter-spacing: 0.14em;
  text-transform: uppercase;
  color: var(--text-4);
  margin-bottom: 12px;
  padding-left: 8px;
}
.toc-link {
  display: block;
  font-size: 12.5px;
  color: var(--text-3);
  padding: 4px 8px;
  border-left: 2px solid transparent;
  border-radius: 0 var(--r-sm) var(--r-sm) 0;
  transition: all var(--t-fast);
  line-height: 1.4;
  text-decoration: none;
}
.toc-link:hover { color: var(--text-1); }
.toc-link.is-active {
  color: var(--accent);
  border-left-color: var(--accent);
  background: var(--accent-dim);
}
.toc-link.toc-h3 { padding-left: 18px; font-size: 12px; }

/* ── Breadcrumb ──────────────────────────────────────────── */
.docs-breadcrumb {
  display: flex;
  align-items: center;
  gap: 6px;
  font-size: var(--text-xs);
  color: var(--text-3);
  margin-bottom: var(--space-6);
}
.docs-breadcrumb a { color: var(--text-3); transition: color var(--t-fast); }
.docs-breadcrumb a:hover { color: var(--text-1); }
.docs-breadcrumb-sep { opacity: 0.4; }
.docs-breadcrumb-cur { color: var(--text-2); }

/* ── Content typography ──────────────────────────────────── */
.doc-body h1 {
  font-size: clamp(var(--text-2xl), 3vw, 2.25rem);
  font-weight: 800;
  line-height: 1.15;
  letter-spacing: -0.025em;
  margin-bottom: var(--space-3);
}
.doc-lead {
  font-size: var(--text-md);
  color: var(--text-2);
  line-height: 1.75;
  margin-bottom: var(--space-10);
  padding-bottom: var(--space-8);
  border-bottom: 1px solid var(--border-1);
}
.doc-body h2 {
  font-size: var(--text-xl);
  font-weight: 700;
  margin: var(--space-12) 0 var(--space-4);
  padding-bottom: var(--space-3);
  border-bottom: 1px solid var(--border-1);
  scroll-margin-top: calc(var(--nav-h) + 20px);
  line-height: 1.25;
}
.doc-body h3 {
  font-size: var(--text-lg);
  font-weight: 700;
  margin: var(--space-8) 0 var(--space-3);
  color: var(--text-1);
  scroll-margin-top: calc(var(--nav-h) + 20px);
}
.doc-body h4 {
  font-size: var(--text-base);
  font-weight: 700;
  margin: var(--space-6) 0 var(--space-2);
  color: var(--text-2);
  text-transform: uppercase;
  letter-spacing: 0.06em;
  font-size: var(--text-xs);
}
.doc-body p {
  font-size: var(--text-base);
  color: var(--text-2);
  line-height: 1.82;
  margin-bottom: var(--space-4);
}
.doc-body strong { color: var(--text-1); font-weight: 700; }
.doc-body a:not(.btn) {
  color: var(--accent);
  border-bottom: 1px solid var(--accent-border);
  transition: border-color var(--t-fast);
}
.doc-body a:not(.btn):hover { border-bottom-color: var(--accent); }

.doc-body ul:not(.docs-list-plain), .doc-body ol { margin: var(--space-2) 0 var(--space-5) var(--space-5); }
.doc-body ul:not(.docs-list-plain) li {
  font-size: var(--text-base);
  color: var(--text-2);
  padding: 3px 0;
  line-height: 1.72;
  position: relative;
  list-style: none;
  padding-left: var(--space-4);
}
.doc-body ul:not(.docs-list-plain) li::before {
  content: '';
  position: absolute;
  left: 0; top: 11px;
  width: 5px; height: 5px;
  border-radius: 50%;
  background: var(--accent);
  opacity: 0.5;
}
.doc-body ol li {
  font-size: var(--text-base);
  color: var(--text-2);
  padding: 3px 0;
  line-height: 1.72;
  list-style: decimal;
}

/* ── Inline code ─────────────────────────────────────────── */
.doc-body code:not(pre code) {
  font-family: var(--font-mono);
  font-size: 12px;
  background: rgba(180,255,201,0.07);
  color: var(--accent);
  padding: 2px 6px;
  border-radius: 4px;
  border: 1px solid rgba(180,255,201,0.13);
}

/* ── Code block ──────────────────────────────────────────── */
.doc-body pre {
  background: var(--bg-3);
  border: 1px solid var(--border-1);
  border-radius: var(--r-md);
  padding: var(--space-5);
  overflow-x: auto;
  margin: var(--space-4) 0 var(--space-6);
  font-size: 13px;
  line-height: 1.7;
  font-family: var(--font-mono);
  color: var(--text-2);
}

/* ── Callout boxes ───────────────────────────────────────── */
.callout {
  display: flex;
  gap: 12px;
  padding: 14px 18px;
  border-radius: var(--r-md);
  margin: var(--space-5) 0;
  font-size: var(--text-sm);
  line-height: 1.7;
  border-left: 3px solid;
}
.callout-icon { font-size: 16px; flex-shrink: 0; margin-top: 1px; }
.callout-body { flex: 1; }
.callout-body strong { display: block; margin-bottom: 2px; }
.callout-body p { margin: 0; font-size: var(--text-sm); }

.callout.tip     { background: rgba(180,255,201,0.06); border-color: var(--accent); color: var(--accent); }
.callout.info    { background: var(--info-bg);    border-color: var(--info);    color: var(--info); }
.callout.warning { background: var(--warning-bg); border-color: var(--warning); color: var(--warning); }
.callout.danger  { background: var(--danger-bg);  border-color: var(--danger);  color: var(--danger); }

/* ── Tables ──────────────────────────────────────────────── */
.doc-table-wrap { overflow-x: auto; margin: var(--space-3) 0 var(--space-6); }
.doc-table {
  width: 100%;
  border-collapse: collapse;
  font-size: var(--text-sm);
}
.doc-table th {
  text-align: left;
  padding: 9px 14px;
  background: rgba(255,255,255,0.04);
  color: var(--text-3);
  font-size: 10px;
  font-weight: 700;
  letter-spacing: 0.1em;
  text-transform: uppercase;
  border-bottom: 1px solid var(--border-2);
  white-space: nowrap;
}
.doc-table td {
  padding: 10px 14px;
  border-bottom: 1px solid var(--border-1);
  color: var(--text-2);
  vertical-align: top;
  line-height: 1.6;
}
.doc-table td:first-child { color: var(--text-1); font-weight: 600; }
.doc-table tr:last-child td { border-bottom: none; }
.doc-table tr:hover td { background: rgba(255,255,255,0.02); }

/* ── Property / param blocks ─────────────────────────────── */
.prop-list { display: flex; flex-direction: column; gap: 8px; margin: var(--space-3) 0 var(--space-6); }
.prop-item {
  padding: 14px 16px;
  background: rgba(255,255,255,0.025);
  border: 1px solid var(--border-1);
  border-radius: var(--r-md);
  transition: border-color var(--t-fast);
}
.prop-item:hover { border-color: var(--border-2); }
.prop-item-head {
  display: flex;
  align-items: center;
  gap: 8px;
  flex-wrap: wrap;
  margin-bottom: 6px;
}
.prop-name {
  font-size: var(--text-sm);
  font-weight: 700;
  color: var(--text-1);
  font-family: var(--font-mono);
}
.prop-type {
  font-size: var(--text-xs);
  font-weight: 600;
  color: var(--accent);
  background: var(--accent-dim);
  padding: 1px 7px;
  border-radius: 4px;
  font-family: var(--font-mono);
}
.prop-required { font-size: 10px; font-weight: 700; color: var(--danger); background: var(--danger-bg); padding: 1px 7px; border-radius: 4px; }
.prop-optional { font-size: 10px; font-weight: 700; color: var(--text-3); background: rgba(255,255,255,0.05); padding: 1px 7px; border-radius: 4px; }
.prop-item p  { font-size: var(--text-sm); color: var(--text-2); line-height: 1.65; margin: 0; }

/* ── Divider ─────────────────────────────────────────────── */
.doc-divider {
  border: none;
  border-top: 1px solid var(--border-1);
  margin: var(--space-10) 0;
}

/* ── Page nav (prev / next) ──────────────────────────────── */
.doc-page-nav {
  display: grid;
  grid-template-columns: 1fr 1fr;
  gap: var(--space-4);
  margin-top: var(--space-16);
  padding-top: var(--space-8);
  border-top: 1px solid var(--border-1);
}
.doc-page-nav-item {
  display: flex;
  flex-direction: column;
  gap: 4px;
  padding: 14px 18px;
  background: rgba(255,255,255,0.025);
  border: 1px solid var(--border-1);
  border-radius: var(--r-md);
  text-decoration: none;
  transition: all var(--t-base);
}
.doc-page-nav-item:hover {
  border-color: var(--accent-border);
  background: var(--accent-dim);
}
.doc-page-nav-item.next { text-align: right; }
.doc-page-nav-dir {
  font-size: 10px;
  font-weight: 700;
  letter-spacing: 0.12em;
  text-transform: uppercase;
  color: var(--text-3);
}
.doc-page-nav-title {
  font-size: var(--text-sm);
  font-weight: 600;
  color: var(--text-1);
}

/* ── Feedback block ──────────────────────────────────────── */
.doc-feedback {
  margin-top: var(--space-12);
  padding: var(--space-5);
  background: rgba(255,255,255,0.02);
  border: 1px solid var(--border-1);
  border-radius: var(--r-md);
  display: flex;
  align-items: center;
  gap: var(--space-4);
  flex-wrap: wrap;
}
.doc-feedback-label {
  font-size: var(--text-sm);
  color: var(--text-2);
  flex: 1;
}
.doc-feedback-btns { display: flex; gap: 8px; }
.doc-feedback-btn {
  padding: 5px 14px;
  border-radius: var(--r-sm);
  font-size: var(--text-xs);
  font-weight: 600;
  border: 1px solid var(--border-1);
  color: var(--text-2);
  background: transparent;
  cursor: pointer;
  transition: all var(--t-fast);
}
.doc-feedback-btn:hover { border-color: var(--border-2); color: var(--text-1); }
.doc-feedback-btn.yes:hover { border-color: var(--success); color: var(--success); background: var(--success-bg); }
.doc-feedback-btn.no:hover  { border-color: var(--danger);  color: var(--danger);  background: var(--danger-bg); }

/* ── Search modal ────────────────────────────────────────── */
.search-overlay {
  display: none;
  position: fixed;
  inset: 0;
  z-index: 200;
  background: rgba(2, 8, 13, 0.75);
  backdrop-filter: blur(4px);
  align-items: flex-start;
  justify-content: center;
  padding-top: 80px;
}
.search-overlay.open { display: flex; }
.search-modal {
  width: 100%;
  max-width: 620px;
  background: var(--bg-2);
  border: 1px solid var(--border-2);
  border-radius: var(--r-lg);
  box-shadow: var(--shadow-lg);
  overflow: hidden;
  animation: modal-in 0.18s ease;
}
@keyframes modal-in {
  from { opacity: 0; transform: translateY(-12px) scale(0.98); }
  to   { opacity: 1; transform: none; }
}
.search-input-row {
  display: flex;
  align-items: center;
  gap: 10px;
  padding: 14px 18px;
  border-bottom: 1px solid var(--border-1);
}
.search-input-row svg { flex-shrink: 0; opacity: 0.5; }
.search-input {
  flex: 1;
  font-size: var(--text-md);
  color: var(--text-1);
  background: none;
  border: none;
  outline: none;
}
.search-input::placeholder { color: var(--text-3); }
.search-esc-hint {
  font-size: var(--text-xs);
  color: var(--text-4);
  background: rgba(255,255,255,0.05);
  border: 1px solid var(--border-1);
  border-radius: 4px;
  padding: 2px 7px;
  font-family: var(--font-mono);
  flex-shrink: 0;
}
.search-results { max-height: 380px; overflow-y: auto; padding: 8px 0; }
.search-empty {
  padding: 32px;
  text-align: center;
  color: var(--text-3);
  font-size: var(--text-sm);
}
.search-group-label {
  padding: 8px 18px 4px;
  font-size: 10px;
  font-weight: 700;
  letter-spacing: 0.12em;
  text-transform: uppercase;
  color: var(--text-4);
}
.search-result-item {
  display: flex;
  flex-direction: column;
  gap: 2px;
  padding: 10px 18px;
  cursor: pointer;
  transition: background var(--t-fast);
  border-radius: 0;
  text-decoration: none;
}
.search-result-item:hover, .search-result-item.is-selected {
  background: rgba(255,255,255,0.05);
}
.search-result-item.is-selected { background: var(--accent-dim); }
.search-result-title {
  font-size: var(--text-sm);
  font-weight: 600;
  color: var(--text-1);
}
.search-result-title mark {
  background: rgba(180,255,201,0.25);
  color: var(--accent);
  border-radius: 2px;
  padding: 0 2px;
}
.search-result-snippet {
  font-size: var(--text-xs);
  color: var(--text-3);
  line-height: 1.5;
  white-space: nowrap;
  overflow: hidden;
  text-overflow: ellipsis;
}
.search-result-snippet mark {
  background: rgba(180,255,201,0.15);
  color: var(--accent);
  border-radius: 2px;
  padding: 0 2px;
}
.search-footer {
  padding: 10px 18px;
  border-top: 1px solid var(--border-1);
  display: flex;
  gap: 16px;
  font-size: 11px;
  color: var(--text-4);
}
.search-footer kbd {
  font-family: var(--font-mono);
  background: rgba(255,255,255,0.05);
  border: 1px solid var(--border-1);
  border-radius: 3px;
  padding: 1px 5px;
}

/* ── Mobile docs ──────────────────────────────────────────── */
.docs-mobile-menu-btn {
  display: none;
  position: fixed;
  bottom: 20px;
  left: 16px;
  z-index: 60;
  padding: 10px 16px;
  background: var(--bg-2);
  border: 1px solid var(--border-2);
  border-radius: var(--r-full);
  font-size: var(--text-xs);
  font-weight: 700;
  color: var(--text-1);
  box-shadow: var(--shadow-md);
  gap: 6px;
  align-items: center;
  cursor: pointer;
  transition: background var(--t-fast);
}
.docs-mobile-menu-btn:hover { background: var(--bg-3); }

@media (max-width: 1100px) {
  .docs-toc { display: none; }
  .docs-main { margin-right: 0; }
}
@media (max-width: 800px) {
  .docs-sidebar {
    transform: translateX(-100%);
    transition: transform var(--t-base);
    z-index: 80;
  }
  .docs-sidebar.is-open { transform: translateX(0); }
  .docs-main { margin-left: 0; padding: 32px 24px 80px; }
  .docs-mobile-menu-btn { display: flex; }
  .sidebar-overlay {
    display: none;
    position: fixed;
    inset: 0;
    z-index: 70;
    background: rgba(0,0,0,0.5);
  }
  .sidebar-overlay.is-open { display: block; }
}
@media (max-width: 480px) {
  .docs-main { padding: 24px 16px 80px; }
  .doc-page-nav { grid-template-columns: 1fr; }
}