/*
 * docs-polish.css — Phase 8.5 visual refinement for the public docs surface.
 * Scoped to body.vh-docs-page — additive over the template's base styles.
 */

/* ─────────────────────────────────────────────
   CSS variable overrides (light theme)
───────────────────────────────────────────── */
body.vh-docs-page {
  --primary-color: #1a56db;
  --secondary-color: #1a56db;
  --bg-primary: #ffffff;
  --bg-secondary: #f8fafc;
  --border-color: #e2e8f0;
  --text-color: #0d1b2e;
  --text-secondary: #64748b;
  --code-bg: #0f172a;
  --sidebar-width: 272px;
  font-family: 'Inter', -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;
  -webkit-font-smoothing: antialiased;
}

body.vh-docs-page[data-theme="dark"] {
  --bg-primary: #0d1117;
  --bg-secondary: #161b22;
  --border-color: #21262d;
  --text-color: #e6edf3;
  --text-secondary: #8b949e;
}

/* ─────────────────────────────────────────────
   Header
───────────────────────────────────────────── */
body.vh-docs-page .docs-header {
  padding: 0 2rem;
  height: 60px;
  box-shadow: 0 1px 0 var(--border-color);
}

body.vh-docs-page .docs-logo {
  font-size: 1rem;
  font-weight: 650;
  letter-spacing: -0.02em;
  color: var(--text-color);
  gap: 10px;
}

body.vh-docs-page .docs-logo img {
  height: 30px;
  width: auto;
}

body.vh-docs-page .docs-logo span {
  color: var(--text-secondary);
  font-weight: 500;
}

body.vh-docs-page .header-actions a.btn-primary {
  background: #1a56db !important;
  border: none !important;
  border-radius: 8px !important;
  font-size: 0.8125rem !important;
  font-weight: 600 !important;
  padding: 6px 14px !important;
  letter-spacing: 0;
  transition: background 0.14s, transform 0.1s !important;
}
body.vh-docs-page .header-actions a.btn-primary:hover {
  background: #1447b8 !important;
  transform: translateY(-1px) !important;
}

body.vh-docs-page .theme-toggle {
  border-radius: 8px !important;
  padding: 6px 11px !important;
  font-size: 0.875rem;
}

/* ─────────────────────────────────────────────
   Layout: sidebar + content + TOC
───────────────────────────────────────────── */
body.vh-docs-page .docs-container {
  max-width: 1560px;
}

/* ─────────────────────────────────────────────
   Sidebar refinements
───────────────────────────────────────────── */
body.vh-docs-page .docs-sidebar {
  width: var(--sidebar-width);
  padding: 1.5rem 1rem;
  border-right-color: var(--border-color);
  display: flex;
  flex-direction: column;
  gap: 0;
}

body.vh-docs-page .sidebar-section {
  margin-bottom: 0.25rem;
  padding-bottom: 0.5rem;
  border-bottom: 1px solid var(--border-color);
}

body.vh-docs-page .sidebar-section:last-of-type {
  border-bottom: none;
}

body.vh-docs-page .sidebar-section-title {
  font-size: 0.6875rem;
  font-weight: 700;
  letter-spacing: 0.08em;
  text-transform: uppercase;
  color: var(--text-secondary);
  padding: 0.75rem 0.75rem 0.4rem;
  margin-bottom: 0.1rem;
}

body.vh-docs-page .sidebar-nav li {
  margin-bottom: 1px;
}

body.vh-docs-page .sidebar-nav a {
  font-size: 0.875rem;
  padding: 0.4rem 0.75rem;
  border-radius: 7px;
  color: var(--text-secondary);
  gap: 8px;
  font-weight: 400;
  transition: background 0.12s, color 0.12s;
}

body.vh-docs-page .sidebar-nav a i {
  font-size: 0.75rem;
  width: 14px;
  opacity: 0.7;
  flex-shrink: 0;
}

body.vh-docs-page .sidebar-nav a:hover {
  background: var(--bg-secondary);
  color: var(--text-color);
}

body.vh-docs-page .sidebar-nav a:hover i {
  opacity: 1;
}

/* Active: left accent bar style */
body.vh-docs-page .sidebar-nav a.active {
  background: rgba(26, 86, 219, 0.09) !important;
  color: #1a56db !important;
  font-weight: 600;
  position: relative;
}

