From 6974037f27529a3e5ad514bb1be49a26891be79b Mon Sep 17 00:00:00 2001
From: Rachael Rose Renk <91027132+rachaelrenk@users.noreply.github.com>
Date: Wed, 20 May 2026 12:16:01 -1000
Subject: [PATCH 1/2] Add copy feedback to heading anchors

Co-Authored-By: Oz <oz-agent@warp.dev>
---
 src/components/CustomHead.astro | 103 ++++++++++++++++++++++++++++++++
 1 file changed, 103 insertions(+)

diff --git a/src/components/CustomHead.astro b/src/components/CustomHead.astro
index 395bc263..6f3ce558 100644
--- a/src/components/CustomHead.astro
+++ b/src/components/CustomHead.astro
@@ -33,6 +33,109 @@ const fontsHref =
 	if ('scrollRestoration' in history) history.scrollRestoration = 'auto';
 </script>
 
+<!--
+  Make Starlight's heading anchor icons behave like GitBook's: clicking the
+  icon copies the absolute section URL to the clipboard instead of only
+  navigating to the fragment. The URL still updates so the page state matches
+  the copied link.
+-->
+<script is:inline>
+	const copiedTimers = new WeakMap();
+
+	function copyText(text) {
+		if (navigator.clipboard?.writeText) {
+			return navigator.clipboard.writeText(text);
+		}
+
+		const textarea = document.createElement('textarea');
+		textarea.value = text;
+		textarea.setAttribute('readonly', '');
+		textarea.style.position = 'fixed';
+		textarea.style.opacity = '0';
+		document.body.appendChild(textarea);
+		textarea.select();
+
+		try {
+			document.execCommand('copy');
+			return Promise.resolve();
+		} finally {
+			textarea.remove();
+		}
+	}
+
+	function showCopiedFeedback(anchor) {
+		const previousTimer = copiedTimers.get(anchor);
+		if (previousTimer) window.clearTimeout(previousTimer);
+
+		const previousLabel = anchor.getAttribute('aria-label');
+		anchor.dataset.copied = 'true';
+		anchor.setAttribute('aria-label', 'Copied section link to clipboard');
+		anchor.setAttribute('title', 'Copied');
+
+		const timer = window.setTimeout(() => {
+			delete anchor.dataset.copied;
+			if (previousLabel) {
+				anchor.setAttribute('aria-label', previousLabel);
+			} else {
+				anchor.removeAttribute('aria-label');
+			}
+			anchor.removeAttribute('title');
+			copiedTimers.delete(anchor);
+		}, 1800);
+
+		copiedTimers.set(anchor, timer);
+	}
+
+	document.addEventListener('click', async (event) => {
+		const target = event.target;
+		if (!(target instanceof Element)) return;
+
+		const anchor = target.closest('a.sl-anchor-link');
+		if (!anchor) return;
+
+		const href = anchor.getAttribute('href');
+		if (!href) return;
+
+		event.preventDefault();
+
+		const url = new URL(href, window.location.href);
+
+		try {
+			await copyText(url.href);
+			history.pushState(null, '', url);
+			showCopiedFeedback(anchor);
+		} catch {
+			window.location.href = href;
+		}
+	});
+</script>
+
+<style is:global>
+	a.sl-anchor-link {
+		position: relative;
+	}
+
+	a.sl-anchor-link[data-copied='true']::after {
+		content: 'Copied';
+		position: absolute;
+		top: 50%;
+		left: 100%;
+		transform: translate(0.35rem, -50%);
+		padding: 0.15rem 0.35rem;
+		border: 1px solid var(--sl-color-hairline-light);
+		border-radius: var(--sl-radius-sm);
+		background: var(--sl-color-bg);
+		color: var(--sl-color-gray-2);
+		font-size: var(--sl-text-xs);
+		font-weight: 500;
+		line-height: 1;
+		letter-spacing: 0;
+		white-space: nowrap;
+		pointer-events: none;
+		box-shadow: 0 0.25rem 0.75rem rgba(0, 0, 0, 0.2);
+	}
+</style>
+
 <!-- Google Fonts: preconnect, preload, then non-blocking stylesheet swap. -->
 <link rel="preconnect" href="https://fonts.googleapis.com" />
 <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />

From c4453a6d4b1e16c66f2a2190f159fd7e6f8e806f Mon Sep 17 00:00:00 2001
From: Rachael Rose Renk <91027132+rachaelrenk@users.noreply.github.com>
Date: Wed, 20 May 2026 13:15:06 -1000
Subject: [PATCH 2/2] Preserve heading anchor aria labels

Co-Authored-By: Oz <oz-agent@warp.dev>
---
 src/components/CustomHead.astro | 14 +++++++++-----
 1 file changed, 9 insertions(+), 5 deletions(-)

diff --git a/src/components/CustomHead.astro b/src/components/CustomHead.astro
index 6f3ce558..8b454e8b 100644
--- a/src/components/CustomHead.astro
+++ b/src/components/CustomHead.astro
@@ -41,6 +41,7 @@ const fontsHref =
 -->
 <script is:inline>
 	const copiedTimers = new WeakMap();
+	const originalLabels = new WeakMap();
 
 	function copyText(text) {
 		if (navigator.clipboard?.writeText) {
@@ -66,21 +67,24 @@ const fontsHref =
 	function showCopiedFeedback(anchor) {
 		const previousTimer = copiedTimers.get(anchor);
 		if (previousTimer) window.clearTimeout(previousTimer);
-
-		const previousLabel = anchor.getAttribute('aria-label');
+		if (!originalLabels.has(anchor)) {
+			originalLabels.set(anchor, anchor.getAttribute('aria-label'));
+		}
 		anchor.dataset.copied = 'true';
 		anchor.setAttribute('aria-label', 'Copied section link to clipboard');
 		anchor.setAttribute('title', 'Copied');
 
 		const timer = window.setTimeout(() => {
+			const originalLabel = originalLabels.get(anchor);
 			delete anchor.dataset.copied;
-			if (previousLabel) {
-				anchor.setAttribute('aria-label', previousLabel);
-			} else {
+			if (originalLabel === null || typeof originalLabel === 'undefined') {
 				anchor.removeAttribute('aria-label');
+			} else {
+				anchor.setAttribute('aria-label', originalLabel);
 			}
 			anchor.removeAttribute('title');
 			copiedTimers.delete(anchor);
+			originalLabels.delete(anchor);
 		}, 1800);
 
 		copiedTimers.set(anchor, timer);