From 7190295f3de31bc1e10ab42f740d69cf35a88ac3 Mon Sep 17 00:00:00 2001
From: Abdul Wahab <32850166+abdulwahabone@users.noreply.github.com>
Date: Tue, 7 Jul 2026 02:18:05 +0500
Subject: [PATCH] Fix designing phase nav and wheel layering (#348)

Co-authored-by: Abdul Wahab <abdulwahab@Abduls-MacBook-Pro-2.local>
---
 site/pages/designing/index.astro  | 17 +++++++++++++++--
 site/styles/designing-kinpaku.css |  6 ++++++
 site/styles/docs-visuals.css      | 14 +++++++++++++-
 3 files changed, 34 insertions(+), 3 deletions(-)

diff --git a/site/pages/designing/index.astro b/site/pages/designing/index.astro
index 23b8f8fd2..c8143d738 100644
--- a/site/pages/designing/index.astro
+++ b/site/pages/designing/index.astro
@@ -55,6 +55,8 @@ import '../../styles/designing-kinpaku.css';
           <line class="designing-loop-wheel-tick designing-loop-wheel-tick--cardinal" x1="2.5" y1="50" x2="5.5" y2="50"/>
           <line class="designing-loop-wheel-tick" x1="8.7" y1="27" x2="11.4" y2="28"/>
           <line class="designing-loop-wheel-tick" x1="27" y1="8.7" x2="28" y2="11.4"/>
+        </svg>
+        <svg class="designing-loop-wheel-dot-svg" viewBox="0 0 100 100" preserveAspectRatio="xMidYMid meet">
           <!-- Clockwise-orbiting accent dot, animates with offset-path. -->
           <circle class="designing-loop-wheel-dot" cx="0" cy="0" r="2.2"/>
         </svg>
@@ -473,7 +475,7 @@ import '../../styles/designing-kinpaku.css';
 <script is:inline>
   // Phase scroll-spy: highlight the active loop phase in the sticky nav as
   // the reader scrolls. The active section is the one occupying the band just
-  // under the sticky header + nav (rootMargin clears ~150px at the top).
+  // under the sticky header + nav (rootMargin clears the anchor seam).
   (function initPhaseNav() {
     const nav = document.querySelector('.designing-phasenav');
     if (!nav || !('IntersectionObserver' in window)) return;
@@ -484,9 +486,20 @@ import '../../styles/designing-kinpaku.css';
       .map((a) => document.getElementById(a.getAttribute('href').slice(1)))
       .filter(Boolean);
     if (!sections.length) return;
+    const phaseIds = new Set(sections.map((s) => s.id));
+    document.addEventListener('click', (e) => {
+      const a = e.target.closest('a[href^="#"]');
+      const id = a?.getAttribute('href')?.slice(1);
+      if (phaseIds.has(id)) setActive(id);
+    });
+    window.addEventListener('hashchange', () => {
+      const id = location.hash.slice(1);
+      if (phaseIds.has(id)) setActive(id);
+    });
+    const spyTop = matchMedia('(max-width: 600px)').matches ? 124 : 160;
     const observer = new IntersectionObserver((entries) => {
       entries.forEach((e) => { if (e.isIntersecting) setActive(e.target.id); });
-    }, { rootMargin: '-150px 0px -55% 0px', threshold: 0 });
+    }, { rootMargin: `-${spyTop}px 0px -55% 0px`, threshold: 0 });
     sections.forEach((s) => observer.observe(s));
   })();
 
diff --git a/site/styles/designing-kinpaku.css b/site/styles/designing-kinpaku.css
index f9ae6323c..8f3641364 100644
--- a/site/styles/designing-kinpaku.css
+++ b/site/styles/designing-kinpaku.css
@@ -518,6 +518,12 @@
   scroll-margin-top: 152px;
 }
 
+@media (max-width: 600px) {
+  .designing-kinpaku .designing-loop-track .designing-phase {
+    scroll-margin-top: 116px;
+  }
+}
+
 /* One deliberate, consistent break between the loop spine and the context
    tail (replaces the old maintain->appendix adjacency that fired unevenly). */
 .designing-kinpaku .designing-loop-track + .designing-phase--appendix {
diff --git a/site/styles/docs-visuals.css b/site/styles/docs-visuals.css
index 13c63681a..231b687f6 100644
--- a/site/styles/docs-visuals.css
+++ b/site/styles/docs-visuals.css
@@ -1873,7 +1873,8 @@
   justify-self: center;
 }
 
-.designing-loop-wheel-svg {
+.designing-loop-wheel-svg,
+.designing-loop-wheel-dot-svg {
   position: absolute;
   inset: 0;
   width: 100%;
@@ -1881,6 +1882,15 @@
   overflow: visible;
 }
 
+.designing-loop-wheel-svg {
+  z-index: 2;
+}
+
+.designing-loop-wheel-dot-svg {
+  z-index: 3;
+  pointer-events: none;
+}
+
 .designing-loop-wheel-ring {
   fill: none;
   stroke: var(--color-ink);
@@ -1917,6 +1927,7 @@
 
 .designing-loop-wheel-arrow {
   position: absolute;
+  z-index: 1;
   display: inline-flex;
   align-items: center;
   justify-content: center;
@@ -1940,6 +1951,7 @@
 
 .designing-loop-wheel-center {
   position: absolute;
+  z-index: 4;
   top: 50%;
   left: 50%;
   transform: translate(-50%, -50%);