From abb2b65d2ada038eeb22c8fd59d03eedf2153e3b Mon Sep 17 00:00:00 2001
From: pat <sinachpat@gmail.com>
Date: Tue, 1 Sep 2026 03:44:10 +0000
Subject: [PATCH] Replace the chapter progress bar with an opaque outline

---
 marketing-site/styles/globals.css | 158 +++++++++++++++++++++++++-----
 1 file changed, 131 insertions(+), 27 deletions(-)

diff --git a/marketing-site/styles/globals.css b/marketing-site/styles/globals.css
index 455a492..4ebd4c2 100644
--- a/marketing-site/styles/globals.css
+++ b/marketing-site/styles/globals.css
@@ -104,8 +104,7 @@ h1, h2, h3 { text-wrap: balance; margin: 0; }
 /* ============ NAV ============ */
 .nav {
   position: sticky; top: 0; z-index: 50;
-  background: color-mix(in srgb, var(--color-paper) 82%, transparent);
-  backdrop-filter: blur(14px) saturate(1.3); -webkit-backdrop-filter: blur(14px) saturate(1.3);
+  background: var(--color-paper);
   border-bottom: 1px solid transparent; transition: border-color 0.3s, box-shadow 0.3s;
 }
 .nav.scrolled { border-bottom-color: var(--color-line); box-shadow: var(--sh-sm); }
@@ -453,25 +452,14 @@ h1, h2, h3 { text-wrap: balance; margin: 0; }
   .reader-nav .nav-toggle { display: none; }
 }
 
-.chapter-progress {
-  position: sticky; top: 68px; z-index: 40;
-  background: color-mix(in srgb, var(--color-paper) 88%, transparent);
-  backdrop-filter: blur(12px) saturate(1.2);
-  -webkit-backdrop-filter: blur(12px) saturate(1.2);
-  border-bottom: 1px solid var(--color-line);
-}
-.chapter-progress-in {
-  display: flex; align-items: center; justify-content: space-between; gap: 16px;
-  min-height: 40px;
-  font-family: var(--font-mono); font-size: 12px; color: var(--color-muted);
-  letter-spacing: 0.04em;
-}
-.chapter-progress-links { display: flex; gap: 16px; flex-wrap: wrap; }
-.chapter-progress-links a { color: var(--color-pine); font-weight: 500; }
-.chapter-progress-links a:hover { color: var(--color-pine-deep); }
-
 .chapter-page { padding: 48px 0 96px; }
-.chapter-col { max-width: 42rem; }
+.chapter-shell {
+  display: grid;
+  grid-template-columns: 240px minmax(0, 1fr);
+  gap: 40px;
+  align-items: start;
+}
+.chapter-col { min-width: 0; }
 .chapter-kicker { margin: 8px 0 14px; }
 .chapter-title {
   font-family: var(--font-display); font-weight: 900;
@@ -480,12 +468,84 @@ h1, h2, h3 { text-wrap: balance; margin: 0; }
 }
 .chapter-by {
   font-family: var(--font-mono); font-size: 12.5px; color: var(--color-muted);
-  letter-spacing: 0.04em; margin-bottom: 28px;
+  letter-spacing: 0.04em; margin-bottom: 20px;
 }
 .chapter-promise {
-  font-size: 1.12rem; line-height: 1.62; color: var(--color-ink); margin: 0 0 22px;
+  font-size: 1.12rem; line-height: 1.62; color: var(--color-ink); margin: 0 0 28px;
 }
 
+.chapter-outline {
+  position: sticky;
+  top: 68px;
+  z-index: 30;
+  align-self: start;
+  background: var(--color-paper);
+  border-right: 1px solid var(--color-line);
+  padding: 16px 20px 28px 0;
+  max-height: calc(100vh - 68px);
+  overflow-y: auto;
+}
+.outline-progress {
+  font-family: var(--font-mono); font-size: 11.5px; color: var(--color-muted);
+  letter-spacing: 0.04em; margin: 0 0 14px;
+}
+.outline-heading {
+  font-family: var(--font-display); font-weight: 600;
+  font-size: 1.08rem; letter-spacing: -0.02em; margin: 0 0 16px;
+}
+.outline-group { margin: 0 0 18px; }
+.outline-group:last-child { margin-bottom: 0; }
+.outline-group-label { margin: 0 0 8px; }
+.outline-group ul { list-style: none; margin: 0; padding: 0; }
+.outline-group li { margin: 0; }
+.outline-group a {
+  display: flex; align-items: baseline; justify-content: space-between; gap: 8px;
+  padding: 5px 0 5px 10px;
+  border-left: 2px solid transparent;
+  font-size: 13.5px; line-height: 1.35; color: var(--color-muted);
+}
+.outline-group a:hover { color: var(--color-ink); }
+.outline-group a.is-active {
+  color: var(--color-pine); border-left-color: var(--color-pine); font-weight: 600;
+}
+.outline-done {
+  font-family: var(--font-mono); font-size: 12px; color: var(--color-pine); flex: none;
+}
+
+.chapter-outline-mobile {
+  margin: 0 0 24px;
+  padding: 10px 16px 12px;
+  border: 1px solid var(--color-line);
+  border-radius: 12px;
+  background: var(--color-card);
+}
+.chapter-outline-mobile summary {
+  cursor: pointer; list-style: none;
+  font-family: var(--font-display); font-weight: 600;
+  font-size: 1.05rem; letter-spacing: -0.02em;
+  padding: 6px 0;
+}
+.chapter-outline-mobile summary::-webkit-details-marker { display: none; }
+.chapter-outline-mobile[open] summary { margin-bottom: 10px; }
+.chapter-outline-mobile .outline-progress { margin-top: 4px; }
+
+.chapter-map {
+  margin: 0 0 8px;
+  padding: 18px 0 6px;
+  border-top: 1px solid var(--color-line);
+}
+.chapter-map-title {
+  font-family: var(--font-display); font-weight: 600;
+  font-size: 1.2rem; letter-spacing: -0.02em;
+  margin: 0 0 16px;
+}
+.chapter-map-block { margin: 0 0 16px; }
+.chapter-map-block .spec { margin: 0 0 8px; }
+.chapter-map-block ul { margin: 0; padding: 0 0 0 1.1em; }
+.chapter-map-block li { margin: 0 0 6px; }
+.chapter-map-block a { color: var(--color-pine); font-weight: 600; }
+.chapter-map-block a:hover { color: var(--color-pine-deep); }
+
 .skip-row {
   display: flex; flex-wrap: wrap; align-items: center; gap: 10px;
   margin: 0 0 48px; padding: 16px 0;
@@ -511,6 +571,14 @@ h1, h2, h3 { text-wrap: balance; margin: 0; }
   color: var(--color-ink); letter-spacing: 0; text-transform: none;
 }
 
