/* ============================================================================
   How-to-use guide — loaded only by how-to-use.html.
   Inherits every token from styles.css; this file adds the step layout, the
   drawn UI mock-ups, and the two model-setup cards.
   ========================================================================== */

.guide { padding: 130px 0 90px; }
.guide-head { max-width: 74ch; }
.guide h1 {
  font-size: clamp(36px, 5vw, 60px);
  font-weight: 800;
  line-height: 1.06;
  letter-spacing: -0.028em;
  margin: 10px 0 18px;
}
.guide-lede { font-size: 18px; color: var(--dim); max-width: 66ch; }
.guide-sub { color: var(--dim); max-width: 62ch; margin: 0 auto 6px; }

/* ---- contents ---------------------------------------------------------- */
.toc {
  list-style: none;
  padding: 0;
  margin: 36px 0 0;
  display: grid;
  grid-template-columns: repeat(2, minmax(0, 1fr));
  gap: 8px 20px;
}
.toc a {
  display: flex;
  align-items: center;
  gap: 12px;
  padding: 11px 14px;
  border-radius: var(--r-card);
  border: 1px solid transparent;
  font-size: 14.5px;
  color: var(--dim);
  transition: color .3s var(--ease), border-color .3s var(--ease), background .3s var(--ease);
}
.toc a:hover { color: var(--text); border-color: var(--border); background: rgba(240, 195, 74, .04); }
.toc span {
  flex: none;
  width: 24px;
  height: 24px;
  border-radius: 50%;
  display: grid;
  place-items: center;
  font-size: 12px;
  font-weight: 700;
  color: var(--gold);
  border: 1px solid var(--border-hi);
}

/* ---- a step: text beside a visual, alternating ------------------------- */
.step {
  display: grid;
  grid-template-columns: minmax(0, 1fr) minmax(0, 0.85fr);
  gap: 56px;
  align-items: center;
  padding: 76px 0;
  border-top: 1px solid var(--border);
}
.step.alt .step-text { order: 2; }
.step.alt .step-visual { order: 1; }
.step-n {
  font-size: 11.5px;
  font-weight: 640;
  letter-spacing: .16em;
  text-transform: uppercase;
  color: var(--faint);
}
.step-n.center { text-align: center; }
.step h2 { font-size: clamp(24px, 3vw, 34px); margin: 8px 0 16px; }
.step p { color: var(--dim); font-size: 15.5px; line-height: 1.7; }
.step p + p { margin-top: 12px; }
.step a { color: var(--gold); text-decoration: underline; text-underline-offset: 3px; }

