/* docs.css — Queryvine Documentation Pages
   Extends main.css for the docs section.
   qv-docs-content uses theme-scoped selectors per shared_containers spec.
   ──────────────────────────────────────────────────────────────── */

/* ─────────────────────────────────────────────
   DOCS LAYOUT
   Docs pages: sidebar left + main content right
   sidebar: dark-alt (dark-top) | light-alt (light-top)
   main:    white on all docs pages
   ───────────────────────────────────────────── */
.qv-docs-page { min-height: 100vh; }

.qv-docs-layout {
  display: grid;
  grid-template-columns: 260px 1fr;
  min-height: calc(100vh - 64px);
  max-width: var(--qv-container);
  margin: 0 auto;
  padding: 0 clamp(1rem, 4vw, 2rem);
}

/* ─────────── SIDEBAR ─────────── */
.qv-docs-sidebar {
  padding: 2rem 1.5rem 4rem 0;
  position: sticky;
  top: 64px;
  height: calc(100vh - 64px);
  overflow-y: auto;
  border-right: 1px solid var(--qv-border-dark);
}

/* Sidebar on dark-top docs pages */
body.qv-page--dark-top .qv-docs-sidebar {
  background: var(--qv-bg-dark);
  border-right-color: var(--qv-border-dark);
}

/* Sidebar on light-top docs pages */
body.qv-page--light-top .qv-docs-sidebar {
  background: var(--qv-bg-light-alt);
  border-right-color: var(--qv-border-light);
}

.qv-docs-sidebar__section {
  margin-bottom: 2rem;
}

.qv-docs-sidebar__section-label {
  font-size: 0.6875rem;
  font-weight: 700;
  letter-spacing: 0.1em;
  text-transform: uppercase;
  margin-bottom: 0.5rem;
  padding: 0 0.625rem;
}

body.qv-page--dark-top .qv-docs-sidebar__section-label { color: var(--qv-fg-dark-muted); }
body.qv-page--light-top .qv-docs-sidebar__section-label { color: var(--qv-fg-light-muted); }

.qv-docs-sidebar__links { display: flex; flex-direction: column; gap: 0.125rem; }

.qv-docs-sidebar__link {
  font-size: 0.875rem;
  font-weight: 400;
  padding: 0.375rem 0.625rem;
  border-radius: 6px;
  text-decoration: none;
  transition: background 0.12s, color 0.12s;
  display: block;
}

body.qv-page--dark-top .qv-docs-sidebar__link {
  color: var(--qv-fg-dark-secondary);
}

body.qv-page--dark-top .qv-docs-sidebar__link:hover {
  color: var(--qv-fg-dark-primary);
  background: rgba(255,255,255,0.06);
}

body.qv-page--dark-top .qv-docs-sidebar__link--active {
  color: var(--qv-accent-aa-dark);
  background: rgba(110, 231, 183, 0.08);
  font-weight: 500;
}

body.qv-page--light-top .qv-docs-sidebar__link {
  color: var(--qv-fg-light-secondary);
}

body.qv-page--light-top .qv-docs-sidebar__link:hover {
  color: var(--qv-fg-light-primary);
  background: rgba(0,0,0,0.04);
}

body.qv-page--light-top .qv-docs-sidebar__link--active {
  color: var(--qv-accent-aa-light);
  background: rgba(4, 120, 87, 0.06);
  font-weight: 500;
}

/* ─────────── MAIN CONTENT AREA ─────────── */
.qv-docs-main {
  background: var(--qv-bg-white);
  padding: 2.5rem 3rem 5rem;
  min-width: 0;
}

/* ─────────── qv-docs-content — THEME-SCOPED ─────────── */
/* Per shared_containers spec:
   "any element selector inside this container MUST be theme-scoped:
   body.qv-page--dark-top .qv-docs-content h1 AND body.qv-page--light-top .qv-docs-content h1"
   Specificity: (0,2,1) for each rule */

body.qv-page--dark-top .qv-docs-content h1 { color: var(--qv-fg-dark-primary); }
body.qv-page--dark-top .qv-docs-content h2 { color: var(--qv-fg-dark-primary); }
body.qv-page--dark-top .qv-docs-content h3 { color: var(--qv-fg-dark-primary); }
body.qv-page--dark-top .qv-docs-content h4 { color: var(--qv-fg-dark-primary); }
body.qv-page--dark-top .qv-docs-content p  { color: var(--qv-fg-dark-secondary); }
body.qv-page--dark-top .qv-docs-content li { color: var(--qv-fg-dark-secondary); }
body.qv-page--dark-top .qv-docs-content a  { color: var(--qv-accent-aa-dark); }
body.qv-page--dark-top .qv-docs-content code { background: rgba(255,255,255,0.06); color: var(--qv-accent-aa-dark); border-color: var(--qv-border-dark); }
body.qv-page--dark-top .qv-docs-content strong { color: var(--qv-fg-dark-primary); }
body.qv-page--dark-top .qv-docs-content blockquote { border-left-color: rgba(110,231,183,0.3); background: rgba(110,231,183,0.04); }
body.qv-page--dark-top .qv-docs-content blockquote p { color: var(--qv-fg-dark-secondary); }

