/* KnowThePepper substitute page (UI redesign v2): the "Substituting for" panel in the head, the wide
   heat-at-a-glance chart card, the ranked substitute cards, and the poor-substitutes list.
   Loaded by templates/substitute.php after article.css (the shared article frame owns the head band,
   TOC, callouts, tables, FAQ and the related carousel). Tokens only; two widths only (1200 and 720):
   a block that is a direct child of the article column is wide (.sub-wide) or read (the default),
   and the copy inside a wide card stays at the read width.
   Comps: art-src/style-refs/ktp-v2/ktp-v2-25-substitute-head.webp (head, heat chart) and
   ktp-v2-26-substitute-body.webp (body blocks only: featured pick, ranked rows, poor-substitutes list).
   Plan: docs/plans/2026-11-12-ui-redesign-v2.md */

/* ── "Substituting for" panel (wide card that straddles the blush head band) ── */
.article-media--md { margin-bottom: var(--ktp-space-6); }
.sub-source {
  display: grid;
  grid-template-columns: minmax(0, 1.05fr) minmax(0, 1fr);
  align-items: center;
  gap: var(--ktp-space-6);
  padding: var(--ktp-space-5);
}
.sub-source__photo {
  display: grid;
  place-items: center;
  aspect-ratio: var(--ratio, 1200 / 630);
  overflow: hidden;
  border-radius: 10px;
  background: var(--tier-tint, var(--ktp-smoke));
}
.sub-source__photo picture { display: block; width: 100%; height: 100%; }
.sub-source__photo img { display: block; width: 100%; height: 100%; object-fit: cover; } /* frame ratio equals file ratio, so nothing is cut */
.sub-source__photo--contain img { object-fit: contain; } /* near-square or portrait files sit whole on the tint */
.sub-source__body { display: flex; flex-direction: column; align-items: flex-start; gap: var(--ktp-space-2); min-width: 0; }
.sub-source__eyebrow {
  color: var(--ktp-muted);
  font-size: var(--ktp-fs-small);
  font-weight: 800;
  letter-spacing: .14em;
  text-transform: uppercase;
  line-height: 1.3;
}
.sub-source__name {
  font-family: var(--ktp-font-display);
  font-size: clamp(1.9rem, 3.4vw, 2.6rem);
  font-weight: var(--ktp-fw-display);
  line-height: 1.08;
  letter-spacing: var(--ktp-tracking-display);
  color: var(--ktp-ink);
}
.sub-source .tier-chip { margin-top: 0; }
.sub-source__facts { align-self: stretch; margin: var(--ktp-space-3) 0 0; padding: 0; }
.sub-source__fact {
  display: grid;
  grid-template-columns: minmax(7rem, 9rem) minmax(0, 1fr);
  gap: var(--ktp-space-3);
  align-items: baseline;
  margin: 0;
  padding: 10px 0;
  border-top: var(--ktp-line);
}
.sub-source__fact:last-child { border-bottom: var(--ktp-line); }
.sub-source__fact dt { margin: 0; color: var(--ktp-muted); font-size: var(--ktp-fs-small); font-weight: 800; letter-spacing: .1em; text-transform: uppercase; }
.sub-source__fact dd { margin: 0; font-size: 1.1rem; line-height: 1.4; color: var(--ktp-ink); }
.sub-source__link {
  margin-top: var(--ktp-space-2);
  color: var(--ktp-ink);
  font-weight: 700;
  text-decoration: underline;
  text-decoration-color: var(--ktp-chili-40);
  text-decoration-thickness: 1.5px;
  text-underline-offset: 4px;
}
.sub-source__link:hover { text-decoration-color: var(--ktp-chili); }
.sub-source__glyph { display: grid; place-items: center; padding: var(--ktp-space-6); }
@media (max-width: 900px) {
  .sub-source { grid-template-columns: 1fr; gap: var(--ktp-space-5); }
}
@media (max-width: 640px) {
  .sub-source__fact { grid-template-columns: 1fr; gap: 2px; }
}

/* ── Wide blocks: direct children of the article column that span the wide width ── */
.ktp-article .wrap-wide > .sub-wide { width: min(100%, var(--ktp-w-wide)); }
/* Section headings stay on the read rail like every other H2; only the cards below run wide. */
.ktp-article .wrap-wide > .sub-wide > h2 { max-width: var(--ktp-w-read); margin-inline: auto; }

