/* Hallmark · macrostructure: Narrative Workflow · tone: technical, austere · anchor hue: teal 190
 * genre: editorial · theme: Almanac · enrichment: none · nav: N3 (docs side-rail) · footer: Ft4
 * studied: no · pre-emit critique: P4 H4 E4 S4 R4 V4
 * contrast: pass (40–41) · slop: pass (42–45) · honest: pass (46) · chrome: pass (47)
 * tokens: pass (48) · responsive: pass (49) · mobile: pass (34, 49, 50–57) · icons: pass (30)
 */

/* base */
*, *::before, *::after { box-sizing: border-box; }

html {
  overflow-x: clip;
  -webkit-text-size-adjust: 100%;
  scroll-padding-top: calc(var(--banner-height) + 5rem);
}
html.is-locked, html.is-locked body { overflow: hidden; }
@media (prefers-reduced-motion: no-preference) {
  html { scroll-behavior: smooth; }
}

body {
  overflow-x: clip;
  margin: 0;
  background: var(--color-paper);
  color: var(--color-ink-2);
  font-family: var(--font-body);
  font-size: var(--text-base);
  line-height: 1.6;
  -webkit-font-smoothing: antialiased;
}

h1, h2, h3 {
  margin: 0;
  min-width: 0;
  overflow-wrap: anywhere;
  text-wrap: balance;
  color: var(--color-ink);
  font-family: var(--font-display);
  font-style: normal;
  font-weight: 600;
  line-height: 1.1;
  letter-spacing: -0.01em;
}
h2 { font-size: var(--text-xl); }
h3 { font-size: var(--text-lg); }

p, ul, ol, figure { margin: 0; }

code, kbd, pre { font-family: var(--font-mono); }
:not(pre) > code {
  padding: 0.05em 0.35em;
  border: var(--rule-hair) solid var(--color-rule);
  border-radius: 3px;
  background: var(--color-paper-2);
  color: var(--color-ink);
  font-size: 0.88em;
  overflow-wrap: anywhere;
}

img { display: block; max-width: 100%; height: auto; }

:focus-visible {
  outline: 2px solid var(--color-focus);
  outline-offset: 2px;
  border-radius: 2px;
}

/* utilities */
.wrap {
  width: 100%;
  max-width: var(--page-max);
  margin-inline: auto;
  padding-inline: var(--page-gutter);
}
.muted { color: var(--color-muted); font-size: var(--text-sm); }
.sr-only {
  position: absolute;
  width: 1px;
  height: 1px;
  margin: -1px;
  padding: 0;
  overflow: hidden;
  clip-path: inset(50%);
  white-space: nowrap;
  border: 0;
}
.skip {
  position: absolute;
  top: -4rem;
  left: var(--space-md);
  z-index: var(--z-modal);
  padding: var(--space-sm) var(--space-md);
  border-radius: var(--radius-sm);
  background: var(--color-accent);
  color: var(--color-accent-ink);
  text-decoration: none;
}
.skip:focus { top: var(--space-sm); }

/* links and buttons */
.link {
  color: var(--color-accent);
  text-decoration: underline;
  text-decoration-color: var(--color-rule-2);
  text-decoration-thickness: 1px;
  text-underline-offset: 0.22em;
  transition: text-decoration-color var(--dur-short) var(--ease-out);
}
@media (hover: hover) {
  .link:hover { text-decoration-color: var(--color-accent); }
}

.btn {
  display: inline-flex;
  align-items: center;
  justify-content: center;
  min-height: 44px;
  padding: 0 var(--space-md);
  border: var(--rule-hair) solid transparent;
  border-radius: var(--radius-sm);
  background: transparent;
  color: var(--color-ink);
  font: 500 var(--text-sm)/1 var(--font-body);
  white-space: nowrap;
  text-decoration: none;
  cursor: pointer;
  transition:
    background-color var(--dur-micro) var(--ease-out),
    border-color var(--dur-micro) var(--ease-out),
    color var(--dur-micro) var(--ease-out),
    transform var(--dur-micro) var(--ease-out);
}
.btn--primary { border-color: var(--color-ink); }
.btn--line { border-color: var(--color-rule-2); }
@media (hover: hover) {
  .btn--primary:hover { background: var(--color-ink); color: var(--color-paper); }
  .btn--line:hover { border-color: var(--color-accent); color: var(--color-accent); }
}
.btn:active { transform: translateY(1px); }
.btn[aria-disabled="true"], .btn:disabled { opacity: 0.5; cursor: not-allowed; pointer-events: none; }