body.vh-docs-page .sidebar-nav a.active::before {
  content: '';
  position: absolute;
  left: 0;
  top: 20%;
  height: 60%;
  width: 3px;
  border-radius: 0 2px 2px 0;
  background: #1a56db;
}

body.vh-docs-page .sidebar-nav a.active i {
  opacity: 1;
  color: #1a56db;
}

/* Sidebar support card */
body.vh-docs-page .sidebar-support-card {
  margin-top: auto;
  padding-top: 1rem;
  border-top: 1px solid var(--border-color);
}

body.vh-docs-page .sidebar-support-inner {
  background: var(--bg-secondary);
  border: 1px solid var(--border-color);
  border-radius: 10px;
  padding: 0.875rem 1rem;
}

body.vh-docs-page .sidebar-support-inner p {
  font-size: 0.8rem;
  color: var(--text-secondary);
  margin-bottom: 0.5rem;
  line-height: 1.5;
}

body.vh-docs-page .sidebar-support-inner a {
  font-size: 0.8rem;
  color: #1a56db;
  text-decoration: none;
  font-weight: 500;
  display: flex;
  align-items: center;
  gap: 5px;
  margin-top: 3px;
}

body.vh-docs-page .sidebar-support-inner a:hover {
  text-decoration: underline;
}

/* ─────────────────────────────────────────────
   Main content
───────────────────────────────────────────── */
body.vh-docs-page .docs-content {
  flex: 1;
  min-width: 0;
  max-width: 860px;
  padding: 2.5rem 3rem 4rem;
}

body.vh-docs-page .docs-content h1 {
  font-size: 2.25rem;
  font-weight: 750;
  letter-spacing: -0.04em;
  line-height: 1.2;
  margin-bottom: 0.75rem;
  color: var(--text-color);
}

body.vh-docs-page .docs-content h2 {
  font-size: 1.5rem;
  font-weight: 700;
  letter-spacing: -0.025em;
  margin-top: 2.5rem;
  margin-bottom: 0.75rem;
  padding-bottom: 0.5rem;
  border-bottom-color: var(--border-color);
  color: var(--text-color);
}

body.vh-docs-page .docs-content h3 {
  font-size: 1.175rem;
  font-weight: 650;
  letter-spacing: -0.02em;
  margin-top: 1.75rem;
  margin-bottom: 0.5rem;
  color: var(--text-color);
}

body.vh-docs-page .docs-content h4 {
  font-size: 1rem;
  font-weight: 650;
  letter-spacing: -0.01em;
  margin-top: 1.25rem;
  margin-bottom: 0.4rem;
  color: var(--text-color);
}

body.vh-docs-page .docs-content p {
  line-height: 1.75;
  margin-bottom: 1.125rem;
  color: var(--text-color);
  font-size: 0.9375rem;
}

body.vh-docs-page .docs-content ul,
body.vh-docs-page .docs-content ol {
  font-size: 0.9375rem;
  line-height: 1.75;
}

body.vh-docs-page .docs-content li {
  margin-bottom: 0.375rem;
  color: var(--text-color);
}

body.vh-docs-page .docs-content a {
  color: #1a56db;
  text-decoration: none;
  font-weight: 500;
}

body.vh-docs-page .docs-content a:hover {
  text-decoration: underline;
}

body.vh-docs-page .docs-content blockquote {
  border-left-color: #1a56db;
  border-radius: 0 8px 8px 0;
  background: rgba(26, 86, 219, 0.04);
  padding: 0.75rem 1rem 0.75rem 1.25rem;
  margin: 1.5rem 0;
  font-style: normal;
  color: var(--text-secondary);
}

/* ─────────────────────────────────────────────
   Inline code
───────────────────────────────────────────── */
body.vh-docs-page .docs-content code {
  background: rgba(26, 86, 219, 0.07);
  color: #1a56db;
  border: 1px solid rgba(26, 86, 219, 0.14);
  padding: 0.15rem 0.4rem;
  border-radius: 5px;
  font-family: 'Fira Code', 'JetBrains Mono', 'Cascadia Code', ui-monospace, monospace;
  font-size: 0.8125em;
}

