/* ============================================================
   Implementation guide (/build/guide/): sidebar layout, callouts,
   pager, one-page print view. Builds on the tokens and prose
   styles in style.css.
   ============================================================ */

/* ---------- Layout ---------- */
.page-content.guide > .container { max-width: var(--container); }
.guide__shell {
  display: grid;
  grid-template-columns: 260px minmax(0, var(--container-prose));
  column-gap: clamp(var(--sp-6), 5vw, var(--sp-8));
  align-items: start;
}
/* Grid children default to min-width:auto, so a wide <pre> or table would
   stretch the column past the viewport without this. */
.guide__article { min-width: 0; }
.guide__article h1 { margin-top: 0; }
.guide :is(h2, h3, h4)[id] { scroll-margin-top: calc(72px + var(--sp-5)); }

/* ---------- Sidebar ---------- */
.guide__drawer {
  position: sticky;
  top: calc(72px + var(--sp-5));
  max-height: calc(100vh - 72px - var(--sp-6));
  overflow-y: auto;
}
.guide__drawer-summary { display: none; list-style: none; }
.guide__drawer-summary::-webkit-details-marker { display: none; }
.guide__nav-section { color: var(--fg-3); margin: 0 0 var(--sp-2) 10px; }
.guide__nav-list,
.guide__nav-sub { list-style: none; padding: 0; margin: 0 0 var(--sp-5); }
.guide__nav li { padding: 0; font-size: 15px; line-height: 1.4; }
.guide__nav-link {
  display: block;
  padding: 6px 10px;
  border-radius: var(--r-xs);
  color: var(--fg-2);
  text-decoration: none;
  font-weight: var(--fw-medium);
}
.guide__nav-link:hover { background: var(--ss-cream); color: var(--fg-1); }
.guide__nav-link.is-active {
  background: var(--ss-coral-wash);
  color: var(--accent-deep);
  font-weight: var(--fw-semibold);
}
.guide__nav-sub {
  margin: var(--sp-1) 0 var(--sp-2) var(--sp-3);
  padding-left: var(--sp-3);
  border-left: 2px solid var(--line);
}
.guide__nav-sub li { font-size: var(--fs-small); }
.guide__nav-sub a {
  display: block;
  padding: 3px 0;
  color: var(--fg-3);
  text-decoration: none;
}
.guide__nav-sub a:hover { color: var(--accent-deep); }

/* ---------- Previous / next ---------- */
.guide__pager {
  display: grid;
  grid-template-columns: 1fr 1fr;
  gap: var(--sp-4);
  margin-top: var(--sp-8);
  padding-top: var(--sp-6);
  border-top: 1px solid var(--line);
}
.guide__pager-link {
  display: flex;
  flex-direction: column;
  gap: var(--sp-1);
  padding: var(--sp-4);
  background: var(--bg-elev);
  border: 1px solid var(--line);
  border-radius: var(--r-md);
  text-decoration: none;
  transition: border-color var(--t-base) var(--ease-out);
}
.guide__pager-link:hover { border-color: var(--ss-coral); }
.guide__pager-link--next { grid-column: 2; text-align: right; }
.guide__pager-label {
  font-size: var(--fs-micro);
  font-weight: var(--fw-bold);
  letter-spacing: var(--ls-eyebrow);
  text-transform: uppercase;
  color: var(--fg-3);
}
.guide__pager-title { font-weight: var(--fw-semibold); color: var(--fg-1); }

/* ---------- Content primitives ---------- */
.callout {
  margin: 0 0 var(--sp-5);
  padding: var(--sp-4) var(--sp-5);
  background: var(--bg-elev);
  border: 1px solid var(--line);
  border-left: 4px solid var(--accent);
  border-radius: var(--r-sm);
}
.callout > :last-child { margin-bottom: 0; }
.page-content .callout p,
.page-content .callout li { font-size: 16px; }
.callout__title {
  margin: 0 0 var(--sp-2);
  font-size: var(--fs-micro);
  font-weight: var(--fw-bold);
  letter-spacing: var(--ls-eyebrow);
  text-transform: uppercase;
  color: var(--fg-2);
}
.callout--tip { border-left-color: var(--ss-good); }
.callout--note { border-left-color: var(--ss-powder-deep); background: var(--ss-powder-wash); }
.callout--warn { border-left-color: var(--ss-warn); }
.callout--example { border-left-color: var(--ss-coral); background: var(--ss-coral-wash); }