body.qv-page--light-top .qv-docs-content h1 { color: var(--qv-fg-light-primary); }
body.qv-page--light-top .qv-docs-content h2 { color: var(--qv-fg-light-primary); }
body.qv-page--light-top .qv-docs-content h3 { color: var(--qv-fg-light-primary); }
body.qv-page--light-top .qv-docs-content h4 { color: var(--qv-fg-light-primary); }
body.qv-page--light-top .qv-docs-content p  { color: var(--qv-fg-light-secondary); }
body.qv-page--light-top .qv-docs-content li { color: var(--qv-fg-light-secondary); }
body.qv-page--light-top .qv-docs-content a  { color: var(--qv-accent-aa-light); }
body.qv-page--light-top .qv-docs-content code { background: var(--qv-bg-light-alt); color: var(--qv-accent-aa-light); border-color: var(--qv-border-light); }
body.qv-page--light-top .qv-docs-content strong { color: var(--qv-fg-light-primary); }
body.qv-page--light-top .qv-docs-content blockquote { border-left-color: rgba(4,120,87,0.3); background: rgba(4,120,87,0.04); }
body.qv-page--light-top .qv-docs-content blockquote p { color: var(--qv-fg-light-secondary); }

/* Shared structure — theme-independent layout properties */
.qv-docs-content { line-height: 1.75; }

.qv-docs-content h1 { font-size: clamp(1.75rem, 3vw, 2.25rem); font-weight: 700; margin-bottom: 0.75rem; letter-spacing: -0.01em; }
.qv-docs-content h2 { font-size: 1.375rem; font-weight: 700; margin: 2.5rem 0 0.875rem; padding-top: 0.25rem; border-top: 1px solid; }
.qv-docs-content h3 { font-size: 1.125rem; font-weight: 600; margin: 2rem 0 0.625rem; }
.qv-docs-content h4 { font-size: 1rem; font-weight: 600; margin: 1.5rem 0 0.5rem; }
.qv-docs-content p  { font-size: 0.9375rem; margin-bottom: 1.25rem; }
.qv-docs-content ul, .qv-docs-content ol { padding-left: 1.5rem; margin-bottom: 1.25rem; }
.qv-docs-content ul { list-style: disc; }
.qv-docs-content ol { list-style: decimal; }
.qv-docs-content li { font-size: 0.9375rem; margin-bottom: 0.375rem; }
.qv-docs-content a { text-decoration: underline; font-weight: 500; }
.qv-docs-content a:hover { opacity: 0.8; }

body.qv-page--dark-top .qv-docs-content h2 { border-top-color: var(--qv-border-dark); }
body.qv-page--light-top .qv-docs-content h2 { border-top-color: var(--qv-border-light); }

.qv-docs-content code {
  font-family: var(--qv-font-mono);
  font-size: 0.8125rem;
  padding: 0.125rem 0.375rem;
  border-radius: 4px;
  border: 1px solid;
}

.qv-docs-content pre {
  font-family: var(--qv-font-mono);
  font-size: 0.8125rem;
  line-height: 1.55;
  background: var(--qv-bg-dark-card);
  color: var(--qv-fg-dark-secondary);
  border: 1px solid var(--qv-border-dark);
  border-radius: var(--qv-radius);
  padding: 1.25rem 1.5rem;
  overflow-x: auto;
  margin: 1.25rem 0;
}

.qv-docs-content pre code,
body.qv-page--light-top .qv-docs-content pre code,
body.qv-page--dark-top .qv-docs-content pre code {
  background: transparent;
  border: none;
  padding: 0;
  color: var(--qv-fg-dark-secondary);
  font-size: inherit;
}

.qv-docs-content blockquote {
  margin: 1.5rem 0;
  padding: 1rem 1.25rem;
  border-left: 3px solid;
  border-radius: 0 var(--qv-radius) var(--qv-radius) 0;
}

/* Docs breadcrumb */
.qv-docs-breadcrumb {
  display: flex;
  align-items: center;
  gap: 0.5rem;
  font-size: 0.8125rem;
  margin-bottom: 2rem;
  flex-wrap: wrap;
}