kbd {
  display: inline-grid;
  place-items: center;
  min-width: 1.5rem;
  height: 1.5rem;
  padding: 0 var(--space-2xs);
  border: var(--rule-hair) solid var(--color-rule-2);
  border-radius: 3px;
  background: var(--color-paper);
  color: var(--color-muted);
  font-size: var(--text-xs);
}

/* wordmark */
.wordmark {
  color: var(--color-ink);
  font-family: var(--font-display);
  font-size: var(--text-lg);
  font-weight: 600;
  letter-spacing: -0.01em;
}

/* side rail (N3, docs variant): index + filter */
.rail {
  display: flex;
  flex-direction: column;
  gap: var(--space-md);
  padding: var(--space-md) var(--page-gutter);
  border-bottom: var(--rule-hair) solid var(--color-rule);
  background: var(--color-paper);
}
.rail__head { display: flex; align-items: center; justify-content: space-between; gap: var(--space-md); }
.rail__close { display: none; }
.rail__brand {
  display: inline-flex;
  align-items: center;
  gap: var(--space-xs);
  min-height: 44px;
  color: var(--color-ink);
  text-decoration: none;
}
.rail__search { position: relative; }
.rail__input {
  width: 100%;
  height: 44px;
  padding: 0 var(--space-xl) 0 var(--space-sm);
  border: var(--rule-hair) solid var(--color-rule-2);
  border-radius: var(--radius-md);
  background: var(--color-paper-2);
  color: var(--color-ink);
  font: 400 var(--text-sm)/1 var(--font-body);
  outline: 2px solid transparent;
  outline-offset: 1px;
  transition: border-color var(--dur-micro) var(--ease-out);
}
.rail__input::placeholder { color: var(--color-muted); }
@media (hover: hover) {
  .rail__input:hover { border-color: var(--color-muted); }
}
.rail__input:focus-visible { border-color: var(--color-focus); outline-color: var(--color-focus); }
.rail__input:disabled { opacity: 0.55; cursor: not-allowed; }
.rail__kbd { position: absolute; top: 0; right: var(--space-sm); bottom: 0; height: 1.5rem; margin-block: auto; pointer-events: none; }
@media (hover: none) { .rail__kbd { display: none; } }
.rail__nav { display: grid; gap: var(--space-xs); }
.rail__group {
  padding: var(--space-sm) 0 var(--space-2xs);
  color: var(--color-muted);
  font: 500 var(--text-xs)/1 var(--font-mono);
  letter-spacing: 0.06em;
  text-transform: uppercase;
}
.rail__list { padding: 0; list-style: none; }
.rail__list li[hidden], .rail__sec[hidden] { display: none; }
.rail__link {
  display: flex;
  align-items: center;
  min-height: 44px;
  padding: 0 var(--space-xs);
  border-radius: var(--radius-sm);
  color: var(--color-ink-2);
  font-size: var(--text-sm);
  text-decoration: none;
  white-space: nowrap;
  transition: background-color var(--dur-micro) var(--ease-out), color var(--dur-micro) var(--ease-out);
}
.rail__link::before {
  content: "";
  flex: none;
  width: 6px;
  height: 6px;
  margin-right: var(--space-xs);
  background: transparent;
}
.rail__link--cmd { font-family: var(--font-mono); font-size: var(--text-xs); }
@media (hover: hover) {
  .rail__link:hover { background: var(--color-paper-2); color: var(--color-ink); }
}
.rail__link:active { background: var(--color-accent-tint); }
.rail__link[aria-current="true"] { color: var(--color-ink); font-weight: 500; }
.rail__link[aria-current="true"]::before { background: var(--color-accent); }
.rail__empty { padding: var(--space-xs); color: var(--color-muted); font-size: var(--text-sm); }
.rail__foot { display: flex; flex-direction: column; align-items: flex-start; gap: var(--space-xs); margin-top: auto; padding-top: var(--space-md); }

.topbar { display: none; }

@media (max-width: 59.99rem) {
  .js .topbar {
    position: sticky;
    top: 0;
    z-index: var(--z-sticky-nav);
    display: flex;
    align-items: center;
    justify-content: space-between;
    gap: var(--space-md);
    height: var(--banner-height);
    padding-inline: var(--page-gutter);
    border-bottom: var(--rule-hair) solid var(--color-rule);
    background: var(--color-paper);
  }
  .js .rail {
    position: fixed;
    inset: 0;
    z-index: var(--z-modal);
    overflow-y: auto;
    visibility: hidden;
    opacity: 0;
    border-bottom: 0;
    transition: opacity var(--dur-short) var(--ease-out), visibility 0s linear var(--dur-short);
  }
  .js .rail.is-open { visibility: visible; opacity: 1; transition: opacity var(--dur-short) var(--ease-out), visibility 0s; }
  .js .rail__close { display: inline-flex; }
}