/* ── Copy (ranked cards, lede, avoid rows, custom sections) ── */
.sub-rank-copy { display: grid; gap: var(--ktp-space-4); min-width: 0; }
.sub-rank-copy p { margin: 0; }
.sub-lede { max-width: var(--ktp-w-read); margin: 0 0 var(--ktp-space-6); }

/* Swap ratio: the authored conversion paragraph in a blush note, label above, authored ratio emphasised */
.sub-swap { padding: var(--ktp-space-3) var(--ktp-space-4); border-radius: var(--ktp-radius); background: var(--ktp-blush); }
.sub-swap__label { display: block; margin-bottom: 2px; color: var(--ktp-muted); font-size: var(--ktp-fs-small); font-weight: 800; letter-spacing: .12em; text-transform: uppercase; }
.sub-swap__copy { color: var(--ktp-ink); line-height: 1.55; }
.sub-swap a:not([class]) { color: inherit; text-decoration: underline; text-decoration-color: var(--ktp-chili-40); text-decoration-thickness: 1.5px; text-underline-offset: 3px; }
.sub-swap a:not([class]):hover { text-decoration-color: var(--ktp-chili); }
.sub-swap__copy strong { font-family: var(--ktp-font-display); font-size: 1.2em; font-weight: var(--ktp-fw-display); color: var(--ktp-chili); }

/* Authored lists and tables inside the cards */
.sub-rank-inline-group { display: grid; gap: var(--ktp-space-2); }
.sub-rank-inline-label { color: var(--ktp-muted); font-size: var(--ktp-fs-small); font-weight: 800; letter-spacing: .12em; text-transform: uppercase; }
.sub-rank-list-shell { padding: var(--ktp-space-3) var(--ktp-space-4); border: var(--ktp-line); border-radius: var(--ktp-radius); background: var(--ktp-smoke); }
.sub-rank-list-shell ul { margin: 0; padding-left: 1.2em; }
.sub-rank-list-shell li { margin: 0; }
.sub-rank-list-shell li + li { margin-top: var(--ktp-space-2); }
main .ktp-article .sub-rank-table-shell.table-scroll { margin: 0; } /* auto side margins (article.css) would shrink-wrap it to the table inside this grid and clip the last column on phones */

/* ── Wide heat-at-a-glance chart card (an authored .range-chart section) ── */
.sub-chart-card {
  padding: var(--ktp-space-6) var(--ktp-space-6) var(--ktp-space-5);
  border: var(--ktp-line);
  border-radius: 16px;
  background: var(--ktp-white);
  box-shadow: var(--ktp-shadow);
  box-sizing: border-box;
}
main .ktp-article .sub-chart-card > h2 { margin-bottom: var(--ktp-space-4); }
main .ktp-article .sub-chart-card .range-chart:not(.range-chart--ramp) {
  margin: 0 0 var(--ktp-space-4);
  padding: 0;
  border: 0;
  border-radius: 0;
  background: none;
  row-gap: 14px;
}
main .ktp-article .sub-chart-card .range-chart--target { padding-top: 34px; }
main .ktp-article .sub-chart-card .range-chart__label { color: var(--ktp-ink); font-weight: 700; }
main .ktp-article .sub-chart-card .range-chart__value { color: var(--ktp-ink); font-size: var(--ktp-fs-small); }
main .ktp-article .sub-chart-card .range-chart__track {
  height: 18px;
  border-radius: 4px;
  background: var(--ktp-clay);
  box-shadow: none;
}
main .ktp-article .sub-chart-card .range-chart__bar { border-radius: 4px; background: var(--tier, var(--ktp-muted)); }
main .ktp-article .sub-chart-card .range-chart__row[data-tier] .range-chart__bar { background: var(--tier, var(--ktp-muted)); } /* beats readability.css tier colours */
main .ktp-article .sub-chart-card .range-chart__scale > * { border-top: 0; padding-top: 0; color: var(--ktp-muted); font-size: var(--ktp-fs-small); }
main .ktp-article .sub-chart-card .range-chart__ticks { border-top: 1.5px solid var(--ktp-muted); padding-top: 8px; }
main .ktp-article .sub-chart-card .range-chart__ticks > span { color: var(--ktp-ink); font-size: var(--ktp-fs-small); }
.sub-chart-card .sub-rank-copy { max-width: var(--ktp-w-read); }
.sub-chart-card .sub-rank-copy > p { margin-top: var(--ktp-space-2); }

