From a80738c95db6406be71d53118119ef879b10d195 Mon Sep 17 00:00:00 2001
From: Ryan Cartwright <fryzee.cartwright@gmail.com>
Date: Tue, 8 Oct 2024 14:41:58 +1100
Subject: [PATCH 1/2] scroll only when headings have been reached

---
 src/app/[[...slug]]/layout.tsx           |  1 -
 src/components/layout/DocToC.tsx         | 56 ++++++++++++++++++------
 src/components/layout/DocTracingBeam.tsx | 37 +++++-----------
 3 files changed, 54 insertions(+), 40 deletions(-)

diff --git a/src/app/[[...slug]]/layout.tsx b/src/app/[[...slug]]/layout.tsx
index d871cc17f..02783991c 100644
--- a/src/app/[[...slug]]/layout.tsx
+++ b/src/app/[[...slug]]/layout.tsx
@@ -3,7 +3,6 @@ import { Prose } from '@/components/Prose'
 import React from 'react'
 import { allDocs } from '@/content'
 import DocToc from '@/components/layout/DocToC'
-import { Feedback } from '@/components/Feedback'
 import { Button } from '@/components/ui/button'
 import { GitHubIcon } from '@/components/icons/GitHubIcon'
 import Breadcrumbs from '@/components/Breadcrumbs'
diff --git a/src/components/layout/DocToC.tsx b/src/components/layout/DocToC.tsx
index e3c219f3f..5110311dc 100644
--- a/src/components/layout/DocToC.tsx
+++ b/src/components/layout/DocToC.tsx
@@ -1,20 +1,12 @@
 'use client'
 
 import type { Doc } from '@/content'
-import React, { useRef } from 'react'
-import { Badge } from '../ui/badge'
+import { useRef, useLayoutEffect, useState, useEffect } from 'react'
 import Link from 'next/link'
-import { FaFacebook, FaFilePdf, FaLinkedin } from 'react-icons/fa'
 import { DocTracingBeam } from './DocTracingBeam'
-import { BASE_URL } from '@/lib/constants'
-import { title } from 'radash'
 import { Button } from '../ui/button'
 import { GitHubIcon } from '../icons/GitHubIcon'