/* ---- callouts ----------------------------------------------------------- */
.callout {
  margin-top: 18px;
  padding: 15px 18px;
  border-left: 2px solid var(--gold-3);
  border-radius: 0 12px 12px 0;
  background: rgba(240, 195, 74, .05);
  font-size: 14px;
  color: var(--dim);
  line-height: 1.62;
}
.callout b { color: var(--text); font-weight: 660; }
.callout.ok { border-left-color: var(--good); background: rgba(134, 201, 138, .06); }
.callout.warn { border-left-color: #e5a05c; background: rgba(229, 160, 92, .06); }
.callout ul { margin: 8px 0 0; padding-left: 18px; }
.callout li { margin-bottom: 7px; }
.callout li::marker { color: var(--gold); }

code {
  font-family: ui-monospace, SFMono-Regular, Menlo, monospace;
  font-size: .92em;
  color: var(--gold-2);
  background: rgba(0, 0, 0, .3);
  border-radius: 5px;
  padding: 1px 5px;
}

/* ---- lists inside steps -------------------------------------------------- */
.perms, .tries { list-style: none; padding: 0; margin: 18px 0 0; }
.perms li { padding: 12px 0; border-top: 1px solid var(--border); font-size: 15px; color: var(--text); }
.perms li span { display: block; font-size: 13.5px; color: var(--faint); margin-top: 3px; }
.tries li {
  padding: 10px 14px;
  margin-bottom: 8px;
  border-radius: 12px;
  background: var(--surface);
  border: 1px solid var(--border);
  font-size: 14.5px;
  color: var(--dim);
}

/* ---- real screenshots ---------------------------------------------------- */
.shot { margin: 0; }
.shot img {
  width: 100%;
  max-width: 300px;
  margin: 0 auto;
  display: block;
  border-radius: 20px;
  border: 1px solid var(--border-hi);
  box-shadow: var(--shadow);
}
.shot figcaption { text-align: center; margin-top: 12px; font-size: 12.5px; color: var(--faint); }

/* ---- drawn UI mock-ups --------------------------------------------------- */
.mock {
  background: linear-gradient(180deg, var(--surface), var(--bg-2));
  border: 1px solid var(--border-hi);
  border-radius: 18px;
  box-shadow: var(--shadow);
  overflow: hidden;
  max-width: 340px;
  margin: 0 auto;
}
.mock.tiny { max-width: 170px; }
.mock-phone { max-width: 260px; border-radius: 26px; }
.mock-bar { display: flex; gap: 6px; padding: 11px 14px; border-bottom: 1px solid var(--border); }
.mock-bar .dot { width: 9px; height: 9px; border-radius: 50%; background: var(--faint); opacity: .5; }
.mock-body { padding: 18px; }
.mock-body.center { text-align: center; }
.mock-title { font-weight: 700; margin: 14px 0 12px; font-size: 15px; }
.mock-sub { font-size: 12px; color: var(--faint); margin-top: 9px; }
.install-ico { width: 62px; height: 62px; border-radius: 15px; margin: 0 auto; }
.mock-progress { height: 5px; border-radius: 3px; background: var(--surface-2); overflow: hidden; }
.mock-progress span {
  display: block;
  height: 100%;
  width: 30%;
  border-radius: 3px;
  background: var(--grad-gold);
  animation: mockFill 2.6s var(--ease) infinite;
}
@keyframes mockFill { 0% { width: 8%; } 70% { width: 92%; } 100% { width: 100%; } }

/* step 7: the task running */
.task-bubble {
  background: var(--grad-gold);
  color: #1d1108;
  font-weight: 640;
  font-size: 12.5px;
  padding: 10px 13px;
  border-radius: 14px 14px 4px 14px;
  margin-bottom: 14px;
}
.task-steps { display: flex; flex-direction: column; gap: 8px; }
.tstep {
  display: flex;
  align-items: center;
  gap: 9px;
  font-size: 12px;
  color: var(--dim);
  opacity: 0;
  animation: tstepIn 5.5s var(--ease) infinite;
}
.tstep:nth-child(2) { animation-delay: .5s; }
.tstep:nth-child(3) { animation-delay: 1s; }
.tstep:nth-child(4) { animation-delay: 1.5s; }
@keyframes tstepIn {
  0%, 4% { opacity: 0; transform: translateY(5px); }
  12%, 88% { opacity: 1; transform: none; }
  100% { opacity: 0; }
}
.tn {
  flex: none;
  width: 19px;
  height: 19px;
  border-radius: 50%;
  display: grid;
  place-items: center;
  font-size: 10px;
  font-weight: 700;
  color: var(--gold);
  border: 1px solid var(--border-hi);
}
.tn.ok { color: var(--good); border-color: rgba(134, 201, 138, .5); }
.tstep.done { color: var(--good); font-weight: 640; }
.mock-composer {
  display: flex;
  align-items: center;
  justify-content: space-between;
  margin-top: 16px;
  padding: 9px 12px;
  border: 1px solid var(--border-hi);
  border-radius: 999px;
  font-size: 11.5px;
  color: var(--faint);
}
.mock-composer .send { width: 18px; height: 18px; border-radius: 50%; background: var(--grad-gold); }

/* ---- step 5: the two model routes --------------------------------------- */
.brain-pick { border-top: 1px solid var(--border); }
.brain-grid { display: grid; grid-template-columns: 1fr 1fr; gap: 20px; margin-top: 38px; }
.brain-card { padding: 32px 28px; }
.brain-head { margin-bottom: 16px; }
.brain-tag {
  display: inline-block;
  font-size: 10px;
  font-weight: 700;
  letter-spacing: .1em;
  text-transform: uppercase;
  color: var(--faint);
  border: 1px solid var(--border);
  border-radius: 999px;
  padding: 3px 10px;
  margin-bottom: 11px;
}
.brain-tag.rec { color: #1d1108; background: var(--grad-gold); border-color: transparent; }
.brain-card h3 { font-size: 22px; font-weight: 740; letter-spacing: -.02em; }
.brain-sub { font-size: 13px; color: var(--faint); margin-top: 4px; }
.brain-card > p { font-size: 14.5px; color: var(--dim); line-height: 1.68; }
.howto { margin: 18px 0 0; padding-left: 20px; }
.howto li { font-size: 14.5px; color: var(--dim); line-height: 1.65; margin-bottom: 11px; }
.howto li::marker { color: var(--gold); font-weight: 700; }
.howto b { color: var(--text); font-weight: 640; }
.howto a { color: var(--gold); text-decoration: underline; text-underline-offset: 3px; }
.fieldset { margin-top: 10px; display: flex; flex-direction: column; gap: 7px; }
.fld {
  display: flex;
  flex-direction: column;
  gap: 3px;
  background: rgba(0, 0, 0, .26);
  border: 1px solid var(--border);
  border-radius: 9px;
  padding: 8px 11px;
}
.fld span { font-size: 10.5px; letter-spacing: .08em; text-transform: uppercase; color: var(--faint); }
.fld code { background: none; padding: 0; word-break: break-all; font-size: 12px; }
.cmd {
  margin-top: 9px;
  background: rgba(0, 0, 0, .32);
  border: 1px solid var(--border);
  border-radius: 9px;
  padding: 10px 13px;
}
.cmd code { background: none; padding: 0; font-size: 13px; }
.modeltab { width: 100%; border-collapse: collapse; margin-top: 18px; font-size: 13.5px; }
.modeltab th {
  text-align: left;
  font-size: 10.5px;
  letter-spacing: .1em;
  text-transform: uppercase;
  color: var(--faint);
  font-weight: 640;
  padding: 0 8px 8px 0;
  border-bottom: 1px solid var(--border);
}
.modeltab td {
  padding: 9px 8px 9px 0;
  border-bottom: 1px solid var(--border);
  color: var(--dim);
  vertical-align: top;
}
.modeltab tr.best td { color: var(--text); }
.modeltab code { font-size: 12px; }
.brain-note {
  max-width: 68ch;
  margin: 30px auto 0;
  text-align: center;
  font-size: 13.5px;
  color: var(--faint);
  line-height: 1.65;
}

/* ---- step 8 + closing ---------------------------------------------------- */
.further { border-top: 1px solid var(--border); }
.further-grid { display: grid; grid-template-columns: repeat(3, 1fr); gap: 18px; margin-top: 34px; }
.further-grid .card { padding: 26px; }
.further-grid h3 { font-size: 17px; margin-bottom: 8px; }
.further-grid p { font-size: 14px; color: var(--dim); line-height: 1.62; }
.further-grid a { color: var(--gold); text-decoration: underline; text-underline-offset: 3px; }
.guide-cta { padding: 76px 0 20px; border-top: 1px solid var(--border); text-align: center; }
.guide-cta .cta-row { margin-top: 22px; }

@media (max-width: 960px) {
  .step { grid-template-columns: 1fr; gap: 30px; padding: 56px 0; }
  .step.alt .step-text { order: 1; }
  .step.alt .step-visual { order: 2; }
  .brain-grid, .further-grid, .toc { grid-template-columns: 1fr; }
}

@media (prefers-reduced-motion: reduce) {
  .mock-progress span, .tstep { animation: none !important; }
  .tstep { opacity: 1; }
}

/* required / optional markers in the permissions list */
.perms em {
  font-style: normal;
  font-size: 9.5px;
  font-weight: 700;
  letter-spacing: .1em;
  text-transform: uppercase;
  border-radius: 999px;
  padding: 2px 8px;
  margin-left: 7px;
  vertical-align: 2px;
}
.perms em.req { color: var(--gold); border: 1px solid var(--border-hi); }
.perms em.opt { color: var(--faint); border: 1px solid var(--border); }

/* ---- the two parts ------------------------------------------------------------
   Setting up splits cleanly in half: everything on the computer, then everything
   on the phone. Signposting that up front stops the reader wondering which
   device they are meant to be holding. */
.parts { display: grid; grid-template-columns: 1fr 1fr; gap: 16px; margin-top: 36px; }
.part-card {
  display: flex; flex-direction: column; gap: 5px;
  padding: 24px 26px;
  border: 1px solid var(--border); border-radius: var(--r-card);
  background: linear-gradient(180deg, var(--surface), var(--bg-2));
  transition: transform .4s var(--ease), border-color .4s var(--ease);
}
.part-card:hover { transform: translateY(-3px); border-color: var(--border-hi); }
.part-n {
  font-size: 10.5px; font-weight: 700; letter-spacing: .14em;
  text-transform: uppercase; color: #1d1108;
  background: var(--grad-gold); border-radius: 999px;
  padding: 3px 11px; width: max-content;
}
.part-h { font-size: 19px; font-weight: 740; letter-spacing: -.018em; color: var(--text); margin-top: 6px; }
.part-d { font-size: 14px; color: var(--dim); line-height: 1.58; }
.part-steps { font-size: 12px; color: var(--faint); margin-top: 4px; letter-spacing: .04em; }

.part-rule {
  margin-top: 88px; padding-top: 34px;
  border-top: 2px solid var(--border-hi);
}
.part-badge {
  display: inline-block;
  font-size: 10.5px; font-weight: 700; letter-spacing: .14em; text-transform: uppercase;
  color: #1d1108; background: var(--grad-gold);
  border-radius: 999px; padding: 4px 13px;
}
.part-title {
  font-size: clamp(26px, 3.6vw, 40px); font-weight: 780;
  letter-spacing: -.024em; margin: 14px 0 10px;
}
.part-sub { color: var(--faint); font-weight: 600; }
.part-lede { font-size: 16px; color: var(--dim); max-width: 62ch; line-height: 1.66; }
/* the first step after a part banner does not need its own rule on top */
.part-rule + .step { border-top: 0; padding-top: 44px; }

/* a landscape-ish capture (the desktop window) needs more room than a phone */
.shot.wide img { max-width: 380px; }

@media (max-width: 960px) {
  .parts { grid-template-columns: 1fr; }
  .part-rule { margin-top: 56px; }
}

/* the desktop Devices mock used in step 2 until a real capture replaces it */
.mock-winbar {
  display: flex; align-items: center; gap: 10px;
  padding: 12px 14px; border-bottom: 1px solid var(--border);
}
.mock-menu { width: 15px; height: 2px; background: var(--dim); box-shadow: 0 5px 0 var(--dim), 0 -5px 0 var(--dim); }
.mock-brand { font-weight: 700; font-size: 13.5px; }
.mock-label {
  font-size: 10.5px; font-weight: 640; letter-spacing: .12em;
  text-transform: uppercase; color: var(--faint); margin-bottom: 12px;
}
.mock-input, .mock-btn { border-radius: 9px; padding: 9px 11px; font-size: 12px; text-align: center; }
.mock-input { background: rgba(15,9,5,.8); border: 1px solid var(--border-hi); color: var(--faint); margin-bottom: 7px; }
.mock-btn { background: var(--grad-gold); color: #1d1108; font-weight: 700; }
.qr-demo { position: relative; }
.qr-ghost-demo { width: 100%; border-radius: 12px; filter: blur(9px) brightness(.6); shape-rendering: crispEdges; }
.qr-lockform {
  position: absolute; inset: 0; display: flex; flex-direction: column;
  justify-content: center; padding: 0 22px;
}

/* two phone screenshots side by side, for a step that spans two screens */
.shot.pair { display: grid; grid-template-columns: 1fr 1fr; gap: 12px; }
.shot.pair img { max-width: 100%; border-radius: 14px; }
.shot.pair figcaption { grid-column: 1 / -1; }

/* ---- the guide reads, so it is narrower than the landing page -----------------
   styles.css sets .wrap to 1520px because the home page has full-bleed diagrams
   to fill. A guide is prose: at that width the body ran ~89 characters a line
   and the container touched both screen edges. This brings it back to a
   comfortable measure with real margins either side. */
.guide .wrap { max-width: 1120px; padding-inline: clamp(20px, 5vw, 64px); }
.guide .step { gap: 48px; }

/* a screenshot sitting inside a card, rather than in the step's visual column */
.shot.inline { margin: 18px 0 0; }
.shot.inline img { max-width: 100%; border-radius: 12px; }
.shot.wide.provider-shot { margin: 30px auto 0; }
.shot.wide.provider-shot img { max-width: 340px; }