From 7488be989ca5290df58dce38c4bb3e888d986c69 Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Wed, 28 Oct 2026 02:36:11 +0000
Subject: [PATCH] fix(preload): resolve anchor hrefs against document.baseURI
 (#704)

An anchor cloned from a <template> keeps its raw href until it is
adopted into the page, so eagerPreload's idle flush threw Invalid URL
on one a transition still held off the page.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_0117BoWNQHxQ9311k7tQMEKs
---
 .changeset/template-anchor-url.md |  5 +++++
 src/data/events.ts                |  3 ++-
 test/data/events.spec.ts          | 11 +++++++++++
 3 files changed, 18 insertions(+), 1 deletion(-)
 create mode 100644 .changeset/template-anchor-url.md

diff --git a/.changeset/template-anchor-url.md b/.changeset/template-anchor-url.md
new file mode 100644
index 00000000..e8b6c098
--- /dev/null
+++ b/.changeset/template-anchor-url.md
@@ -0,0 +1,5 @@
+---
+"@solidjs/router": patch
+---
+
+Link preloading and click handling resolve an anchor's `href` against `document.baseURI`. An anchor cloned from a `<template>` keeps its raw `href` (e.g. `/about`) until it is adopted into the page, so `eagerPreload`'s idle flush threw `Invalid URL` when it reached one that a transition still held off the page (#704).
diff --git a/src/data/events.ts b/src/data/events.ts
index 476caedb..b62c69e7 100644
--- a/src/data/events.ts
+++ b/src/data/events.ts
@@ -96,7 +96,8 @@ export function setupNativeEvents({
       const rel = (a.getAttribute("rel") || "").split(/\s+/);
       if (a.hasAttribute("download") || rel.includes("external")) return;
 
-      const url = svg ? new URL(href, document.baseURI) : new URL(href);
+      // a clone from a `<template>` keeps a raw `href` until it is adopted (#704)
+      const url = new URL(href, document.baseURI);
       // Skip non-http(s) schemes (blob:, mailto:, tel:, data:, ...). blob: URLs
       // inherit the page origin, so the origin check below won't reject them. #382
       if (url.protocol !== "https:" && url.protocol !== "http:") return;
diff --git a/test/data/events.spec.ts b/test/data/events.spec.ts
index 7cae2f78..4f881c6d 100644
--- a/test/data/events.spec.ts
+++ b/test/data/events.spec.ts
@@ -1105,5 +1105,16 @@ describe("tap and ambient preload strategies", () => {
       vi.runAllTimers();
       expect(preloaded()).toEqual(["/b:false"]);
     });
+
+    test("an anchor cloned from a template preloads before it is adopted (#704)", () => {
+      mount(eagerPreload({ all: true }));
+      const t = document.createElement("template");
+      t.innerHTML = '<a href="/a">a</a>';
+      const a = t.content.firstChild!.cloneNode(true) as HTMLAnchorElement;
+      const disposeLink = createRoot(d => (claimElement(a), d));
+      expect(() => vi.runAllTimers()).not.toThrow();
+      expect(preloaded()).toEqual(["/a:false"]);
+      disposeLink();
+    });
   });
 });