/* =========================================================================
   QPN Catalyst — Archetype B (long-form document) component CSS.
   Sidebar TOC + narrow doc body column + callouts + defined-term chips +
   semantic table styling + print rules.

   Load order: qpn-shared.css → qpn-cards.css → THIS FILE → styles.css

   Anchored to: docs/brief-website.md §5.2 (callouts), §5.3 (terms),
                §5.5 (sidebar TOC), §5.6 (tables), §5.7 (print), §7 (docs.js).
   ========================================================================= */

/* ── Doc shell — sticky sidebar TOC + readable body column ───────────── */
.qpn-doc {
  max-width: var(--qpn-w-doc-shell);
  margin: 0 auto;
  padding: var(--qpn-sp-7) var(--qpn-sp-7);
  display: grid;
  grid-template-columns: 220px 1fr;
  gap: var(--qpn-sp-7);
  align-items: start;
}

.qpn-doc__body {
  max-width: var(--qpn-w-doc);
  min-width: 0;  /* grid item must not stretch to its content's min-content (table/code) */
  font-family: var(--qpn-font-body);
  color: var(--qpn-ink);
  line-height: var(--qpn-lh-body);
}

/* Doc body typography — slightly stronger than marketing body */
.qpn-doc__body h1 {
  font-family: var(--qpn-font-display);
  font-size: var(--qpn-fs-display);
  font-weight: 500;
  line-height: var(--qpn-lh-tight);
  letter-spacing: -0.01em;
  color: var(--qpn-ink);
  margin: 0 0 var(--qpn-sp-3);
}

.qpn-doc__lede {
  font-family: var(--qpn-font-display);
  font-size: var(--qpn-fs-lede);
  font-weight: 400;
  line-height: var(--qpn-lh-lede);
  color: var(--qpn-ink-muted);
  margin: 0 0 var(--qpn-sp-5);
  font-style: italic;
}

.qpn-doc__download {
  font-size: var(--qpn-fs-body-sm);
  margin: 0 0 var(--qpn-sp-6);
}