-
-interface Props {
-  doc: Doc
-  articleRef?: React.RefObject<HTMLDivElement>
-}
+import { useMotionValue } from 'framer-motion'
 
 interface Toc {
   url: string
@@ -22,18 +14,54 @@ interface Toc {
   depth: number
 }
 
-const DocToC: React.FC<Props> = ({ doc }) => {
-  const articleRef = useRef<HTMLDivElement>(null)
+const DocToC = ({ doc }: { doc: Doc }) => {
+  const initial = 14
+  const sectionSize = 28
+  const offset = 10
+
+  const y1 = useMotionValue(0)
+  const y2 = useMotionValue(0)
+
+  useEffect(() => {
+    const headings = document
+      .querySelectorAll<HTMLHeadingElement>('.md-content-header')
+      .values()
+      .toArray()
+
+    const options = {
+      root: null,
+      rootMargin: '0px',
+      threshold: 1, // Adjust based on when you want to highlight
+    }
+
+    const observer = new IntersectionObserver((entries) => {
+      entries.forEach((entry) => {
+        if (entry.isIntersecting) {
+          const index = headings.findIndex(
+            (heading) => heading.textContent === entry.target.textContent,
+          )
+
+          y2.set(initial + (index * sectionSize + offset))
+        }
+      })
+    }, options)
+
+    headings.forEach((h2) => observer.observe(h2))
+
+    return () => {
+      headings.forEach((h2) => observer.unobserve(h2))
+    }
+  }, [])
 
   return (
-    <div className="hidden h-full min-w-52 md:block" ref={articleRef}>
+    <div className="hidden h-full min-w-52 md:block">
       <aside className="sticky top-[calc(var(--header-height)+1px+2rem)] max-h-[calc(100vh-var(--header-height)-3rem)] min-w-40 space-y-6">
         {doc.toc.length ? (
           <div className="relative flex flex-col">
             <p className="mb-2 font-mono text-sm uppercase dark:text-zinc-300">
               On this page
             </p>
-            <DocTracingBeam targetRef={articleRef}>
+            <DocTracingBeam y1={y1} y2={y2}>
               <ol className="flex flex-col gap-y-1 pl-4 text-sm font-medium">
                 {doc.toc.map((item: Toc, i: number) => {
                   return (
diff --git a/src/components/layout/DocTracingBeam.tsx b/src/components/layout/DocTracingBeam.tsx
index 7ccf3ca41..23032ee9b 100644
--- a/src/components/layout/DocTracingBeam.tsx
+++ b/src/components/layout/DocTracingBeam.tsx
@@ -1,24 +1,26 @@
 'use client'
 
 import React, { useEffect, useRef, useState } from 'react'
-import { motion, useTransform, useScroll, useSpring } from 'framer-motion'
+import {
+  motion,
+  useTransform,
+  useSpring,
+  useMotionValue,
+  MotionValue,
+} from 'framer-motion'
 import { cn } from '@/lib/utils'
 
-// TODO this should set the height based off the h2 offset heights, not current scroll progress
 export const DocTracingBeam = ({
   children,
   className,
-  targetRef,
+  y1,
+  y2,
 }: {
   children: React.ReactNode
   className?: string
-  targetRef: React.RefObject<HTMLDivElement>
+  y1: MotionValue<number>
+  y2: MotionValue<number>
 }) => {
-  const { scrollYProgress } = useScroll({
-    target: targetRef,
-    offset: ['start start', 'end end'],
-  })
-
   const contentRef = useRef<HTMLDivElement>(null)
   const [svgHeight, setSvgHeight] = useState(0)
 
@@ -28,21 +30,6 @@ export const DocTracingBeam = ({
     }
   }, [])
 
-  const y1 = useSpring(
-    useTransform(scrollYProgress, [0, 0.8], [0, svgHeight]),
-    {
-      stiffness: 500,
-      damping: 90,
-    },
-  )
-  const y2 = useSpring(
-    useTransform(scrollYProgress, [0, 1], [0, svgHeight - 210]),
-    {
-      stiffness: 500,
-      damping: 90,
-    },
-  )
-
   return (
     <motion.div
       className={cn('relative mx-auto h-full w-full max-w-4xl', className)}
@@ -81,7 +68,7 @@ export const DocTracingBeam = ({
               x1="0"
               x2="0"
               y1={y1} // set y1 for gradient
-              y2={y2} // set y2 for gradient
+              y2={useSpring(y2)} // set y2 for gradient
             >
               <stop stopColor="var(--primary-500)" stopOpacity="0"></stop>
               <stop stopColor="var(--primary-500)"></stop>

From 35a38ffcced5fb5ae82c1629f4e0e139b064b424 Mon Sep 17 00:00:00 2001
From: Ryan Cartwright <fryzee.cartwright@gmail.com>
Date: Tue, 8 Oct 2024 15:44:03 +1100
Subject: [PATCH 2/2] add highlighting to headings on scroll

---
 src/components/layout/DocToC.tsx | 14 ++++++++++++--
 1 file changed, 12 insertions(+), 2 deletions(-)

diff --git a/src/components/layout/DocToC.tsx b/src/components/layout/DocToC.tsx
index 5110311dc..117b5f706 100644
--- a/src/components/layout/DocToC.tsx
+++ b/src/components/layout/DocToC.tsx
@@ -7,6 +7,7 @@ import { DocTracingBeam } from './DocTracingBeam'
 import { Button } from '../ui/button'
 import { GitHubIcon } from '../icons/GitHubIcon'
 import { useMotionValue } from 'framer-motion'
+import { cn } from '@/lib/utils'
 
 interface Toc {
   url: string
@@ -22,9 +23,11 @@ const DocToC = ({ doc }: { doc: Doc }) => {
   const y1 = useMotionValue(0)
   const y2 = useMotionValue(0)
 
+  const [activeIndex, setActiveIndex] = useState(-1)
+
   useEffect(() => {
     const headings = document
-      .querySelectorAll<HTMLHeadingElement>('.md-content-header')
+      .querySelectorAll<HTMLHeadingElement>('h2.md-content-header')
       .values()
       .toArray()
 
@@ -42,6 +45,8 @@ const DocToC = ({ doc }: { doc: Doc }) => {
           )
 
           y2.set(initial + (index * sectionSize + offset))
+
+          setActiveIndex(index)
         }
       })
     }, options)
@@ -68,7 +73,12 @@ const DocToC = ({ doc }: { doc: Doc }) => {
                     <li key={item.url + i}>
                       <Link
                         href={item.url}
-                        className="text-2xs text-muted-foreground transition-colors hover:text-zinc-900 dark:hover:text-zinc-200"
+                        className={cn(
+                          'text-2xs',
+                          activeIndex === i
+                            ? 'text-zinc-900 dark:text-zinc-200'
+                            : 'text-muted-foreground transition-colors hover:text-zinc-900 dark:hover:text-zinc-200',
+                        )}
                       >
                         {item.value}
                       </Link>