/* Target marker: a dashed line through every track at the source pepper's own bar, one chip above the first row */
.range-chart--target .range-chart__track { overflow: visible; }
.range-chart--target .range-chart__track::after {
  content: "";
  position: absolute;
  z-index: 1;
  left: var(--target);
  top: -9px;
  bottom: -9px;
  border-left: 2px dashed var(--ktp-ink);
  transform: translateX(-1px);
  pointer-events: none;
}
.range-chart--target .range-chart__row:first-child .range-chart__track::before {
  content: "Target";
  position: absolute;
  z-index: 2;
  left: var(--target);
  bottom: calc(100% + 12px);
  transform: translateX(-50%);
  padding: 2px 10px;
  border: 1.5px solid var(--ktp-ink);
  border-radius: 6px;
  background: var(--ktp-white);
  color: var(--ktp-ink);
  font-size: 12px;
  font-weight: 800;
  letter-spacing: .1em;
  line-height: 1.5;
  text-transform: uppercase;
  white-space: nowrap;
}
@media (max-width: 640px) {
  .sub-chart-card { padding: var(--ktp-space-4) var(--ktp-space-4) var(--ktp-space-5); }
  main .ktp-article .sub-chart-card .range-chart--target { padding-top: 0; }
  /* one grid per row on phones: the chip moves under the first track so it never covers the label or value */
  .range-chart--target .range-chart__row:first-child .range-chart__track::before { bottom: auto; top: calc(100% + 12px); }
  main .ktp-article .sub-chart-card .range-chart--target .range-chart__row:first-child { margin-bottom: 44px; }
}

/* ── Ranked substitutes: #1 featured card, then one list card of rows (a figure between two items splits the list) ── */
.sub-rank-stack { display: grid; gap: var(--ktp-space-5); margin-top: var(--ktp-space-5); }
.sub-rank-stack > .article-inline-image { width: 100%; max-width: var(--ktp-w-read); }
.sub-rank-item {
  display: grid;
  grid-template-columns: minmax(0, 1fr) minmax(0, var(--ktp-w-read));
  align-items: start;
  column-gap: var(--ktp-space-7);
}
.sub-rank-head { display: flex; align-items: flex-start; gap: var(--ktp-space-3); min-width: 0; }
.sub-rank-badge {
  display: inline-grid;
  flex: none;
  place-items: center;
  min-width: 40px;
  height: 40px;
  padding-inline: 6px;
  border: var(--ktp-line);
  border-radius: 999px;
  background: var(--ktp-smoke);
}
.sub-rank-badge__num { font-family: var(--ktp-font-display); font-size: 1rem; font-weight: var(--ktp-fw-number); line-height: 1; color: var(--ktp-ink); }
.sub-rank-heading { display: flex; flex-direction: column; gap: 6px; min-width: 0; }
main .ktp-article .sub-rank-title {
  margin: 0;
  font-family: var(--ktp-font-display);
  font-size: var(--ktp-fs-h3);
  font-weight: var(--ktp-fw-display);
  line-height: 1.18;
  letter-spacing: var(--ktp-tracking-display);
  color: var(--ktp-ink);
}
.sub-rank-chip {
  order: -1;
  align-self: flex-start;
  padding: 2px 10px;
  border-radius: var(--ktp-radius-sm);
  background: var(--ktp-smoke);
  border: var(--ktp-line);
  color: var(--ktp-ink);
  font-size: 12px;
  font-weight: 800;
  letter-spacing: .1em;
  line-height: 1.5;
  text-transform: uppercase;
  white-space: nowrap;
}

