/* PipeHat Guide: same paper-and-ink tokens as the app (app.css), laid out for reading. */

.guide-top {
  display: flex; align-items: center; gap: calc(var(--u) * 4); flex-wrap: wrap;
  padding: calc(var(--u) * 2.5) max(16px, env(safe-area-inset-right, 0px)) calc(var(--u) * 2.5) max(16px, env(safe-area-inset-left, 0px));
  border-bottom: 1px solid var(--rule); background: var(--paper);
  position: sticky; top: env(safe-area-inset-top, 0px); z-index: 10;
}
.guide-top .spacer { flex: 1; }
.guide-top a.wordmark-name { color: inherit; text-decoration: none; }
.guide-nav { display: flex; gap: calc(var(--u) * 5); font-size: 13.5px; }
.guide-nav a { color: var(--ink-2); text-decoration: none; }
.guide-nav a:hover { color: var(--ink); }

.guide {
  display: grid; grid-template-columns: 210px minmax(0, 780px); gap: calc(var(--u) * 12);
  max-width: 1120px; margin: 0 auto;
  padding-block: calc(var(--u) * 10) calc(var(--u) * 24);
  padding-left: max(16px, env(safe-area-inset-left, 0px)); padding-right: max(16px, env(safe-area-inset-right, 0px));
}

.toc { position: sticky; top: 76px; align-self: start; display: grid; gap: calc(var(--u) * 1); font-size: 13px; }
.toc .toc-label { font-size: 11px; font-weight: 600; letter-spacing: 0.5px; text-transform: uppercase; color: var(--ink-3); margin-bottom: calc(var(--u) * 1); }
.toc a { color: var(--ink-2); text-decoration: none; padding: 3px 0 3px calc(var(--u) * 3); border-left: 2px solid transparent; }
.toc a:hover { color: var(--ink); border-left-color: var(--rule-strong); }
.toc a:focus-visible { outline: 2px solid var(--focus); outline-offset: 2px; }

.guide main { min-width: 0; display: grid; gap: calc(var(--u) * 16); }
.guide-hero { display: grid; gap: calc(var(--u) * 3); }
.guide-hero .eyebrow { font-family: var(--mono); font-size: 12px; color: var(--ink-3); letter-spacing: 0.3px; }
.guide-hero .eyebrow i { font-style: normal; color: var(--wire); }
.guide-hero h1 { margin: 0; font-size: 32px; line-height: 1.15; letter-spacing: -0.6px; font-weight: 700; text-wrap: balance; }
.guide-hero p { margin: 0; font-size: 16px; color: var(--ink-2); max-width: 62ch; line-height: 1.55; }
.guide-hero .btn-group { margin-top: calc(var(--u) * 2); flex-wrap: wrap; }
.guide-hero a.btn { text-decoration: none; }

/* parse -> decode -> validate: three cells joined like fields in a segment */
.guide .pipeline {
  list-style: none; padding: 0; margin: calc(var(--u) * 1) 0 0; gap: 0;
  display: grid; grid-template-columns: repeat(3, minmax(0, 1fr));
  border: 1px solid var(--rule); border-radius: 6px; background: var(--paper-raised);
}
.guide .pipeline > li { padding: calc(var(--u) * 3) calc(var(--u) * 4); display: grid; gap: calc(var(--u) * 1.5); align-content: start; max-width: none; }
.guide .pipeline > li + li { border-left: 1px solid var(--rule-soft); }
.guide .pipeline .step { font-family: var(--mono); font-size: 12.5px; font-weight: 700; letter-spacing: 0.3px; text-transform: uppercase; color: var(--ink); }
.guide .pipeline .step i { font-style: normal; font-weight: 500; color: var(--wire); margin-right: 4px; }
.guide .pipeline p { font-size: 13px; line-height: 1.5; color: var(--ink-2); }

.guide section { display: grid; gap: calc(var(--u) * 4); scroll-margin-top: 80px; }
.guide h2 { margin: 0; font-size: 22px; letter-spacing: -0.3px; font-weight: 650; display: flex; align-items: baseline; gap: calc(var(--u) * 3); flex-wrap: wrap; text-wrap: balance; }
.guide h2 .num { font-family: var(--mono); font-size: 13px; color: var(--ink-4); font-weight: 500; }
.guide h3 { margin: calc(var(--u) * 2) 0 0; font-size: 15px; font-weight: 650; }
.guide p, .guide li { font-size: 14.5px; line-height: 1.6; color: var(--ink); max-width: 68ch; }
.guide p { margin: 0; }
.guide ul, .guide ol { margin: 0; padding-left: 22px; display: grid; gap: calc(var(--u) * 1.5); }
.guide code, .guide kbd {
  font-family: var(--mono); font-size: 12.5px; padding: 1px 5px; border-radius: 3px;
  background: var(--paper-inset); border: 1px solid var(--rule-soft); white-space: nowrap;
}
.guide kbd { border-bottom-width: 2px; }
.guide strong { font-weight: 650; }
.guide .nowrap { white-space: nowrap; }
.guide main a:not(.btn) { color: var(--ink); text-decoration-color: var(--rule-strong); text-underline-offset: 2px; }
.guide main a:not(.btn):hover { text-decoration-color: var(--ink); }
.lede { color: var(--ink-2); }