+.essay,
+.recipe-nested,
+.end-matter,
+.end-sources,
+.recipe-nested .row {
+  scroll-margin-top: 88px;
+}
+
 .essay { margin: 0 0 36px; }
 .essay h2 {
   font-family: var(--font-display); font-weight: 600;
@@ -520,12 +588,29 @@ h1, h2, h3 { text-wrap: balance; margin: 0; }
 .essay p { color: var(--color-ink); margin: 0 0 14px; }
 .essay p:last-child { margin-bottom: 0; }
 
+.workflow-kicker { margin: 8px 0 10px; }
+
 .recipe-nested {
-  margin: 40px 0 52px;
-  scroll-margin-top: 128px;
+  margin: 0 0 52px;
 }
 .recipe-nested .step-copy { min-width: 0; flex: 1; }
 .recipe-nested .step-copy .term { margin-top: 12px; }
+.recipe-nested h4.k { margin: 0; font-weight: 500; }
+.recipe-nested .term {
+  overflow-x: auto;
+  overflow-y: hidden;
+}
+.recipe-nested .term pre { overflow-x: auto; }
+
+.recipe-jump {
+  display: flex; flex-wrap: wrap; gap: 8px 16px;
+  margin: 0 0 8px; padding: 0 0 16px;
+  border-bottom: 1px dashed var(--color-line-2);
+  font-size: 13.5px;
+}
+.recipe-jump a { color: var(--color-pine); font-weight: 600; }
+.recipe-jump a:hover { color: var(--color-pine-deep); }
+.recipe-jump a:focus-visible { outline: 2px solid var(--color-pine); outline-offset: 2px; }
 
 .plain-list { margin: 0; padding: 0 0 0 1.1em; }
 .plain-list li { margin: 0 0 6px; }
@@ -554,11 +639,13 @@ h1, h2, h3 { text-wrap: balance; margin: 0; }
   margin-top: 56px; padding-top: 28px;
   border-top: 1px solid var(--color-line);
 }
-.end-matter h2 {
+.end-sources { margin-top: 32px; }
+.end-matter h2,
+.end-sources h2 {
   font-family: var(--font-display); font-weight: 600;
   font-size: 1.35rem; letter-spacing: -0.02em; margin: 0 0 12px;
 }
-.end-matter h2 + .further-list { margin-bottom: 32px; }
+.end-matter h2 + .further-list { margin-bottom: 8px; }
 .further-list { margin: 0 0 8px; padding: 0 0 0 1.1em; color: var(--color-ink); }
 .further-list li { margin: 0 0 8px; }
 .further-list a { color: var(--color-pine); font-weight: 600; }
@@ -586,9 +673,18 @@ h1, h2, h3 { text-wrap: balance; margin: 0; }
   background: var(--color-card); border: 1px solid var(--color-line);
   padding: 4px 10px; border-radius: 999px; white-space: nowrap;
 }
+.reader-library .toc a {
+  grid-template-columns: 52px 1fr auto auto auto;
+}
+.toc-count {
+  font-family: var(--font-mono); font-size: 11.5px; font-weight: 500;
+  letter-spacing: 0.08em; text-transform: uppercase;
+  color: var(--color-pine); white-space: nowrap;
+}
 @media (max-width: 720px) {
   .toc .toc-soon .desc { display: none; }
   .toc .toc-soon { grid-template-columns: 40px 1fr auto; }
+  .reader-library .toc a { grid-template-columns: 40px 1fr auto auto; }
 }
 
 .recipe-focus-page { padding: 40px 0 96px; }
@@ -600,8 +696,16 @@ h1, h2, h3 { text-wrap: balance; margin: 0; }
 }
 .focus-back a { color: var(--color-pine); font-weight: 600; }
 
+@media (max-width: 959px) {
+  .chapter-shell { grid-template-columns: 1fr; gap: 0; }
+  .chapter-outline { display: none; }
+}
+@media (min-width: 960px) {
+  .chapter-outline-mobile { display: none; }
+}
+
 @media print {
-  .reader-nav, .chapter-progress, .reader-footer, .skip-row, .tryit-actions, .demo-chip {
+  .reader-nav, .chapter-outline, .chapter-outline-mobile, .reader-footer, .skip-row, .tryit-actions, .demo-chip, .recipe-jump {
     display: none !important;
   }
   .recipe-nested { break-inside: avoid; box-shadow: none; }