body.qv-page--light-top .qv-docs-breadcrumb { color: var(--qv-fg-light-muted); }
body.qv-page--dark-top  .qv-docs-breadcrumb { color: var(--qv-fg-dark-muted); }

.qv-docs-breadcrumb a {
  text-decoration: none;
}

body.qv-page--light-top .qv-docs-breadcrumb a { color: var(--qv-fg-light-muted); }
body.qv-page--dark-top  .qv-docs-breadcrumb a { color: var(--qv-fg-dark-muted); }

body.qv-page--light-top .qv-docs-breadcrumb a:hover { color: var(--qv-accent-aa-light); }
body.qv-page--dark-top  .qv-docs-breadcrumb a:hover { color: var(--qv-accent-aa-dark); }

.qv-docs-breadcrumb__sep { opacity: 0.5; }

/* Docs index hero */
.qv-docs-index-hero {
  background: var(--qv-bg-dark);
  padding: 4rem 0 3.5rem;
}

.qv-docs-index-hero__inner {
  max-width: var(--qv-container);
  margin: 0 auto;
  padding: 0 clamp(1rem, 4vw, 2rem);
}

.qv-docs-index-hero h1 { color: var(--qv-fg-dark-primary); margin-bottom: 0.875rem; }
.qv-docs-index-hero p { color: var(--qv-fg-dark-secondary); font-size: 1.0625rem; }

/* Docs cards grid (index page) */
.qv-docs-cards {
  display: grid;
  grid-template-columns: repeat(3, 1fr);
  gap: 1.25rem;
  margin-top: 2.5rem;
}

.qv-docs-card {
  background: var(--qv-bg-dark-card);
  border: 1px solid var(--qv-border-dark);
  border-radius: var(--qv-radius-lg);
  padding: 1.5rem;
  text-decoration: none;
  display: block;
  transition: border-color 0.15s, transform 0.15s;
}

.qv-docs-card:hover {
  border-color: rgba(110, 231, 183, 0.25);
  transform: translateY(-2px);
}

.qv-docs-card__icon {
  font-size: 1.5rem;
  color: var(--qv-accent-aa-dark);
  margin-bottom: 0.875rem;
}

.qv-docs-card h3 { color: var(--qv-fg-dark-primary); margin-bottom: 0.5rem; font-size: 0.9375rem; }
.qv-docs-card p { color: var(--qv-fg-dark-secondary); font-size: 0.8125rem; line-height: 1.6; }

/* API reference styles */
.qv-api-endpoint {
  background: var(--qv-bg-light-alt);
  border: 1px solid var(--qv-border-light);
  border-radius: var(--qv-radius-lg);
  padding: 1.5rem;
  margin: 1.5rem 0;
}

.qv-api-endpoint__method {
  display: inline-block;
  font-family: var(--qv-font-mono);
  font-size: 0.75rem;
  font-weight: 700;
  padding: 0.2rem 0.5rem;
  border-radius: 4px;
  margin-right: 0.625rem;
}