@media (min-width: 60rem) {
  .rail {
    position: fixed;
    inset: 0 auto 0 0;
    z-index: var(--z-sticky-nav);
    width: var(--rail-width);
    padding: var(--space-md);
    overflow-y: auto;
    border-right: var(--rule-hair) solid var(--color-rule);
    border-bottom: 0;
  }
  .rail__link { min-height: 32px; }
  .page { margin-left: var(--rail-width); }
}

.page { min-width: 0; }

/* sections */
.section { padding-block: var(--space-2xl) var(--space-xl); }
.sticky-head {
  margin-bottom: var(--space-md);
  padding-bottom: var(--space-xs);
  border-bottom: var(--rule-hair) solid var(--color-ink);
}
@media (min-width: 48rem) {
  .sticky-head {
    position: sticky;
    top: var(--banner-height);
    z-index: var(--z-sticky);
    padding-top: var(--space-sm);
    background: var(--color-paper);
  }
}
.lede { max-width: 60ch; margin-bottom: var(--space-xl); color: var(--color-ink-2); font-size: var(--text-md); line-height: 1.55; }
.note { max-width: 60ch; margin-top: var(--space-lg); color: var(--color-muted); font-size: var(--text-sm); }

/* hero */
.hero {
  display: grid;
  grid-template-columns: minmax(0, 1fr);
  gap: var(--space-xl);
  align-items: center;
  padding-block: var(--space-xl) var(--space-2xl);
}
.hero__copy { display: grid; gap: var(--space-lg); min-width: 0; }
.hero .lede { margin-bottom: 0; }
.hero h1 {
  font-size: var(--text-display-s);
  line-height: 1.02;
  letter-spacing: -0.02em;
}
.hero__cta { display: flex; flex-wrap: wrap; align-items: center; gap: var(--space-lg); }
.hero__meta { max-width: 52ch; color: var(--color-muted); font-size: var(--text-sm); }
.hero__demo { min-width: 0; }
@media (min-width: 72rem) {
  .hero {
    grid-template-columns: minmax(0, 1.05fr) minmax(0, 1fr);
    gap: var(--space-2xl);
    padding-block: var(--space-2xl) var(--space-3xl);
  }
}

/* workflow overview */
.flow {
  display: grid;
  grid-template-columns: minmax(0, 1fr);
  gap: var(--space-lg);
  padding: 0;
  list-style: none;
}
.flow__step {
  position: relative;
  display: grid;
  gap: var(--space-3xs);
  padding-top: var(--space-sm);
  border-top: var(--rule-hair) solid var(--color-ink);
}
.flow__step:not(:last-child)::after {
  content: "↓";
  content: "↓" / "";
  position: absolute;
  top: var(--space-xs);
  right: 0;
  color: var(--color-muted);
  font-family: var(--font-mono);
}
.flow__n { color: var(--color-muted); font: 500 var(--text-xs)/1.6 var(--font-mono); }
.flow__cmd {
  color: var(--color-ink);
  font-family: var(--font-display);
  font-size: var(--text-lg);
  font-weight: 600;
  text-decoration: none;
  white-space: nowrap;
  transition: color var(--dur-micro) var(--ease-out);
}
@media (hover: hover) {
  .flow__cmd:hover { color: var(--color-accent); }
}
.flow__out { color: var(--color-muted); font: 400 var(--text-xs)/1.6 var(--font-mono); }
@media (min-width: 40rem) {
  .flow { grid-template-columns: repeat(2, minmax(0, 1fr)); gap: var(--space-lg) var(--space-xl); }
  .flow__step:not(:last-child)::after { content: "→"; content: "→" / ""; }
  .flow__step:nth-child(2)::after { content: ""; }
}
@media (min-width: 72rem) {
  .flow { grid-template-columns: repeat(4, minmax(0, 1fr)); }
  .flow__step:nth-child(2)::after { content: "→"; content: "→" / ""; }
}
.intro { display: grid; gap: var(--space-md); max-width: 60ch; margin-bottom: var(--space-xl); }
.diagram {
  display: grid;
  gap: var(--space-lg);
  min-width: 0;
  margin: 0;
  padding: var(--space-lg);
  border: var(--rule-hair) dashed var(--color-rule-2);
  border-radius: var(--radius-md);
}
.diagram__zone { color: var(--color-muted); font: 400 var(--text-xs)/1.6 var(--font-mono); }
.diagram__zone code { padding: 0; border: 0; background: none; color: inherit; font-size: inherit; }
.diagram__list { display: grid; padding: 0; list-style: none; }
.diagram__list li {
  display: grid;
  grid-template-columns: minmax(0, 1fr);
  gap: var(--space-3xs);
  padding-block: var(--space-sm);
  border-top: var(--rule-hair) dashed var(--color-rule-2);
  font-size: var(--text-sm);
}
.diagram__tag { color: var(--color-muted); font: 500 var(--text-xs)/1.6 var(--font-mono); letter-spacing: 0.06em; text-transform: uppercase; }
@media (min-width: 40rem) {
  .diagram__list li { grid-template-columns: 6rem minmax(0, 1fr); gap: var(--space-sm); align-items: baseline; }
}