.tier-tag {
  display: inline-block; font-family: var(--sans); font-size: 11px; font-weight: 600; letter-spacing: 0.3px;
  padding: 2px 8px; border-radius: 10px; background: var(--fit-wash); color: var(--fit); white-space: nowrap;
}
.tier-tag.biz { background: var(--guard-wash); color: var(--guard); }
.tier-tag.all { background: var(--rule-soft); color: var(--ink-2); }

figure.shot { margin: 0; display: grid; gap: calc(var(--u) * 2); }
figure.shot img {
  display: block; width: 100%; height: auto; max-width: 100%;
  border: 1px solid var(--rule); border-radius: 6px; background: var(--paper-raised);
  box-shadow: 0 6px 24px rgba(0, 0, 0, 0.06);
}
figure.shot a { display: block; cursor: zoom-in; }
figure.shot figcaption { font-size: 12.5px; color: var(--ink-3); max-width: 70ch; }

.try { font-size: 13px; color: var(--ink-2); }
.guide .try a { color: var(--ink); font-weight: 600; text-decoration: none; border-bottom: 2px solid var(--highlighter); }
.guide .try a:hover { background: var(--highlighter); }

.callout { padding: calc(var(--u) * 3) calc(var(--u) * 4); border-radius: 6px; background: var(--note-wash); color: var(--ink-2); font-size: 13.5px; line-height: 1.55; max-width: 68ch; }
.callout strong { color: var(--ink); }
.callout.warn { background: var(--caution-wash); }

.table-wrap { overflow-x: auto; max-width: 100%; border: 1px solid var(--rule); border-radius: 6px; background: var(--paper-raised); }
.guide table { width: 100%; border-collapse: collapse; font-size: 13.5px; }
.guide th, .guide td { text-align: left; vertical-align: top; padding: calc(var(--u) * 2.5) calc(var(--u) * 3); border-bottom: 1px solid var(--rule-soft); }
.guide thead th { font-size: 11px; font-weight: 600; letter-spacing: 0.4px; text-transform: uppercase; color: var(--ink-3); border-bottom: 1px solid var(--rule); white-space: nowrap; }
.guide tbody tr:last-child td, .guide tbody tr:last-child th { border-bottom: 0; }
.guide tbody th { font-weight: 600; white-space: nowrap; }
.guide td .muted { color: var(--ink-3); }
.check { color: var(--fit); font-weight: 700; }
.dash { color: var(--ink-4); }

.steps { counter-reset: step; list-style: none; padding: 0 !important; }
.steps > li { counter-increment: step; display: grid; grid-template-columns: 28px 1fr; gap: calc(var(--u) * 2); }
.steps > li::before {
  content: counter(step); font-family: var(--mono); font-size: 12px; font-weight: 600; color: var(--ink-2);
  width: 22px; height: 22px; border-radius: 50%; display: grid; place-items: center; background: var(--paper-inset); border: 1px solid var(--rule);
}

.guide-foot { border-top: 1px solid var(--rule); padding-top: calc(var(--u) * 5); color: var(--ink-3); font-size: 12px; display: grid; gap: calc(var(--u) * 1.5); }
.guide-foot a { color: var(--ink-2); }

@media (max-width: 900px) {
  .guide { grid-template-columns: 1fr; gap: calc(var(--u) * 8); padding-block: calc(var(--u) * 6) calc(var(--u) * 16); }
  .toc { position: static; grid-template-columns: repeat(auto-fill, minmax(150px, 1fr)); gap: 0 calc(var(--u) * 4); padding: calc(var(--u) * 3); border: 1px solid var(--rule); border-radius: 6px; }
  .toc .toc-label { grid-column: 1 / -1; }
  .guide-hero h1 { font-size: 26px; }
  .guide .pipeline { grid-template-columns: 1fr; }
  .guide .pipeline > li + li { border-left: 0; border-top: 1px solid var(--rule-soft); }
  .guide main { gap: calc(var(--u) * 12); }
}

@media (prefers-reduced-motion: no-preference) {
  html { scroll-behavior: smooth; }
}