.qv-api-endpoint__method--get  { background: rgba(4,120,87,0.1); color: var(--qv-accent-aa-light); }
.qv-api-endpoint__method--post { background: rgba(67,56,202,0.1); color: var(--qv-indigo-aa-light); }
.qv-api-endpoint__method--del  { background: rgba(185,28,28,0.1); color: #B91C1C; }

.qv-api-endpoint__path {
  font-family: var(--qv-font-mono);
  font-size: 0.9375rem;
  font-weight: 500;
  color: var(--qv-fg-light-primary);
}

.qv-api-endpoint__desc {
  font-size: 0.875rem;
  color: var(--qv-fg-light-secondary);
  margin-top: 0.5rem;
}

/* Responsive docs */
@media (max-width: 900px) {
  .qv-docs-layout {
    grid-template-columns: 1fr;
  }

  .qv-docs-sidebar {
    position: static;
    height: auto;
    border-right: none;
    border-bottom: 1px solid var(--qv-border-dark);
    padding: 1.5rem 0;
    overflow: visible;
  }

  body.qv-page--light-top .qv-docs-sidebar {
    border-bottom-color: var(--qv-border-light);
  }

  .qv-docs-main {
    padding: 2rem 1rem 4rem;
  }

  .qv-docs-cards {
    grid-template-columns: 1fr 1fr;
  }
}

@media (max-width: 600px) {
  .qv-docs-cards { grid-template-columns: 1fr; }
}

/* ─────────────────────────────────────────────
   MISSING DOCS COMPONENTS
   ───────────────────────────────────────────── */

/* Sidebar heading (used as section-label alias) */
.qv-docs-sidebar__heading {
  font-size: 0.6875rem;
  font-weight: 700;
  letter-spacing: 0.1em;
  text-transform: uppercase;
  margin-bottom: 0.5rem;
  margin-top: 1.5rem;
  padding: 0 0.625rem;
}
body.qv-page--light-top .qv-docs-sidebar__heading { color: var(--qv-fg-light-muted); }
body.qv-page--dark-top  .qv-docs-sidebar__heading { color: var(--qv-fg-dark-muted); }

/* Sub-nav links */
.qv-docs-sidebar__link--sub {
  padding-left: 1.375rem;
  font-size: 0.8125rem;
}

/* Lead paragraph (larger intro paragraph) */
.qv-docs-lead {
  font-size: 1.0625rem;
  line-height: 1.75;
  margin-bottom: 2rem;
}
body.qv-page--light-top .qv-docs-lead { color: var(--qv-fg-light-secondary); }
body.qv-page--dark-top  .qv-docs-lead { color: var(--qv-fg-dark-secondary); }

/* Callout boxes */
.qv-docs-callout {
  padding: 1rem 1.25rem;
  border-left: 3px solid;
  border-radius: 0 var(--qv-radius) var(--qv-radius) 0;
  margin: 1.5rem 0;
}
.qv-docs-callout p { margin: 0; font-size: 0.9375rem; line-height: 1.65; }

body.qv-page--light-top .qv-docs-callout { background: var(--qv-bg-light-alt); border-left-color: var(--qv-border-light); }
body.qv-page--dark-top  .qv-docs-callout { background: rgba(255,255,255,0.04); border-left-color: var(--qv-border-dark); }

.qv-docs-callout--info {
  border-left-color: var(--qv-indigo-aa-light) !important;
  background: rgba(67,56,202,0.06) !important;
}
body.qv-page--dark-top .qv-docs-callout--info {
  border-left-color: var(--qv-indigo-aa-dark) !important;
  background: rgba(129,140,248,0.08) !important;
}
.qv-docs-callout--info p { color: var(--qv-indigo-aa-light); }
body.qv-page--dark-top .qv-docs-callout--info p { color: var(--qv-indigo-aa-dark); }

.qv-docs-callout--success {
  border-left-color: var(--qv-accent-aa-light) !important;
  background: rgba(4,120,87,0.06) !important;
}
body.qv-page--dark-top .qv-docs-callout--success {
  border-left-color: var(--qv-accent-aa-dark) !important;
  background: rgba(110,231,183,0.06) !important;
}
.qv-docs-callout--success p { color: var(--qv-accent-aa-light); }
body.qv-page--dark-top .qv-docs-callout--success p { color: var(--qv-accent-aa-dark); }

.qv-docs-callout--warning {
  border-left-color: #D97706 !important;
  background: rgba(251,191,36,0.08) !important;
}
.qv-docs-callout--warning p { color: #92400E; }
body.qv-page--dark-top .qv-docs-callout--warning p { color: #FCD34D; }

/* Code panel (terminal mock) */
.qv-code-panel {
  border-radius: var(--qv-radius-lg);
  overflow: hidden;
  border: 1px solid var(--qv-border-dark);
  margin: 1.5rem 0;
  background: var(--qv-bg-dark-card);
}
.qv-code-panel__chrome {
  display: flex;
  align-items: center;
  gap: 0.5rem;
  padding: 0.625rem 1rem;
  background: var(--qv-bg-dark);
  border-bottom: 1px solid var(--qv-border-dark);
}
.qv-code-panel__dot {
  width: 12px;
  height: 12px;
  border-radius: 50%;
}
.qv-code-panel__dot--red    { background: #EF4444; }
.qv-code-panel__dot--yellow { background: #EAB308; }
.qv-code-panel__dot--green  { background: #22C55E; }
.qv-code-panel__title {
  font-family: var(--qv-font-mono);
  font-size: 0.75rem;
  color: var(--qv-fg-dark-muted);
  margin-left: auto;
}
.qv-code-panel__body {
  padding: 1.25rem 1.5rem;
  font-family: var(--qv-font-mono);
  font-size: 0.8125rem;
  line-height: 1.55;
  color: var(--qv-fg-dark-secondary);
  overflow-x: auto;
  white-space: pre;
}

/* Syntax token classes for inline code */
.qv-t-prompt { color: var(--qv-accent-aa-dark); font-weight: 700; user-select: none; }
.qv-t-cmd    { color: var(--qv-fg-dark-primary); }
.qv-t-meta   { color: var(--qv-fg-dark-secondary); }
.qv-t-insert { color: var(--qv-accent-aa-dark); }
.qv-t-kw     { color: #A5B4FC; }  /* indigo-aa-on-dark */
.qv-t-str    { color: #86EFAC; }  /* green */
.qv-t-cmt    { color: var(--qv-fg-dark-muted); font-style: italic; }

/* Docs table */
.qv-docs-table-wrap { overflow-x: auto; margin: 1.5rem 0; }
.qv-docs-table {
  width: 100%;
  border-collapse: collapse;
  font-size: 0.875rem;
}
.qv-docs-table th {
  text-align: left;
  padding: 0.625rem 0.875rem;
  font-weight: 600;
  border-bottom: 2px solid;
}
body.qv-page--light-top .qv-docs-table th {
  color: var(--qv-fg-light-primary);
  border-bottom-color: var(--qv-border-light);
  background: var(--qv-bg-light-alt);
}
body.qv-page--dark-top .qv-docs-table th {
  color: var(--qv-fg-dark-primary);
  border-bottom-color: var(--qv-border-dark);
  background: var(--qv-bg-dark-card);
}
.qv-docs-table td {
  padding: 0.625rem 0.875rem;
  border-bottom: 1px solid;
  vertical-align: top;
}
body.qv-page--light-top .qv-docs-table td {
  color: var(--qv-fg-light-secondary);
  border-bottom-color: var(--qv-border-light);
}
body.qv-page--dark-top .qv-docs-table td {
  color: var(--qv-fg-dark-secondary);
  border-bottom-color: var(--qv-border-dark);
}

/* Badge severity variants */
.qv-badge--red {
  background: rgba(185,28,28,0.1);
  color: #B91C1C;
  font-size: 0.72rem;
  font-weight: 600;
  padding: 0.2em 0.55em;
  border-radius: 4px;
  display: inline-block;
}
.qv-badge--yellow {
  background: rgba(180,83,9,0.1);
  color: #92400E;
  font-size: 0.72rem;
  font-weight: 600;
  padding: 0.2em 0.55em;
  border-radius: 4px;
  display: inline-block;
}
.qv-badge--blue {
  background: rgba(67,56,202,0.1);
  color: var(--qv-indigo-aa-light);
  font-size: 0.72rem;
  font-weight: 600;
  padding: 0.2em 0.55em;
  border-radius: 4px;
  display: inline-block;
}

/* Docs footer navigation */
.qv-docs-footer-nav {
  display: flex;
  justify-content: space-between;
  margin-top: 3rem;
  padding-top: 1.75rem;
  border-top: 1px solid;
}
body.qv-page--light-top .qv-docs-footer-nav { border-top-color: var(--qv-border-light); }
body.qv-page--dark-top  .qv-docs-footer-nav { border-top-color: var(--qv-border-dark); }

.qv-docs-footer-nav__prev,
.qv-docs-footer-nav__next {
  font-size: 0.9375rem;
  font-weight: 600;
  text-decoration: none;
  transition: color 0.15s;
  display: flex;
  align-items: center;
  gap: 0.5rem;
}
body.qv-page--light-top .qv-docs-footer-nav__prev,
body.qv-page--light-top .qv-docs-footer-nav__next { color: var(--qv-accent-aa-light); }
body.qv-page--dark-top  .qv-docs-footer-nav__prev,
body.qv-page--dark-top  .qv-docs-footer-nav__next { color: var(--qv-accent-aa-dark); }

/* API method badges (shorthand for HTML api-reference page) */
.qv-api-method {
  display: inline-block;
  font-family: var(--qv-font-mono);
  font-size: 0.75rem;
  font-weight: 700;
  padding: 0.2rem 0.5rem;
  border-radius: 4px;
  margin-right: 0.625rem;
}
.qv-api-method--get    { background: rgba(4,120,87,0.1); color: var(--qv-accent-aa-light); }
.qv-api-method--post   { background: rgba(67,56,202,0.1); color: var(--qv-indigo-aa-light); }
.qv-api-method--delete { background: rgba(185,28,28,0.1); color: #B91C1C; }

.qv-api-path {
  font-family: var(--qv-font-mono);
  font-size: 0.9375rem;
  font-weight: 500;
}
body.qv-page--light-top .qv-api-path { color: var(--qv-fg-light-primary); }
body.qv-page--dark-top  .qv-api-path { color: var(--qv-fg-dark-primary); }

.qv-api-endpoint__header {
  display: flex;
  align-items: center;
  flex-wrap: wrap;
  gap: 0.5rem;
  margin-bottom: 0.75rem;
}