/* #1: wide card, blush identity panel on the left, copy at the read width on the right */
.sub-rank-item--featured {
  grid-template-columns: minmax(0, 1fr) minmax(0, var(--ktp-w-read));
  column-gap: 0;
  padding: var(--ktp-space-3);
  border: var(--ktp-line);
  border-radius: 16px;
  background: var(--ktp-white);
  box-shadow: var(--ktp-shadow);
}
.sub-rank-item--featured .sub-rank-head {
  position: sticky;
  top: calc(var(--ktp-header-h) + var(--ktp-space-4));
  flex-direction: column;
  align-self: start;
  gap: var(--ktp-space-4);
  padding: var(--ktp-space-6);
  border-radius: 10px;
  background: var(--ktp-blush);
}
.sub-rank-item--featured .sub-rank-badge { min-width: 56px; height: 56px; border-color: var(--ktp-ancho); background: var(--ktp-ancho); }
.sub-rank-item--featured .sub-rank-badge__num { font-size: 1.35rem; color: var(--ktp-on-dark); }
.sub-rank-item--featured .sub-rank-chip { background: var(--ktp-white); }
main .ktp-article .sub-rank-item--featured .sub-rank-title { font-size: clamp(1.75rem, 3vw, 2.4rem); line-height: 1.1; }
.sub-rank-item--featured .sub-rank-copy { padding: var(--ktp-space-5) var(--ktp-space-6); }

/* #2 and on: one list card, a hairline between rows */
.sub-rank-list { border: var(--ktp-line); border-radius: 16px; background: var(--ktp-white); box-shadow: var(--ktp-shadow); overflow: hidden; }
.sub-rank-item--row { padding: var(--ktp-space-5) var(--ktp-space-6); }
.sub-rank-item--row + .sub-rank-item--row { border-top: var(--ktp-line); }

@media (max-width: 1000px) {
  .sub-rank-item,
  .sub-rank-item--featured { grid-template-columns: 1fr; row-gap: var(--ktp-space-4); }
  .sub-rank-item--featured { row-gap: 0; }
  .sub-rank-item--featured .sub-rank-head { position: static; flex-direction: row; align-items: center; padding: var(--ktp-space-5); }
  .sub-rank-item--featured .sub-rank-copy { padding: var(--ktp-space-5) var(--ktp-space-4) var(--ktp-space-3); }
}
@media (max-width: 640px) {
  .sub-rank-item--row { padding: var(--ktp-space-4); }
  .sub-rank-item--featured .sub-rank-head { padding: var(--ktp-space-4); gap: var(--ktp-space-3); }
  .sub-rank-item--featured .sub-rank-badge { min-width: 44px; height: 44px; }
}

/* Trailing blocks (best pick by application, ratio reference): read width, below the cards */
.sub-trailing { display: grid; gap: var(--ktp-space-4); margin-bottom: var(--ktp-space-7); }
main .ktp-article .sub-trailing__label { margin: var(--ktp-space-4) 0 0; font-family: var(--ktp-font-display); font-size: var(--ktp-fs-h3); font-weight: var(--ktp-fw-display); line-height: 1.2; color: var(--ktp-ink); }
.sub-trailing p { margin: 0; }

/* ── Poor substitutes: smoke panel in the read column, one white row per swap, an ancho cross ── */
.sub-avoid { padding: var(--ktp-space-6); border-radius: 16px; background: var(--ktp-smoke); box-sizing: border-box; }
main .ktp-article .sub-avoid > h2 { margin-bottom: var(--ktp-space-5); }
.sub-avoid__list { display: grid; gap: var(--ktp-space-3); }
.sub-avoid__row {
  display: grid;
  grid-template-columns: 36px minmax(0, 1fr);
  align-items: start;
  gap: var(--ktp-space-4);
  padding: var(--ktp-space-4) var(--ktp-space-5);
  border: var(--ktp-line);
  border-radius: var(--ktp-radius);
  background: var(--ktp-white);
}
.sub-avoid__x { display: grid; place-items: center; width: 36px; height: 36px; border-radius: 50%; background: var(--ktp-ancho); color: var(--ktp-on-dark); }
.sub-avoid__note { padding-inline: var(--ktp-space-2); }
@media (max-width: 640px) {
  .sub-avoid { padding: var(--ktp-space-4); }
  .sub-avoid__row { grid-template-columns: 1fr; gap: var(--ktp-space-3); padding: var(--ktp-space-4); }
}

/* ── Author-supplied figures inside custom sections ── */
.sub-figure { margin: var(--ktp-space-5) 0 0; padding: 0; }
.sub-figure img { display: block; width: 100%; height: auto; border-radius: var(--ktp-radius); }
.sub-figure figcaption { margin-top: var(--ktp-space-2); color: var(--ktp-muted); font-size: var(--ktp-fs-small); line-height: 1.5; }