.qpn-doc__download a {
  display: inline-block;
  padding: 6px 14px;
  border: 1px solid var(--qpn-rule);
  border-radius: 6px;
  background: var(--qpn-surface-faint, #fafafa);
  color: var(--qpn-ink);
  text-decoration: none;
  font-weight: 500;
}

.qpn-doc__download a:hover {
  border-color: var(--qpn-link);
  color: var(--qpn-link);
  background: #fff;
}

.qpn-doc__download a::before {
  content: "↓ ";
  font-weight: 600;
}

.qpn-doc__download-meta {
  color: var(--qpn-ink-faint);
  font-size: var(--qpn-fs-body-sm);
}

.qpn-doc__body h2 {
  font-family: var(--qpn-font-display);
  font-size: 22px;
  font-weight: 500;
  letter-spacing: -0.005em;
  color: var(--qpn-ink);
  margin: var(--qpn-sp-7) 0 var(--qpn-sp-3);
  padding-top: var(--qpn-sp-3);
  border-top: var(--qpn-rule-hair) solid var(--qpn-rule-faint);
}

/* First h2 doesn't need top border (the lede already separates from h1). */
.qpn-doc__body h2:first-of-type {
  border-top: none;
  padding-top: 0;
  margin-top: var(--qpn-sp-5);
}

.qpn-doc__body h3 {
  font-family: var(--qpn-font-display);
  font-size: 17px;
  font-weight: 500;
  color: var(--qpn-ink);
  margin: var(--qpn-sp-5) 0 var(--qpn-sp-2);
}

.qpn-doc__body h4 {
  font-family: var(--qpn-font-display);
  font-size: 15px;
  font-weight: 500;
  color: var(--qpn-ink-muted);
  margin: var(--qpn-sp-4) 0 var(--qpn-sp-1);
  letter-spacing: -0.003em;
}

.qpn-doc__body p {
  font-size: var(--qpn-fs-body);
  line-height: var(--qpn-lh-body);
  color: var(--qpn-ink);
  margin: 0 0 var(--qpn-sp-4);
}

.qpn-doc__body ul,
.qpn-doc__body ol {
  font-size: var(--qpn-fs-body);
  line-height: var(--qpn-lh-body);
  color: var(--qpn-ink);
  margin: 0 0 var(--qpn-sp-4) var(--qpn-sp-5);
  padding-left: var(--qpn-sp-3);
}

.qpn-doc__body li {
  margin-bottom: var(--qpn-sp-2);
}

.qpn-doc__body li > strong {
  color: var(--qpn-ink);
  font-weight: 600;
}

.qpn-doc__body a {
  color: var(--qpn-link);
  text-decoration: underline;
  text-decoration-thickness: 1px;
  text-underline-offset: 2px;
}
.qpn-doc__body a:hover { color: var(--qpn-link-hover); }

/* Buttons used inside doc body (e.g. the qpn-gate "Get Submission Addresses"
   CTA on /terms) need to opt out of the doc-anchor color and underline —
   otherwise the .qpn-doc__body a rule (specificity 0,1,1) wins over
   .btn--primary (0,1,0), and the link color collides with the same
   accent color used for the button background, making the label invisible. */
.qpn-doc__body a.btn,
.qpn-doc__body a.btn:hover {
  text-decoration: none;
  color: #fff;
}

/* Anchor offset under sticky nav */
.qpn-doc__body h2[id],
.qpn-doc__body h3[id] {
  scroll-margin-top: 80px;
}

/* ── Sidebar TOC ─────────────────────────────────────────────────────── */
.qpn-doc__sidebar {
  position: sticky;
  top: 80px;  /* clears sticky nav */
  align-self: start;
  max-height: calc(100vh - 100px);
  overflow-y: auto;
  font-family: var(--qpn-font-body);
}

.qpn-doc__toc-title {
  font-family: var(--qpn-font-body);
  font-size: var(--qpn-fs-label);
  letter-spacing: var(--qpn-tracking-label);
  text-transform: uppercase;
  color: var(--qpn-accent);
  font-weight: 600;
  margin: 0 0 var(--qpn-sp-3);
}

.qpn-doc__toc {
  list-style: none;
  margin: 0;
  padding: 0;
  border-left: 1px solid var(--qpn-rule);
}

.qpn-doc__toc li { margin: 0; }

.qpn-doc__toc a {
  display: block;
  padding: 6px var(--qpn-sp-3);
  margin-left: -1px;  /* overlap parent border */
  font-size: var(--qpn-fs-body-sm);
  line-height: 1.4;
  color: var(--qpn-ink-muted);
  text-decoration: none;
  border-left: 1px solid transparent;
  transition: color 0.15s ease, border-color 0.15s ease;
}

.qpn-doc__toc a:hover {
  color: var(--qpn-ink);
}

.qpn-doc__toc a[aria-current="true"] {
  color: var(--qpn-ink);
  font-weight: 500;
  border-left-color: var(--qpn-accent);
}

/* Indented H3 entries (if any) */
.qpn-doc__toc--h3 a {
  padding-left: var(--qpn-sp-5);
  font-size: 12.5px;
}

/* Desktop default: <details> is used as the always-open shell so the same
   markup serves desktop and mobile. Hide the summary; force the TOC open. */
.qpn-doc__sidebar > details > summary {
  display: none;
}
.qpn-doc__sidebar > details > .qpn-doc__toc { display: block; }

/* ── Callouts — single base + 5 semantic variants ────────────────────── */
.qpn-callout {
  margin: var(--qpn-sp-5) 0;
  padding: var(--qpn-sp-4) var(--qpn-sp-5);
  background: var(--qpn-surface-2);
  border-left: 3px solid var(--qpn-ink-faint);
  border-radius: 0 4px 4px 0;
  font-size: var(--qpn-fs-body);
  line-height: var(--qpn-lh-body);
}

.qpn-callout__label {
  display: block;
  font-family: var(--qpn-font-body);
  font-size: var(--qpn-fs-label);
  font-weight: 600;
  letter-spacing: var(--qpn-tracking-label);
  text-transform: uppercase;
  margin-bottom: var(--qpn-sp-2);
}

.qpn-callout p { margin: 0; }
.qpn-callout p + p { margin-top: var(--qpn-sp-2); }
.qpn-callout ul,
.qpn-callout ol {
  margin: var(--qpn-sp-2) 0 0 var(--qpn-sp-4);
  padding-left: 0;
}

/* Variants — accent color + matching label color (eyebrow). */
.qpn-callout--notice {
  background: #FEF3C7;            /* amber-50 */
  border-left-color: #D97706;
}
.qpn-callout--notice .qpn-callout__label { color: #78350F; }
.qpn-callout--notice { color: #78350F; }

.qpn-callout--best-practice {
  background: #ECFDF5;            /* teal-50 */
  border-left-color: #0F766E;
}
.qpn-callout--best-practice .qpn-callout__label { color: #064E3B; }

.qpn-callout--recommendation {
  background: #EFF6FF;            /* blue-50 */
  border-left-color: #2563EB;
}
.qpn-callout--recommendation .qpn-callout__label { color: #1E3A5F; }

.qpn-callout--remember {
  background: rgba(138, 107, 46, 0.08);
  border-left-color: var(--qpn-accent);
}
.qpn-callout--remember .qpn-callout__label { color: var(--qpn-accent); }

.qpn-callout--if-asked {
  background: #F5F3FF;            /* violet-50 */
  border-left-color: #7C3AED;
}
.qpn-callout--if-asked .qpn-callout__label { color: #5B21B6; }

/* ── Defined-term chip ───────────────────────────────────────────────── */
.qpn-term {
  font-style: normal;
  position: relative;
  cursor: help;
  border-bottom: 1px dotted var(--qpn-accent);
  padding-bottom: 1px;
  color: inherit;
}

/* CSS-only tooltip (fallback when JS off) */
.qpn-term:hover::after,
.qpn-term:focus::after {
  content: attr(data-gloss);
  position: absolute;
  bottom: calc(100% + 6px);
  left: 0;
  z-index: 30;
  background: var(--qpn-ink);
  color: var(--qpn-page);
  font-family: var(--qpn-font-body);
  font-size: var(--qpn-fs-body-sm);
  font-style: normal;
  font-weight: 400;
  line-height: 1.4;
  padding: var(--qpn-sp-2) var(--qpn-sp-3);
  border-radius: 4px;
  min-width: 240px;
  max-width: 360px;
  white-space: normal;
  pointer-events: none;
  box-shadow: 0 4px 12px rgba(0, 0, 0, 0.15);
}

/* JS-enhanced tooltip — same look, controlled by docs.js. */
.qpn-term[data-tooltip-open="true"]::after {
  content: attr(data-gloss);
  position: absolute;
  bottom: calc(100% + 6px);
  left: 0;
  z-index: 30;
  background: var(--qpn-ink);
  color: var(--qpn-page);
  font-family: var(--qpn-font-body);
  font-size: var(--qpn-fs-body-sm);
  font-weight: 400;
  line-height: 1.4;
  padding: var(--qpn-sp-2) var(--qpn-sp-3);
  border-radius: 4px;
  min-width: 240px;
  max-width: 360px;
  white-space: normal;
  box-shadow: 0 4px 12px rgba(0, 0, 0, 0.15);
}

/* When JS upgrades chips, suppress the CSS-only :hover tooltip so we
   don't double-render. docs.js sets data-js-enhanced="true" on the body. */
body[data-js-enhanced="true"] .qpn-term:hover::after,
body[data-js-enhanced="true"] .qpn-term:focus::after {
  content: none;
}

/* ── FAQ — each Q is a collapsible <details> ─────────────────────────── */
.qpn-faq {
  border-bottom: var(--qpn-rule-hair) solid var(--qpn-rule-faint);
  padding: var(--qpn-sp-3) 0;
}

.qpn-faq:first-of-type {
  border-top: var(--qpn-rule-hair) solid var(--qpn-rule-faint);
}

.qpn-faq > summary {
  font-family: var(--qpn-font-display);
  font-size: 17px;
  font-weight: 500;
  color: var(--qpn-ink);
  cursor: pointer;
  list-style: none;
  padding: var(--qpn-sp-2) 0;
  position: relative;
  padding-right: 28px;
}

.qpn-faq > summary::-webkit-details-marker { display: none; }

.qpn-faq > summary::after {
  content: "+";
  position: absolute;
  right: 0;
  top: var(--qpn-sp-2);
  font-family: var(--qpn-font-mono);
  font-size: 20px;
  font-weight: 400;
  color: var(--qpn-accent);
  line-height: 1;
}

.qpn-faq[open] > summary::after { content: "\2212"; /* minus */ }

.qpn-faq > summary:hover { color: var(--qpn-link); }

.qpn-faq > summary:focus-visible {
  outline: 2px solid var(--qpn-accent);
  outline-offset: 2px;
  border-radius: 2px;
}

.qpn-faq > p {
  margin: var(--qpn-sp-2) 0 var(--qpn-sp-3);
  color: var(--qpn-ink-muted);
}

/* ── Semantic tables ─────────────────────────────────────────────────── */
.qpn-table-wrap {
  overflow-x: auto;
  margin: var(--qpn-sp-5) 0;
}

.qpn-table {
  width: 100%;
  border-collapse: collapse;
  font-size: var(--qpn-fs-body-sm);
  line-height: 1.5;
}

.qpn-table th,
.qpn-table td {
  padding: var(--qpn-sp-3) var(--qpn-sp-4);
  border-bottom: var(--qpn-rule-hair) solid var(--qpn-rule);
  text-align: left;
  vertical-align: top;
}

.qpn-table thead th {
  background: var(--qpn-surface-2);
  font-family: var(--qpn-font-body);
  font-size: var(--qpn-fs-label);
  font-weight: 600;
  letter-spacing: var(--qpn-tracking-label);
  text-transform: uppercase;
  color: var(--qpn-ink-muted);
  border-bottom: 2px solid var(--qpn-rule);
}

.qpn-table tbody tr:last-child td {
  border-bottom: none;
}

/* ── Responsive ─────────────────────────────────────────────────────── */
@media (max-width: 900px) {
  .qpn-doc {
    grid-template-columns: 1fr;
    gap: var(--qpn-sp-4);
    padding: var(--qpn-sp-5) var(--qpn-sp-4);
  }

  /* Sidebar collapses to a top-of-page disclosure */
  .qpn-doc__sidebar {
    position: static;
    max-height: none;
    overflow: visible;
  }

  .qpn-doc__sidebar > details {
    background: var(--qpn-surface-2);
    border: 1px solid var(--qpn-rule);
    border-radius: 6px;
    padding: var(--qpn-sp-3) var(--qpn-sp-4);
  }

  .qpn-doc__sidebar > details > summary {
    font-family: var(--qpn-font-body);
    font-size: var(--qpn-fs-label);
    font-weight: 600;
    letter-spacing: var(--qpn-tracking-label);
    text-transform: uppercase;
    color: var(--qpn-accent);
    cursor: pointer;
    list-style: none;
  }

  .qpn-doc__sidebar > details > summary::after {
    content: " ▾";
    color: var(--qpn-ink-faint);
  }

  .qpn-doc__sidebar > details[open] > summary::after {
    content: " ▴";
  }

  .qpn-doc__sidebar > details > .qpn-doc__toc {
    margin-top: var(--qpn-sp-3);
    border-left: 1px solid var(--qpn-rule);
  }

  /* The summary already says "On this page" — hide the redundant title. */
  .qpn-doc__sidebar > details > .qpn-doc__toc-title { display: none; }
}

/* ── Print ───────────────────────────────────────────────────────────── */
@media print {
  .qpn-nav,
  .qpn-footer,
  .qpn-eco,
  .qpn-doc__sidebar { display: none !important; }

  /* Banner kept — load-bearing per brief §2. Strong rule for print. */
  .qpn-banner { border-bottom: 2px solid #000; }

  .qpn-doc {
    display: block;
    max-width: none;
    padding: 0;
  }

  .qpn-doc__body {
    max-width: none;
    font-size: 11pt;
  }

  /* Callouts: visible borders, no background tint, for print legibility. */
  .qpn-callout {
    background: transparent !important;
    border: 1px solid #000;
    border-left-width: 4px;
    color: #000;
    page-break-inside: avoid;
  }
  .qpn-callout__label { color: #000 !important; }

  /* Defined-term chips: inline gloss in parentheses */
  .qpn-term::after {
    content: " (" attr(data-gloss) ")" !important;
    position: static !important;
    background: transparent !important;
    color: inherit !important;
    font-size: inherit !important;
    padding: 0 !important;
    box-shadow: none !important;
    min-width: 0 !important;
    pointer-events: auto !important;
  }
  .qpn-term { border-bottom: none; }

  /* Tables: full borders for legibility */
  .qpn-table th, .qpn-table td { border: 1px solid #000; }
  .qpn-table thead th { background: #eee; color: #000; }

  /* Page metadata via @page */
  @page {
    margin: 1in;
  }

  a[href]::after {
    content: " <" attr(href) ">";
    font-size: 0.85em;
    color: #555;
  }
  /* Avoid noisy URL append on internal anchors */
  a[href^="#"]::after { content: ""; }

  h2, h3 { page-break-after: avoid; }
}