/* install tabs */
.tabs { max-width: 46rem; }
.tablist {
  display: none;
  gap: var(--space-2xs);
  margin-bottom: var(--space-lg);
  overflow-x: auto;
  overflow-y: hidden;
  box-shadow: inset 0 -1px 0 var(--color-rule-2);
  scrollbar-width: none;
}
.js .tablist { display: flex; }
.tab {
  appearance: none;
  flex: none;
  min-height: 44px;
  padding: 0 var(--space-md);
  border: 0;
  border-bottom: 2px solid transparent;
  background: transparent;
  color: var(--color-muted);
  font: 500 var(--text-sm)/1 var(--font-body);
  white-space: nowrap;
  cursor: pointer;
  transition: color var(--dur-micro) var(--ease-out), border-color var(--dur-micro) var(--ease-out);
}
@media (hover: hover) {
  .tab:hover { color: var(--color-ink); }
}
.tab:active { transform: translateY(1px); }
.tab:first-child { padding-left: 0; }
.tab[aria-selected="true"] { border-bottom-color: var(--color-accent); color: var(--color-ink); }
.tab:disabled { opacity: 0.5; cursor: not-allowed; }

.panel { display: grid; gap: var(--space-md); }
.panel + .panel { margin-top: var(--space-xl); }
.js .panel { margin-top: 0; }
.panel[hidden] { display: none; }
.panel__title { font-size: var(--text-lg); }
.js .panel__title {
  position: absolute;
  width: 1px;
  height: 1px;
  overflow: hidden;
  clip-path: inset(50%);
}
.panel__step, .panel__alt { max-width: 60ch; }
.panel__alt { color: var(--color-muted); }

/* code surface */
.code {
  min-width: 0;
  border: var(--rule-hair) solid var(--color-rule-2);
  border-radius: var(--radius-md);
  background: var(--color-code-bg);
  color: var(--color-ink);
  font-size: var(--text-sm);
}
.code__bar {
  display: flex;
  align-items: center;
  justify-content: space-between;
  gap: var(--space-md);
  min-height: 40px;
  padding: 0 var(--space-md);
  border-bottom: var(--rule-hair) solid var(--color-rule);
}
.code__name {
  color: var(--color-muted);
  font: 400 var(--text-xs)/1.4 var(--font-mono);
  overflow-wrap: anywhere;
}
.code__pre {
  margin: 0;
  padding: var(--space-md);
  overflow-x: auto;
  font-size: inherit;
  line-height: 1.7;
  tab-size: 2;
  white-space: pre;
}
.code__pre code { font-size: inherit; }
.code__split { padding-top: var(--space-sm); border-top: var(--rule-hair) solid var(--color-rule); }
.code__split .code__name { display: block; padding-inline: var(--space-md); }
.code__pre--flush { padding-top: var(--space-xs); }
.k { color: var(--color-accent); }
.c { color: var(--color-muted); }

.copy {
  position: relative;
  display: none;
  flex: none;
  padding: var(--space-xs) var(--space-sm);
  border: var(--rule-hair) solid var(--color-rule-2);
  border-radius: var(--radius-sm);
  background: transparent;
  color: var(--color-muted);
  font: 500 var(--text-xs)/1 var(--font-mono);
  white-space: nowrap;
  cursor: pointer;
  transition:
    color var(--dur-micro) var(--ease-out),
    border-color var(--dur-micro) var(--ease-out),
    transform var(--dur-micro) var(--ease-out);
}
.js .copy { display: inline-block; }
.copy::before { content: ""; position: absolute; inset: -8px; }
@media (hover: hover) {
  .copy:hover { border-color: var(--color-accent); color: var(--color-ink); }
}
.copy:active { transform: translateY(1px); }
.copy:disabled { opacity: 0.5; cursor: not-allowed; }
.copy[data-state="ok"] { border-color: var(--color-ok); color: var(--color-ok); }
.copy[data-state="error"] { border-color: var(--color-err); color: var(--color-err); }