.page-content video {
  display: block;
  width: 100%;
  height: auto;
  margin: 0;
  background: var(--ss-espresso);
  border-radius: var(--r-md);
  box-shadow: var(--shadow-2);
}
.page-content figure { margin: 0 0 var(--sp-5); }
.page-content figcaption {
  margin-top: var(--sp-2);
  font-size: var(--fs-small);
  color: var(--fg-3);
}

/* Use-case and role cards reuse .hub-card inside the article column, so the
   viewport breakout from style.css must not apply here. */
.guide .hub-cards {
  width: auto;
  margin-inline: 0;
  grid-template-columns: repeat(2, minmax(0, 1fr));
}
.guide .hub-card h3 { margin-top: 0; }
.guide .hub-card p { font-size: 15px; }
.guide .hub-card ul { font-size: 15px; margin: 0; padding-left: 1.2em; }
.guide .hub-card li { font-size: 15px; padding: 2px 0; }
.guide div.hub-card:hover {
  transform: none;
  box-shadow: var(--shadow-1);
  border-color: var(--line);
}

/* Reading paths and role tables stay compact. */
.guide .table-scroll table { font-size: 14px; }

/* ---------- Narrow screens ---------- */
@media (max-width: 900px) {
  .guide__shell { grid-template-columns: minmax(0, 1fr); }
  .guide__drawer {
    position: static;
    max-height: none;
    overflow: visible;
    margin-bottom: var(--sp-5);
    background: var(--bg-elev);
    border: 1px solid var(--line);
    border-radius: var(--r-sm);
  }
  .guide__drawer-summary {
    display: flex;
    align-items: center;
    justify-content: space-between;
    padding: var(--sp-3) var(--sp-4);
    font-weight: var(--fw-semibold);
    cursor: pointer;
  }
  .guide__drawer-summary::after {
    content: "";
    width: 8px;
    height: 8px;
    border-right: 2px solid var(--fg-2);
    border-bottom: 2px solid var(--fg-2);
    transform: rotate(45deg);
    transition: transform var(--t-fast) var(--ease-out);
  }
  .guide__drawer[open] .guide__drawer-summary::after { transform: rotate(-135deg); }
  .guide__nav { padding: 0 var(--sp-4) var(--sp-2); }
  .guide__pager { grid-template-columns: 1fr; }
  .guide__pager-link--next { grid-column: auto; }
}
@media (max-width: 560px) {
  .guide .hub-cards { grid-template-columns: 1fr; }
}

/* ---------- One-page view (/build/guide/all/) ---------- */
.guide-print__actions {
  display: flex;
  flex-wrap: wrap;
  align-items: center;
  gap: var(--sp-4);
  margin: 0 0 var(--sp-5);
}
.guide-print__actions a { font-weight: var(--fw-semibold); color: var(--accent-deep); }
.guide-print__toc {
  columns: 2;
  column-gap: var(--sp-6);
  margin: 0 0 var(--sp-6);
  padding-left: 2.2em;
}
.page-content .guide-print__toc li { font-size: 15px; padding: 2px 0; break-inside: avoid; }
.guide-print__chapter {
  margin-top: var(--sp-8);
  padding-top: var(--sp-6);
  border-top: 1px solid var(--line);
}
.guide-print__chapter > h2 { margin-top: 0; }

/* ---------- Print ---------- */
@media print {
  @page { margin: 18mm; }
  body { background: #fff; color: #000; font-size: 11pt; }
  .nav,
  .site-footer,
  .guide__drawer,
  .guide__pager,
  .guide-print__actions,
  .heading-anchor,
  video { display: none !important; }
  .page-content { padding: 0; }
  .page-content > .container { max-width: none; padding: 0; }
  .guide__shell { display: block; }
  .guide-print__chapter { break-before: page; margin: 0; padding: 0; border: 0; }
  .guide-print__toc { columns: 1; }
  h1, h2, h3, h4 { break-after: avoid; }
  .callout, pre, .table-scroll, figure, .hub-card { break-inside: avoid; }
  /* Browsers drop backgrounds by default, which would leave cream text on a white page. */
  .page-content pre:not(.mermaid) {
    background: #fff !important;
    color: #000 !important;
    border: 1px solid #999;
    white-space: pre-wrap;
    word-break: break-word;
  }
  .page-content code { background: none; border: 0; padding: 0; }
  .callout, .hub-card { background: #fff; border-color: #999; box-shadow: none; }
  .table-scroll { overflow: visible; border: 0; }
  a { color: inherit; text-decoration: none; }
  .page-content p a[href^="http"]::after {
    content: " (" attr(href) ")";
    font-size: 0.85em;
    color: #555;
  }
}