body.vh-docs-page[data-theme="dark"] .docs-content code {
  background: rgba(26, 86, 219, 0.14);
  color: #93c5fd;
  border-color: rgba(26, 86, 219, 0.25);
}

/* ─────────────────────────────────────────────
   Code blocks
───────────────────────────────────────────── */
body.vh-docs-page .docs-content pre {
  background: #0f172a !important;
  border-radius: 12px !important;
  border: 1px solid #1e293b !important;
  padding: 0 !important;
  margin-bottom: 1.5rem !important;
  overflow: hidden !important;
  position: relative !important;
}

body.vh-docs-page .docs-content pre::before {
  content: '';
  display: block;
  height: 40px;
  background: #1e293b;
  border-bottom: 1px solid #334155;
  background-image: radial-gradient(circle, #ef4444 6px, transparent 6px),
                    radial-gradient(circle, #f59e0b 6px, transparent 6px),
                    radial-gradient(circle, #22c55e 6px, transparent 6px);
  background-size: 12px 12px;
  background-position: 18px center, 36px center, 54px center;
  background-repeat: no-repeat;
}

body.vh-docs-page .docs-content pre code {
  background: transparent !important;
  color: #e2e8f0 !important;
  border: none !important;
  padding: 1.25rem 1.5rem !important;
  display: block !important;
  font-size: 0.84rem !important;
  line-height: 1.65 !important;
  overflow-x: auto !important;
}

/* ─────────────────────────────────────────────
   Tables
───────────────────────────────────────────── */
body.vh-docs-page .docs-content table {
  font-size: 0.875rem;
  border: 1px solid var(--border-color);
  border-radius: 10px;
  overflow: hidden;
  box-shadow: 0 1px 3px rgba(0,0,0,0.04);
}

body.vh-docs-page .docs-content th {
  background: var(--bg-secondary);
  font-size: 0.775rem;
  font-weight: 700;
  text-transform: uppercase;
  letter-spacing: 0.05em;
  color: var(--text-secondary);
  border-bottom: 1.5px solid var(--border-color);
  padding: 0.625rem 1rem;
}

body.vh-docs-page .docs-content td {
  padding: 0.625rem 1rem;
  border-bottom-color: var(--border-color);
  vertical-align: middle;
  color: var(--text-color);
}

body.vh-docs-page .docs-content tr:hover td {
  background: var(--bg-secondary);
}

/* ─────────────────────────────────────────────
   Callout / alert blocks
───────────────────────────────────────────── */
body.vh-docs-page .docs-content .note,
body.vh-docs-page .docs-content .callout-info,
body.vh-docs-page .docs-content .alert-info {
  background: rgba(26, 86, 219, 0.05);
  border: 1px solid rgba(26, 86, 219, 0.18);
  border-radius: 10px;
  padding: 0.875rem 1.125rem;
  margin-bottom: 1.25rem;
  color: #1e3a8a;
  font-size: 0.9rem;
}

body.vh-docs-page .docs-content .warning,
body.vh-docs-page .docs-content .callout-warning,
body.vh-docs-page .docs-content .alert-warning {
  background: rgba(217, 119, 6, 0.05);
  border: 1px solid rgba(217, 119, 6, 0.2);
  border-radius: 10px;
  padding: 0.875rem 1.125rem;
  margin-bottom: 1.25rem;
  color: #78350f;
  font-size: 0.9rem;
}

/* ─────────────────────────────────────────────
   Social share bar
───────────────────────────────────────────── */
body.vh-docs-page .social-share {
  border-radius: 12px;
  border: 1px solid var(--border-color);
  background: var(--bg-secondary) !important;
  padding: 1rem 1.25rem;
  gap: 0.75rem;
  align-items: center;
}

body.vh-docs-page .social-share-label {
  color: var(--text-secondary);
  font-size: 0.875rem;
}

body.vh-docs-page .social-share-btn {
  font-size: 0.8125rem;
  padding: 5px 14px;
  border-radius: 7px;
}

/* ─────────────────────────────────────────────
   Right-side "On this page" TOC
───────────────────────────────────────────── */
body.vh-docs-page .docs-toc {
  width: 220px;
  flex-shrink: 0;
  padding: 2.5rem 1.25rem 2.5rem 0.75rem;
  position: sticky;
  top: 60px;
  height: calc(100vh - 60px);
  overflow-y: auto;
  display: none;
}

@media (min-width: 1280px) {
  body.vh-docs-page .docs-toc {
    display: block;
  }
}

body.vh-docs-page .docs-toc-title {
  font-size: 0.6875rem;
  font-weight: 700;
  text-transform: uppercase;
  letter-spacing: 0.08em;
  color: var(--text-secondary);
  margin-bottom: 0.75rem;
  padding-left: 0.5rem;
}

body.vh-docs-page #docs-toc-nav {
  display: flex;
  flex-direction: column;
  gap: 1px;
}

body.vh-docs-page #docs-toc-nav a {
  display: block;
  font-size: 0.8125rem;
  color: var(--text-secondary);
  text-decoration: none;
  padding: 0.3rem 0.5rem;
  border-radius: 5px;
  border-left: 2px solid transparent;
  line-height: 1.45;
  transition: color 0.12s, background 0.12s;
  white-space: nowrap;
  overflow: hidden;
  text-overflow: ellipsis;
}

body.vh-docs-page #docs-toc-nav a.toc-h3 {
  padding-left: 1.125rem;
  font-size: 0.775rem;
}