/* usage stages */
.stage {
  display: grid;
  grid-template-columns: minmax(0, 1fr);
  gap: var(--space-lg);
  padding-block: var(--space-lg) var(--space-2xl);
  border-top: var(--rule-hair) solid var(--color-ink);
}
.stage__text { display: grid; gap: var(--space-md); align-content: start; max-width: 34rem; min-width: 0; }
.stage__title { display: flex; flex-wrap: wrap; align-items: baseline; gap: 0 var(--space-sm); }
.stage__n {
  color: var(--color-muted);
  font-family: var(--font-mono);
  font-size: var(--text-base);
  font-weight: 500;
  transition: color var(--dur-short) var(--ease-out);
}
.stage.is-current .stage__n { color: var(--color-accent); }
.stage__cmd { overflow-wrap: anywhere; }
.stage__cmd code {
  padding: 0;
  border: 0;
  background: none;
  color: var(--color-accent);
  font-size: var(--text-base);
}
@media (min-width: 72rem) {
  .stage { grid-template-columns: minmax(0, 5fr) minmax(0, 6fr); gap: var(--space-2xl); align-items: start; }
}

/* status lifecycle */
.life {
  display: grid;
  grid-template-columns: minmax(0, 1fr);
  gap: var(--space-lg);
  padding: 0;
  list-style: none;
}
.life__item { position: relative; display: grid; gap: var(--space-xs); align-content: start; }
.life__by { color: var(--color-muted); font-size: var(--text-sm); }
.chip {
  position: relative;
  z-index: var(--z-base);
  justify-self: start;
  padding: var(--space-xs) var(--space-sm);
  border: var(--rule-hair) solid var(--color-rule-2);
  border-radius: var(--radius-sm);
  background: var(--color-paper);
  color: var(--color-ink);
  font: 500 var(--text-sm)/1 var(--font-mono);
}
.life__item:last-child .chip { border-color: var(--color-accent); color: var(--color-accent); }
@media (min-width: 40rem) {
  .life { grid-template-columns: repeat(4, minmax(0, 1fr)); }
  .life__item:not(:last-child)::before {
    content: "";
    position: absolute;
    top: var(--space-md);
    left: 0;
    right: calc(var(--space-lg) * -1);
    height: var(--rule-hair);
    background: var(--color-rule-2);
  }
}

/* text + code sections */
.hooks { display: grid; grid-template-columns: minmax(0, 1fr); gap: var(--space-xl); }
.hooks__text { display: grid; gap: var(--space-md); align-content: start; min-width: 0; }
.hookflow { display: grid; margin: var(--space-sm) 0 0; padding: 0; list-style: none; border-top: var(--rule-hair) solid var(--color-rule-2); }
.hookflow li {
  display: flex;
  align-items: baseline;
  justify-content: space-between;
  gap: var(--space-md);
  padding: var(--space-sm) 0;
  border-bottom: var(--rule-hair) solid var(--color-rule-2);
}
.hookflow li:nth-child(2) .hookflow__t { color: var(--color-accent); }
.hookflow__t { color: var(--color-ink); font-size: var(--text-sm); font-weight: 600; white-space: nowrap; }
.hookflow__d { color: var(--color-muted); font-size: var(--text-sm); text-align: end; }
.plain { align-content: start; display: grid; padding: 0; list-style: none; }
.plain li { padding-block: var(--space-sm); border-top: var(--rule-hair) solid var(--color-rule-2); }
.plain li:last-child { border-bottom: var(--rule-hair) solid var(--color-rule-2); }
@media (min-width: 72rem) {
  .hooks { grid-template-columns: minmax(0, 5fr) minmax(0, 6fr); gap: var(--space-2xl); align-items: start; }
}

/* footer (Ft4: dense colophon) */
.foot { padding-block: var(--space-xl) var(--space-2xl); }
.foot__colophon {
  max-width: 72ch;
  padding-top: var(--space-md);
  border-top: var(--rule-hair) solid var(--color-ink);
  color: var(--color-muted);
  font: 400 var(--text-xs)/1.8 var(--font-mono);
}
.foot__colophon .link { white-space: nowrap; }

@media (prefers-reduced-motion: reduce) {
  *, *::before, *::after { transition-duration: 0.01ms !important; animation-duration: 0.01ms !important; }
}