/*
 * Developer docs: English under docs/, Vietnamese under vi/docs/.
 * Reuses the site's tokens, header, buttons and code blocks; adds a reading column and a docs menu
 * that is a sidebar on wide screens and a wrapped row of links on narrow ones (no horizontal scroll).
 */

.docs .site-header {
  position: sticky;
  background: color-mix(in srgb, var(--bg) 82%, transparent);
  backdrop-filter: saturate(1.4) blur(14px);
  -webkit-backdrop-filter: saturate(1.4) blur(14px);
  border-bottom-color: var(--line);
}
.lang-switch {
  display: inline-flex; align-items: center; justify-content: center; min-width: 2.25rem; height: 2.25rem; padding: 0 0.6rem;
  border-radius: var(--radius-pill); border: 1px solid var(--line); color: var(--text-muted);
  font-family: var(--font-mono); font-size: 0.75rem; letter-spacing: 0.04em; text-decoration: none;
  transition: color var(--dur-micro) ease, border-color var(--dur-micro) ease;
}
.lang-switch:hover { color: var(--text); border-color: var(--line-strong); }

.docs-layout {
  max-width: var(--max); margin: 0 auto; padding: var(--space-7) var(--gutter) 0;
  display: grid; grid-template-columns: 13rem minmax(0, 1fr); gap: clamp(2rem, 1rem + 4vw, 5rem); align-items: start;
}
.docs-menu { position: sticky; top: 5.5rem; }
.docs-menu__title { margin-bottom: var(--space-3); }
.docs-menu ul { display: grid; gap: 0.15rem; }
.docs-menu a {
  display: block; padding: 0.4rem 0.75rem; border-radius: var(--radius-sm); color: var(--text-muted); text-decoration: none; font-size: 0.9375rem;
  transition: color var(--dur-micro) ease, background-color var(--dur-micro) ease;
}
.docs-menu a:hover { color: var(--text); background: var(--code-bg); }
.docs-menu a[aria-current="page"] { color: var(--text); background: var(--accent-soft); font-weight: 500; }
@media (max-width: 900px) {
  .docs-layout { grid-template-columns: minmax(0, 1fr); padding-top: var(--space-5); gap: var(--space-6); }
  .docs-menu { position: static; border-bottom: 1px solid var(--line); padding-bottom: var(--space-4); }
  .docs-menu ul { display: flex; flex-wrap: wrap; gap: 0.4rem; }
  .docs-menu a { border: 1px solid var(--line); border-radius: var(--radius-pill); padding: 0.3rem 0.8rem; font-size: 0.875rem; }
  .docs-menu a[aria-current="page"] { border-color: transparent; }
}

.prose { max-width: 46rem; min-width: 0; }
.prose > * + * { margin-top: var(--space-4); }
.prose h1 {
  font-family: var(--font-display); font-weight: 400; font-size: var(--step-3);
  line-height: 1.05; letter-spacing: -0.02em; text-wrap: balance;
}
.prose .lead-translation { font-family: var(--font-display); font-size: var(--step-2); line-height: 1.2; color: var(--text-muted); margin-top: var(--space-3); }
.prose .lede { font-size: var(--step-1); color: var(--text-muted); line-height: 1.55; }
.prose h2 { font-size: var(--step-2); font-weight: 480; letter-spacing: -0.02em; line-height: 1.2; margin-top: var(--space-7); }
.prose h3 { font-size: var(--step-1); font-weight: 540; letter-spacing: -0.01em; margin-top: var(--space-6); }
.prose ul { padding-left: 1.2rem; list-style: disc; }
.prose ol { padding-left: 1.4rem; list-style: decimal; }
.prose li + li { margin-top: 0.35rem; }
.prose li::marker { color: var(--text-faint); }
.prose a { text-decoration-color: var(--line-strong); text-underline-offset: 3px; }
.prose a:hover { text-decoration-color: currentColor; }
.prose :not(pre) > code {
  font-family: var(--font-mono); font-size: 0.85em; background: var(--code-bg); border: 1px solid var(--line);
  border-radius: 6px; padding: 0.05em 0.35em; overflow-wrap: anywhere;
}
/* The copy button gets its own row, so it never covers a line of code at any width. */
.prose .code pre { padding-top: 2.6rem; }

.note { border: 1px solid var(--line); border-left: 3px solid var(--accent); border-radius: var(--radius-sm); background: var(--bg-raised); padding: var(--space-4) var(--space-5); color: var(--text-muted); font-size: 0.9375rem; }
.note strong { color: var(--text); font-weight: 560; }

.table-wrap { overflow-x: auto; border: 1px solid var(--line); border-radius: var(--radius-sm); }
.prose table { width: 100%; border-collapse: collapse; font-size: 0.875rem; }
.prose th, .prose td { text-align: left; vertical-align: top; padding: 0.6rem 0.8rem; border-bottom: 1px solid var(--line); }
.prose th { font-weight: 560; background: var(--bg-raised); }
.prose tr:last-child td { border-bottom: 0; }
/* In tables a path stays whole; the table scrolls inside .table-wrap instead of breaking it mid-word. */
.prose td code { overflow-wrap: normal; }
.prose td:last-child { min-width: 14rem; }

.surface-list { list-style: none !important; padding: 0 !important; display: grid; grid-template-columns: repeat(auto-fit, minmax(min(100%, 13rem), 1fr)); gap: var(--space-3); }
.surface-list li { margin: 0 !important; }
.surface-list a { display: block; height: 100%; padding: var(--space-4); border: 1px solid var(--line); border-radius: var(--radius); background: var(--card); text-decoration: none; transition: border-color var(--dur-micro) ease; }
.surface-list a:hover { border-color: var(--line-strong); }
.surface-list b { display: block; font-weight: 560; margin-bottom: 0.2rem; }
.surface-list span { color: var(--text-muted); font-size: 0.875rem; }