body.vh-docs-page #docs-toc-nav a:hover {
  color: var(--text-color);
  background: var(--bg-secondary);
}

body.vh-docs-page #docs-toc-nav a.active {
  color: #1a56db;
  border-left-color: #1a56db;
  font-weight: 600;
}

/* ─────────────────────────────────────────────
   Mobile
───────────────────────────────────────────── */
@media (max-width: 968px) {
  body.vh-docs-page .docs-content {
    padding: 1.5rem 1.25rem 3rem;
    max-width: 100%;
  }

  body.vh-docs-page .docs-content h1 {
    font-size: 1.65rem;
  }

  body.vh-docs-page .docs-content pre code {
    font-size: 0.8rem !important;
  }

  body.vh-docs-page .docs-content table {
    display: block;
    overflow-x: auto;
    -webkit-overflow-scrolling: touch;
  }
}

/* ─────────────────────────────────────────────
   Logo — brand name (not "Docs" label)
───────────────────────────────────────────── */
body.vh-docs-page .docs-logo span {
  color: var(--text-color) !important;
  font-weight: 650 !important;
  letter-spacing: -0.02em;
}

/* ─────────────────────────────────────────────
   Enterprise ready card (sidebar bottom)
───────────────────────────────────────────── */
body.vh-docs-page .sidebar-enterprise-card {
  margin-top: auto;
  padding-top: 1rem;
  border-top: 1px solid var(--border-color);
}

body.vh-docs-page .sidebar-enterprise-card .enterprise-card-icon {
  width: 32px;
  height: 32px;
  border-radius: 8px;
  background: rgba(26, 86, 219, 0.1);
  display: flex;
  align-items: center;
  justify-content: center;
  margin-bottom: 0.6rem;
}

body.vh-docs-page .sidebar-enterprise-card .enterprise-card-icon i {
  font-size: 0.875rem;
  color: #1a56db;
}

body.vh-docs-page .sidebar-enterprise-card .enterprise-card-badge {
  font-size: 0.6875rem;
  font-weight: 700;
  letter-spacing: 0.04em;
  text-transform: uppercase;
  color: #1a56db;
  background: rgba(26, 86, 219, 0.08);
  border: 1px solid rgba(26, 86, 219, 0.18);
  border-radius: 4px;
  padding: 2px 7px;
  display: inline-block;
  margin-bottom: 0.5rem;
}

body.vh-docs-page .sidebar-enterprise-card p {
  font-size: 0.8rem;
  color: var(--text-secondary);
  line-height: 1.5;
  margin-bottom: 0.5rem;
}

body.vh-docs-page .sidebar-enterprise-card a {
  font-size: 0.8rem;
  color: #1a56db;
  font-weight: 500;
  text-decoration: none;
  display: inline-flex;
  align-items: center;
  gap: 3px;
  transition: gap 0.12s;
}

body.vh-docs-page .sidebar-enterprise-card a:hover {
  text-decoration: underline;
  gap: 6px;
}