ci+style: fix broken pages deploy (PyYAML missing) + consolidate 8 heading clamps onto tokens

CI fix (root cause of stale onchainattack.org):
The deploy-pages workflow was failing silently since I added
specs/ axis support — npm run build chains into npm run site:data,
which calls python3 tools/build_specs.py, which imports yaml. The
GitHub Actions runner had setup-node but no setup-python and no
pip install pyyaml step, so every push since the spec axis introduction
ran into ModuleNotFoundError: No module named 'yaml' on the build
step and the deploy job never ran. That's why production was last
modified Apr 30.

  - Added actions/setup-python@v5 (3.12) step before npm install
  - Added 'pip install -r tools/requirements.txt' step
  - New tools/requirements.txt pinning PyYAML>=6.0 (the only non-stdlib
    Python dep across tools/)

Style — heading clamp consolidation:
There were still 8 different clamp() values for headings, each in one
place — large/medium/small variants of essentially the same role.
Consolidated:

  clamp(36, 5.5vw, 68) → new --fs-display     (hero numbers)
  clamp(28, 3.5vw, 44) → new --fs-display-sm  (large section heading)
  clamp(28, 3.5vw, 40) → --fs-display-sm      (close variant — merged)
  clamp(32, 4vw, 56)   → --fs-h1              (within range)
  clamp(24, 2.6vw, 36) → --fs-h2              (close to existing h2)
  clamp(20, 5vw, 28)   → --fs-h3              (within fluid h3 range)
  clamp(15, 1.3vw, 17) → --fs-h3              (close to h3)
  clamp(14, 1.15vw, 16) → --fs-md             (equivalent)

Final scale carries 11 sizes covering display → micro mono. Future
edge-case hero variants should use --fs-display / --fs-display-sm
instead of new clamps.

Author: iZonex

.github/workflows/deploy-pages.yml

@@ -25,9 +25,17 @@ jobs:
         with:
           node-version: "22"
 
-      - name: Install dependencies
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install Node dependencies
         run: npm install --no-package-lock
 
+      - name: Install Python dependencies
+        run: pip install -r tools/requirements.txt
+
       - name: Build static site
         run: npm run build
 

src/styles.css

@@ -53,6 +53,8 @@
   --surface-3: rgba(255, 255, 255, 0.04);
 
   /* typography scale */
+  --fs-display: clamp(36px, 5.5vw, 68px);
+  --fs-display-sm: clamp(28px, 3.5vw, 44px);
   --fs-h1: clamp(32px, 4vw, 48px);
   --fs-h2: clamp(22px, 2.4vw, 30px);
   --fs-h3: clamp(15px, 1.6vw, 19px);
@@ -789,7 +791,7 @@ line-height: 1.3;
 }
 
 .hero-copy h1 {
-  font-size: clamp(36px, 5.5vw, 68px);
+  font-size: var(--fs-display);
   font-weight: 600;
   letter-spacing: -0.04em;
   line-height: 1.02;
@@ -804,7 +806,7 @@ line-height: 1.3;
 .signal-panel p,
 .coverage-panel p {
   color: var(--muted-strong);
-  font-size: clamp(15px, 1.3vw, 17px);
+  font-size: var(--fs-h3);
   line-height: 1.65;
   font-weight: 400;
 }
@@ -947,7 +949,7 @@ transition:
 .feature-card h2,
 .coverage-panel h2,
 .section-heading h2 {
-  font-size: clamp(24px, 2.6vw, 36px);
+  font-size: var(--fs-h2);
   font-weight: 600;
   letter-spacing: -0.03em;
   line-height: 1.1;
@@ -2571,7 +2573,7 @@ margin-bottom: 10px;
 
 .document-hero h1 {
   color: var(--ink-strong);
-  font-size: clamp(28px, 3.5vw, 44px);
+  font-size: var(--fs-display-sm);
   font-weight: 600;
   letter-spacing: -0.025em;
   line-height: 1.1;
@@ -2683,7 +2685,7 @@ line-height: 1.55;
 }
 
 .markdown-shell h1 {
-  font-size: clamp(28px, 3.5vw, 40px);
+  font-size: var(--fs-display-sm);
   font-weight: 600;
   letter-spacing: -0.025em;
   margin: 0 0 20px;
@@ -3540,7 +3542,7 @@ color: var(--muted);
 }
 
 .overview-hero h1 {
-  font-size: clamp(32px, 4vw, 56px);
+  font-size: var(--fs-h1);
   font-weight: 600;
   letter-spacing: -0.035em;
   line-height: 1.05;
@@ -3550,7 +3552,7 @@ color: var(--muted);
 }
 
 .overview-lede {
-  font-size: clamp(14px, 1.15vw, 16px);
+  font-size: var(--fs-md);
   line-height: 1.55;
   color: var(--muted-strong);
   max-width: 680px;
@@ -4632,7 +4634,7 @@ transition: border-color 0.15s, background 0.15s;
 @media (max-width: 720px) {
   /* Topline section headings — clamp instead of fixed sizes */
   .section-heading h2 {
-    font-size: clamp(20px, 5vw, 28px);
+    font-size: var(--fs-h3);
     line-height: 1.25;
   }
   .section-heading p {

tools/requirements.txt

@@ -0,0 +1 @@
+PyYAML>=6.0