one 1.27.0 → 1.27.1

package/dist/esm/views/PreloadLinks.mjs

@@ -1,18 +1,27 @@
 import { useEffect, useRef } from "react";
 import { getURL } from "../getURL.mjs";
 import { preloadRoute } from "../router/router.mjs";
+import { shouldPreloadRoute } from "../utils/url.mjs";
 const PREFETCH_MODE = process.env.ONE_LINK_PREFETCH || "intent";
-function getHrefFromTarget(url, target) {
-  if (!(target instanceof HTMLElement)) return null;
-  const anchor = target instanceof HTMLAnchorElement ? target : target.closest("a");
-  if (!(anchor instanceof HTMLAnchorElement)) return null;
+function getPrefetchableHref(anchor, url) {
+  if (anchor.target && anchor.target !== "_self") return null;
+  if (anchor.hasAttribute("download")) return null;
+  if (anchor.getAttribute("rel")?.includes("external")) return null;
   const href = anchor.getAttribute("href");
   if (!href) return null;
   if (href[0] === "/" || href.startsWith(url)) {
-    return href.replace(url, "");
+    const cleanHref = href.replace(url, "");
+    if (!shouldPreloadRoute(cleanHref)) return null;
+    return cleanHref;
   }
   return null;
 }
+function getHrefFromTarget(url, target) {
+  if (!(target instanceof HTMLElement)) return null;
+  const anchor = target instanceof HTMLAnchorElement ? target : target.closest("a");
+  if (!(anchor instanceof HTMLAnchorElement)) return null;
+  return getPrefetchableHref(anchor, url);
+}
 function PreloadLinks() {
   if (typeof window === "undefined") {
     return null;
@@ -62,9 +71,9 @@ function PreloadLinks() {
           links.forEach(link => {
             if (seen.has(link)) return;
             seen.add(link);
-            const href = link.getAttribute("href");
+            const href = getPrefetchableHref(link, url);
             if (href) {
-              cleanups.push(observePrefetchViewport(link, href.replace(url, "")));
+              cleanups.push(observePrefetchViewport(link, href));
             }
           });
         };
@@ -100,9 +109,9 @@ function PreloadLinks() {
           links.forEach(link => {
             if (seen.has(link)) return;
             seen.add(link);
-            const href = link.getAttribute("href");
+            const href = getPrefetchableHref(link, url);
             if (href) {
-              cleanups.push(observePrefetchIntent(link, href.replace(url, "")));
+              cleanups.push(observePrefetchIntent(link, href));
             }
           });
         };
@@ -137,5 +146,5 @@ function PreloadLinks() {
   }, []);
   return null;
 }
-export { PreloadLinks };
+export { PreloadLinks, getPrefetchableHref };
 //# sourceMappingURL=PreloadLinks.mjs.map

package/dist/esm/views/PreloadLinks.mjs.map

@@ -1 +1 @@
-{"version":3,"names":["useEffect","useRef","getURL","preloadRoute","PREFETCH_MODE","process","env","ONE_LINK_PREFETCH","getHrefFromTarget","url","target","HTMLElement","anchor","HTMLAnchorElement","closest","href","getAttribute","startsWith","replace","PreloadLinks","window","import","meta","PROD","controller","AbortController","document","addEventListener","e","passive","signal","abort","cleanupRef","then","startPrefetchViewport","observePrefetchViewport","cleanups","seen","WeakSet","observeLinks","links","querySelectorAll","forEach","link","has","add","push","timeout","observer","MutationObserver","clearTimeout","setTimeout","observe","body","childList","subtree","current","c","disconnect","startPrefetchIntent","observePrefetchIntent"],"sources":["../../../src/views/PreloadLinks.tsx"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["useEffect","useRef","getURL","preloadRoute","shouldPreloadRoute","PREFETCH_MODE","process","env","ONE_LINK_PREFETCH","getPrefetchableHref","anchor","url","target","hasAttribute","getAttribute","includes","href","startsWith","cleanHref","replace","getHrefFromTarget","HTMLElement","HTMLAnchorElement","closest","PreloadLinks","window","import","meta","PROD","controller","AbortController","document","addEventListener","e","passive","signal","abort","cleanupRef","then","startPrefetchViewport","observePrefetchViewport","cleanups","seen","WeakSet","observeLinks","links","querySelectorAll","forEach","link","has","add","push","timeout","observer","MutationObserver","clearTimeout","setTimeout","observe","body","childList","subtree","current","c","disconnect","startPrefetchIntent","observePrefetchIntent"],"sources":["../../../src/views/PreloadLinks.tsx"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/dist/esm/views/PreloadLinks.test.mjs

@@ -0,0 +1,74 @@
+import { describe, expect, it } from "vitest";
+import { getPrefetchableHref } from "./PreloadLinks.mjs";
+function createMockAnchor(attrs) {
+  const el = {
+    getAttribute(name) {
+      if (name === "href") return attrs.href ?? null;
+      if (name === "rel") return attrs.rel ?? null;
+      return null;
+    },
+    hasAttribute(name) {
+      if (name === "download") return !!attrs.download;
+      return false;
+    },
+    target: attrs.target ?? ""
+  };
+  return el;
+}
+describe("getPrefetchableHref", () => {
+  const baseUrl = "https://tamagui.dev";
+  it("returns clean href for valid internal routes", () => {
+    const anchor = createMockAnchor({
+      href: "/ui/button"
+    });
+    expect(getPrefetchableHref(anchor, baseUrl)).toBe("/ui/button");
+  });
+  it("returns clean href for absolute urls matching baseUrl", () => {
+    const anchor = createMockAnchor({
+      href: "https://tamagui.dev/docs/intro"
+    });
+    expect(getPrefetchableHref(anchor, baseUrl)).toBe("/docs/intro");
+  });
+  it('returns null for target="_blank"', () => {
+    const anchor = createMockAnchor({
+      href: "/docs/intro",
+      target: "_blank"
+    });
+    expect(getPrefetchableHref(anchor, baseUrl)).toBeNull();
+  });
+  it("returns null for download attribute", () => {
+    const anchor = createMockAnchor({
+      href: "/archive.zip",
+      download: true
+    });
+    expect(getPrefetchableHref(anchor, baseUrl)).toBeNull();
+  });
+  it('returns null for rel="external"', () => {
+    const anchor = createMockAnchor({
+      href: "/docs",
+      rel: "external"
+    });
+    expect(getPrefetchableHref(anchor, baseUrl)).toBeNull();
+  });
+  it("returns null for file extensions (.md, .txt, .png, etc.)", () => {
+    expect(getPrefetchableHref(createMockAnchor({
+      href: "/ui/button.md"
+    }), baseUrl)).toBeNull();
+    expect(getPrefetchableHref(createMockAnchor({
+      href: "/llms.txt"
+    }), baseUrl)).toBeNull();
+    expect(getPrefetchableHref(createMockAnchor({
+      href: "https://tamagui.dev/ui/button.md"
+    }), baseUrl)).toBeNull();
+    expect(getPrefetchableHref(createMockAnchor({
+      href: "https://tamagui.dev/llms.txt"
+    }), baseUrl)).toBeNull();
+  });
+  it("returns null for external urls", () => {
+    const anchor = createMockAnchor({
+      href: "https://google.com/about"
+    });
+    expect(getPrefetchableHref(anchor, baseUrl)).toBeNull();
+  });
+});
+//# sourceMappingURL=PreloadLinks.test.mjs.map

package/dist/esm/views/PreloadLinks.test.mjs.map

@@ -0,0 +1 @@
+{"version":3,"names":["describe","expect","it","getPrefetchableHref","createMockAnchor","attrs","el","getAttribute","name","href","rel","hasAttribute","download","target","baseUrl","anchor","toBe","toBeNull"],"sources":["../../../src/views/PreloadLinks.test.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/dist/esm/views/PreloadLinks.test.native.js

@@ -0,0 +1,76 @@
+import { describe, expect, it } from "vitest";
+import { getPrefetchableHref } from "./PreloadLinks.native.js";
+function createMockAnchor(attrs) {
+  var _attrs_target;
+  var el = {
+    getAttribute(name) {
+      var _attrs_href, _attrs_rel;
+      if (name === "href") return (_attrs_href = attrs.href) !== null && _attrs_href !== void 0 ? _attrs_href : null;
+      if (name === "rel") return (_attrs_rel = attrs.rel) !== null && _attrs_rel !== void 0 ? _attrs_rel : null;
+      return null;
+    },
+    hasAttribute(name) {
+      if (name === "download") return !!attrs.download;
+      return false;
+    },
+    target: (_attrs_target = attrs.target) !== null && _attrs_target !== void 0 ? _attrs_target : ""
+  };
+  return el;
+}
+describe("getPrefetchableHref", function () {
+  var baseUrl = "https://tamagui.dev";
+  it("returns clean href for valid internal routes", function () {
+    var anchor = createMockAnchor({
+      href: "/ui/button"
+    });
+    expect(getPrefetchableHref(anchor, baseUrl)).toBe("/ui/button");
+  });
+  it("returns clean href for absolute urls matching baseUrl", function () {
+    var anchor = createMockAnchor({
+      href: "https://tamagui.dev/docs/intro"
+    });
+    expect(getPrefetchableHref(anchor, baseUrl)).toBe("/docs/intro");
+  });
+  it('returns null for target="_blank"', function () {
+    var anchor = createMockAnchor({
+      href: "/docs/intro",
+      target: "_blank"
+    });
+    expect(getPrefetchableHref(anchor, baseUrl)).toBeNull();
+  });
+  it("returns null for download attribute", function () {
+    var anchor = createMockAnchor({
+      href: "/archive.zip",
+      download: true
+    });
+    expect(getPrefetchableHref(anchor, baseUrl)).toBeNull();
+  });
+  it('returns null for rel="external"', function () {
+    var anchor = createMockAnchor({
+      href: "/docs",
+      rel: "external"
+    });
+    expect(getPrefetchableHref(anchor, baseUrl)).toBeNull();
+  });
+  it("returns null for file extensions (.md, .txt, .png, etc.)", function () {
+    expect(getPrefetchableHref(createMockAnchor({
+      href: "/ui/button.md"
+    }), baseUrl)).toBeNull();
+    expect(getPrefetchableHref(createMockAnchor({
+      href: "/llms.txt"
+    }), baseUrl)).toBeNull();
+    expect(getPrefetchableHref(createMockAnchor({
+      href: "https://tamagui.dev/ui/button.md"
+    }), baseUrl)).toBeNull();
+    expect(getPrefetchableHref(createMockAnchor({
+      href: "https://tamagui.dev/llms.txt"
+    }), baseUrl)).toBeNull();
+  });
+  it("returns null for external urls", function () {
+    var anchor = createMockAnchor({
+      href: "https://google.com/about"
+    });
+    expect(getPrefetchableHref(anchor, baseUrl)).toBeNull();
+  });
+});
+//# sourceMappingURL=PreloadLinks.test.native.js.map

package/dist/esm/views/PreloadLinks.test.native.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["describe","expect","it","getPrefetchableHref","createMockAnchor","attrs","_attrs_target","el","getAttribute","name","_attrs_href","_attrs_rel","href","rel","hasAttribute","download","target","baseUrl","anchor","toBe","toBeNull"],"sources":["../../../src/views/PreloadLinks.test.ts"],"sourcesContent":[null],"mappings":"AAAA,SAASA,QAAA,EAAUC,MAAA,EAAQC,EAAA,QAAU;AACrC,SAASC,mBAAA,QAA2B;AAEpC,SAASC,iBAAiBC,KAAA,EAKJ;EACpB,IAAAC,aAAW;EAAA,IACTC,EAAA;IACEC,YAAIA,CAAAC,IAAS;MACb,IAAIC,WAAS,EAAAC,UAAc;MAC3B,IAAAF,IAAO,qBAAAC,WAAA,GAAAL,KAAA,CAAAO,IAAA,cAAAF,WAAA,cAAAA,WAAA;MACT,IAAAD,IAAA,oBAAAE,UAAA,GAAAN,KAAA,CAAAQ,GAAA,cAAAF,UAAA,cAAAA,UAAA;MACA,WAAa;IACX;IACAG,YAAOA,CAAAL,IAAA;MACT,IAAAA,IAAA,0BAAAJ,KAAA,CAAAU,QAAA;MACA,OAAQ,KAAM;IAChB;IACAC,MAAO,GAAAV,aAAA,GAAAD,KAAA,CAAAW,MAAA,cAAAV,aAAA,cAAAA,aAAA;EACT;EAEA,OAASC,EAAA;AACP;AAEAP,QAAG;EACD,IAAAiB,OAAM,wBAA0B;EAChCf,EAAA,+CAA6C,cAAK;IACnD,IAAAgB,MAAA,GAAAd,gBAAA;MAEEQ,IAAA;IACD;IACAX,MAAA,CAAOE,mBAAA,CAAoBe,MAAA,EAAQD,OAAO,CAAC,EAAEE,IAAA,CAAK,aAAa;EACjE,CAAC;EAEDjB,EAAA,CAAG,uDAA0C;IAC3C,IAAAgB,MAAM,GAAAd,gBAAS;MACfQ,IAAA,EAAO;IACR;IAEDX,MAAG,CAAAE,mBAAA,CAAAe,MAAA,EAAAD,OAAuC,GAAAE,IAAM;EAC9C;EACAjB,EAAA,mCAAmC,cAAU;IAC9C,IAAAgB,MAAA,GAAAd,gBAAA;MAEEQ,IAAA;MACDI,MAAM;IACN;IACDf,MAAA,CAAAE,mBAAA,CAAAe,MAAA,EAAAD,OAAA,GAAAG,QAAA;EAED;EACElB,EAAA;IAAA,IACEgB,MAAA,GAAAd,gBAAoB;MACpBQ,IAAA,gBAAS;MACXG,QAAA;IAAA,EACE;IACFd,MAAE,CAAAE,mBAAS,CAAAe,MAAA,EAAAD,OAAA,GAAAG,QAAA;EACX;EAAAlB,EAAA,kCACE;IAAA,IACEgB,MAAA,GAAAd,gBAAyB;MAAoCQ,IAC7D;MACFC,GAAA;IACF,EAAE;IACFZ,MAAA,CAAAE,mBAAA,CAAAe,MAAA,EAAAD,OAAA,GAAAG,QAAA;EAAA;EACElB,EAAA,2DAC2B,EAAgC;IAAAD,MACzD,CAAAE,mBAAA,CAAAC,gBAAA;MACFQ,IAAA;IACF,EAAE,EAAAK,OAAS,GAAAG,QAAA;IACZnB,MAAA,CAAAE,mBAAA,CAAAC,gBAAA;MAEEQ,IAAA;IACD,IAAAK,OAAM,GAAAG,QAAS;IACfnB,MAAA,CAAOE,mBAAA,CAAoBC,gBAAgB;MAC5CQ,IAAA;IACF,IAAAK,OAAA,GAAAG,QAAA","ignoreList":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "one",
-  "version": "1.27.0",
+  "version": "1.27.1",
   "license": "BSD-3-Clause",
   "sideEffects": [
     "setup.mjs",
@@ -197,18 +197,18 @@
     "@react-navigation/routers": "~7.6.4",
     "@cloudflare/vite-plugin": "^1.33.1",
     "@ungap/structured-clone": "^1.2.0",
-    "@vxrn/color-scheme": "1.27.0",
-    "@vxrn/compiler": "1.27.0",
-    "@vxrn/resolve": "1.27.0",
-    "@vxrn/tslib-lite": "1.27.0",
-    "@vxrn/use-isomorphic-layout-effect": "1.27.0",
-    "@vxrn/vite-plugin-metro": "1.27.0",
+    "@vxrn/color-scheme": "1.27.1",
+    "@vxrn/compiler": "1.27.1",
+    "@vxrn/resolve": "1.27.1",
+    "@vxrn/tslib-lite": "1.27.1",
+    "@vxrn/use-isomorphic-layout-effect": "1.27.1",
+    "@vxrn/vite-plugin-metro": "1.27.1",
     "babel-dead-code-elimination": "1.0.10",
     "babel-plugin-module-resolver": "^5.0.2",
     "babel-preset-expo": "~57.0.5",
     "citty": "^0.1.6",
     "core-js": "^3.38.1",
-    "create-vxrn": "1.27.0",
+    "create-vxrn": "1.27.1",
     "escape-string-regexp": "^5.0.0",
     "expo-linking": "~57.0.5",
     "expo-modules-core": "~57.0.10",
@@ -229,7 +229,7 @@
     "tsconfig-paths": "^4",
     "use-latest-callback": "^0.2.3",
     "vite": "^8.2.2",
-    "vxrn": "1.27.0",
+    "vxrn": "1.27.1",
     "web-streams-polyfill": "^4.3.0",
     "ws": "^8.21.0",
     "xxhashjs": "^0.2.2"

package/src/router/router.ts

@@ -28,7 +28,7 @@ import { getLoaderPath, getPreloadCSSPath, getPreloadPath } from '../utils/clean
 import { dynamicImport } from '../utils/dynamicImport'
 import { PLATFORM } from '../utils/platform'
 import { isVersionStale } from '../skewProtection'
-import { shouldLinkExternally } from '../utils/url'
+import { hasFileExtension, shouldLinkExternally, shouldPreloadRoute } from '../utils/url'
 import {
   ParamValidationError,
   RouteValidationError,
@@ -965,6 +965,10 @@ export function getPreloadHistory(): PreloadEntry[] {
 
 export function preloadRoute(href: string, injectCSS = false): Promise<any> | undefined {
   if (process.env.TAMAGUI_TARGET !== 'native') {
+    if (!shouldPreloadRoute(href)) {
+      return
+    }
+
     // in dev mode, use a simpler preload that just fetches the loader directly
     // this avoids issues with production-only preload paths while still ensuring
     // loader data is available before navigation completes
@@ -1104,6 +1108,11 @@ export async function linkTo(
     return
   }
 
+  if (process.env.TAMAGUI_TARGET !== 'native' && hasFileExtension(href)) {
+    window.location.href = href
+    return
+  }
+
   // if a new version was detected via polling, force full page navigation
   if (isVersionStale()) {
     window.location.href = href

package/src/utils/url.test.ts

@@ -0,0 +1,67 @@
+import { describe, expect, it } from 'vitest'
+import { hasFileExtension, shouldLinkExternally, shouldPreloadRoute } from './url'
+
+describe('url utils', () => {
+  describe('hasFileExtension', () => {
+    it('returns true for common file extensions', () => {
+      expect(hasFileExtension('/ui/button.md')).toBe(true)
+      expect(hasFileExtension('/llms.txt')).toBe(true)
+      expect(hasFileExtension('/favicon.ico')).toBe(true)
+      expect(hasFileExtension('/assets/image.png')).toBe(true)
+      expect(hasFileExtension('/doc.pdf')).toBe(true)
+      expect(hasFileExtension('/data.json')).toBe(true)
+      expect(hasFileExtension('/archive.zip')).toBe(true)
+      expect(hasFileExtension('/styles.css')).toBe(true)
+      expect(hasFileExtension('/script.js')).toBe(true)
+      expect(hasFileExtension('/manifest.webmanifest')).toBe(true)
+      expect(hasFileExtension('/font.woff2')).toBe(true)
+    })
+
+    it('returns true with query params or hashes', () => {
+      expect(hasFileExtension('/ui/button.md?download=1')).toBe(true)
+      expect(hasFileExtension('/llms.txt#section')).toBe(true)
+      expect(hasFileExtension('https://tamagui.dev/ui/button.md?foo=bar#baz')).toBe(true)
+    })
+
+    it('returns false for route paths without extensions', () => {
+      expect(hasFileExtension('/')).toBe(false)
+      expect(hasFileExtension('/about')).toBe(false)
+      expect(hasFileExtension('/ui/button')).toBe(false)
+      expect(hasFileExtension('/docs/components/button')).toBe(false)
+      expect(hasFileExtension('/v1.0')).toBe(false)
+      expect(hasFileExtension('/version-2.1.0')).toBe(false)
+      expect(hasFileExtension('/docs/1.0/intro')).toBe(false)
+    })
+
+    it('returns false for empty or invalid inputs', () => {
+      expect(hasFileExtension('')).toBe(false)
+    })
+  })
+
+  describe('shouldPreloadRoute', () => {
+    it('returns true for valid internal routes', () => {
+      expect(shouldPreloadRoute('/')).toBe(true)
+      expect(shouldPreloadRoute('/about')).toBe(true)
+      expect(shouldPreloadRoute('/ui/button')).toBe(true)
+      expect(shouldPreloadRoute('/docs/components/button')).toBe(true)
+    })
+
+    it('returns false for file extensions', () => {
+      expect(shouldPreloadRoute('/ui/button.md')).toBe(false)
+      expect(shouldPreloadRoute('/llms.txt')).toBe(false)
+      expect(shouldPreloadRoute('/favicon.ico')).toBe(false)
+    })
+
+    it('returns false for external urls or schemes', () => {
+      expect(shouldPreloadRoute('https://example.com/about')).toBe(false)
+      expect(shouldPreloadRoute('http://example.com')).toBe(false)
+      expect(shouldPreloadRoute('mailto:test@example.com')).toBe(false)
+      expect(shouldPreloadRoute('tel:123456')).toBe(false)
+    })
+
+    it('returns false for hash links or empty hrefs', () => {
+      expect(shouldPreloadRoute('#section')).toBe(false)
+      expect(shouldPreloadRoute('')).toBe(false)
+    })
+  })
+})

package/src/utils/url.ts

@@ -19,3 +19,25 @@ export function shouldLinkExternally(href: string): boolean {
   // Cheap check first to avoid regex if the href is not a path fragment.
   return !/^[./]/.test(href) && (hasUrlProtocolPrefix(href) || isWellKnownUri(href))
 }
+
+const staticFileExtensionRegex = /\.(?:[a-z0-9]{2,5}|webmanifest|wasm|woff2)$/i
+
+export function hasFileExtension(href: string): boolean {
+  if (!href) return false
+  try {
+    const url = new URL(href, 'http://localhost')
+    if (url.protocol !== 'http:' && url.protocol !== 'https:') {
+      return true
+    }
+    return staticFileExtensionRegex.test(url.pathname)
+  } catch {
+    return false
+  }
+}
+
+export function shouldPreloadRoute(href: string): boolean {
+  if (!href || href[0] === '#') return false
+  if (shouldLinkExternally(href)) return false
+  if (hasFileExtension(href)) return false
+  return true
+}

package/src/views/PreloadLinks.test.ts

@@ -0,0 +1,78 @@
+import { describe, expect, it } from 'vitest'
+import { getPrefetchableHref } from './PreloadLinks'
+
+function createMockAnchor(attrs: {
+  href?: string
+  target?: string
+  download?: boolean
+  rel?: string
+}): HTMLAnchorElement {
+  const el = {
+    getAttribute(name: string) {
+      if (name === 'href') return attrs.href ?? null
+      if (name === 'rel') return attrs.rel ?? null
+      return null
+    },
+    hasAttribute(name: string) {
+      if (name === 'download') return !!attrs.download
+      return false
+    },
+    target: attrs.target ?? '',
+  } as unknown as HTMLAnchorElement
+  return el
+}
+
+describe('getPrefetchableHref', () => {
+  const baseUrl = 'https://tamagui.dev'
+
+  it('returns clean href for valid internal routes', () => {
+    const anchor = createMockAnchor({ href: '/ui/button' })
+    expect(getPrefetchableHref(anchor, baseUrl)).toBe('/ui/button')
+  })
+
+  it('returns clean href for absolute urls matching baseUrl', () => {
+    const anchor = createMockAnchor({ href: 'https://tamagui.dev/docs/intro' })
+    expect(getPrefetchableHref(anchor, baseUrl)).toBe('/docs/intro')
+  })
+
+  it('returns null for target="_blank"', () => {
+    const anchor = createMockAnchor({ href: '/docs/intro', target: '_blank' })
+    expect(getPrefetchableHref(anchor, baseUrl)).toBeNull()
+  })
+
+  it('returns null for download attribute', () => {
+    const anchor = createMockAnchor({ href: '/archive.zip', download: true })
+    expect(getPrefetchableHref(anchor, baseUrl)).toBeNull()
+  })
+
+  it('returns null for rel="external"', () => {
+    const anchor = createMockAnchor({ href: '/docs', rel: 'external' })
+    expect(getPrefetchableHref(anchor, baseUrl)).toBeNull()
+  })
+
+  it('returns null for file extensions (.md, .txt, .png, etc.)', () => {
+    expect(
+      getPrefetchableHref(createMockAnchor({ href: '/ui/button.md' }), baseUrl)
+    ).toBeNull()
+    expect(
+      getPrefetchableHref(createMockAnchor({ href: '/llms.txt' }), baseUrl)
+    ).toBeNull()
+    expect(
+      getPrefetchableHref(
+        createMockAnchor({ href: 'https://tamagui.dev/ui/button.md' }),
+        baseUrl
+      )
+    ).toBeNull()
+    expect(
+      getPrefetchableHref(
+        createMockAnchor({ href: 'https://tamagui.dev/llms.txt' }),
+        baseUrl
+      )
+    ).toBeNull()
+  })
+
+  it('returns null for external urls', () => {
+    const anchor = createMockAnchor({ href: 'https://google.com/about' })
+    expect(getPrefetchableHref(anchor, baseUrl)).toBeNull()
+  })
+})

package/src/views/PreloadLinks.tsx

@@ -2,6 +2,8 @@ import { useEffect, useRef } from 'react'
 import { getURL } from '../getURL'
 import { preloadRoute } from '../router/router'
 
+import { shouldPreloadRoute } from '../utils/url'
+
 /**
  * Resolved at build time via vite define - enables tree-shaking of unused modes.
  * Defaults to 'intent' for smart trajectory-based prefetching.
@@ -21,18 +23,27 @@ const PREFETCH_MODE = (process.env.ONE_LINK_PREFETCH || 'intent') as
  * - 'hover': Prefetches on mouseover
  * - 'false': Disabled
  */
-function getHrefFromTarget(url: string, target: EventTarget | null): string | null {
-  if (!(target instanceof HTMLElement)) return null
-  const anchor = target instanceof HTMLAnchorElement ? target : target.closest('a')
-  if (!(anchor instanceof HTMLAnchorElement)) return null
+export function getPrefetchableHref(anchor: HTMLAnchorElement, url: string): string | null {
+  if (anchor.target && anchor.target !== '_self') return null
+  if (anchor.hasAttribute('download')) return null
+  if (anchor.getAttribute('rel')?.includes('external')) return null
   const href = anchor.getAttribute('href')
   if (!href) return null
   if (href[0] === '/' || href.startsWith(url)) {
-    return href.replace(url, '')
+    const cleanHref = href.replace(url, '')
+    if (!shouldPreloadRoute(cleanHref)) return null
+    return cleanHref
   }
   return null
 }
 
+function getHrefFromTarget(url: string, target: EventTarget | null): string | null {
+  if (!(target instanceof HTMLElement)) return null
+  const anchor = target instanceof HTMLAnchorElement ? target : target.closest('a')
+  if (!(anchor instanceof HTMLAnchorElement)) return null
+  return getPrefetchableHref(anchor, url)
+}
+
 export function PreloadLinks() {
   if (typeof window === 'undefined') {
     return null
@@ -92,16 +103,16 @@ export function PreloadLinks() {
           const seen = new WeakSet<Element>()
 
           const observeLinks = () => {
-            const links = document.querySelectorAll(
+            const links = document.querySelectorAll<HTMLAnchorElement>(
               'a[href^="/"], a[href^="' + url + '"]'
             )
             links.forEach((link) => {
               if (seen.has(link)) return
               seen.add(link)
-              const href = link.getAttribute('href')
+              const href = getPrefetchableHref(link, url)
               if (href) {
                 cleanups.push(
-                  observePrefetchViewport(link as HTMLElement, href.replace(url, ''))
+                  observePrefetchViewport(link, href)
                 )
               }
             })
@@ -139,16 +150,16 @@ export function PreloadLinks() {
           const seen = new WeakSet<Element>()
 
           const observeLinks = () => {
-            const links = document.querySelectorAll(
+            const links = document.querySelectorAll<HTMLAnchorElement>(
               'a[href^="/"], a[href^="' + url + '"]'
             )
             links.forEach((link) => {
               if (seen.has(link)) return
               seen.add(link)
-              const href = link.getAttribute('href')
+              const href = getPrefetchableHref(link, url)
               if (href) {
                 cleanups.push(
-                  observePrefetchIntent(link as HTMLElement, href.replace(url, ''))
+                  observePrefetchIntent(link, href)
                 )
               }
             })

package/types/router/router.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../src/router/router.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../src/router/router.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,iCAAiC,EACjC,eAAe,EAChB,MAAM,wBAAwB,CAAA;AAE/B,OAAO,EACL,KAAK,aAAa,EAKnB,MAAM,OAAO,CAAA;AAEd,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AAErD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA;AAe1D,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,eAAe,CAAA;AAQxC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAA;AAQzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAMxC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAc/C,OAAO,EAAE,qBAAqB,EAAE,MAAM,QAAQ,CAAA;AAG9C,eAAO,IAAI,SAAS,EAAE,SAAS,GAAG,IAAW,CAAA;AAC7C,eAAO,IAAI,aAAa,EAAE,aAAa,CAAA;AAKvC;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,MAAM,EAClB,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,IAAI,GAAG,SAAS,CAAC,QAO1D;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,MAAM,QAE3D;AAmCD,+DAA+D;AAC/D,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAiBrE;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED,eAAO,IAAI,wBAAwB,SAAQ,CAAA;AAC3C,eAAO,IAAI,YAAY,EAAE,SAAS,CAAC,WAAW,GAAG,SAAS,CAAA;AAC1D,eAAO,IAAI,SAAS,EAAE,SAAS,CAAC,WAAW,GAAG,SAAS,CAAA;AAIvD,eAAO,IAAI,eAAe,EAAE,MAAM,GAAG,SAAS,CAAA;AAK9C,eAAO,IAAI,oBAAoB,EAAE,MAAM,GAAG,SAAS,CAAA;AAGnD,eAAO,IAAI,SAAS,EAAE,SAAS,GAAG,SAAS,CAAA;AAM3C,eAAO,IAAI,aAAa,EAAE,SAAS,CAAC,aAA2B,CAAA;AAU/D,MAAM,MAAM,eAAe,GAAG;IAC5B,MAAM,EAAE,MAAM,GAAG,YAAY,GAAG,OAAO,GAAG,OAAO,CAAA;IACjD,KAAK,CAAC,EAAE,KAAK,CAAA;IACb,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAC3B,CAAA;AAKD,wBAAgB,0BAA0B,CAAC,UAAU,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,iBAGtF;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,eAAe,QAyBxD;AAED,wBAAgB,kBAAkB,IAAI,eAAe,CAEpD;AAED,wBAAgB,kBAAkB,oBAMjC;AAQD,wBAAgB,UAAU,CACxB,OAAO,EAAE,GAAG,CAAC,YAAY,EACzB,GAAG,EAAE,iCAAiC,CAAC,eAAe,CAAC,aAAa,CAAC,EACrE,eAAe,CAAC,EAAE,GAAG,EACrB,OAAO,CAAC,EAAE,gBAAgB,QAqE3B;AAoCD;;;;;GAKG;AACH,wBAAgB,oCAAoC,CAClD,QAAQ,EAAE,QAAQ,CAAC,eAAe,CAAC,GAAG,SAAS,QA6ChD;AAYD,wBAAgB,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,SAAS,CAAC,aAAa,iBAE9E;AAED,wBAAgB,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,SAAS,CAAC,aAAa,iBAE1E;AAED,wBAAgB,OAAO,CAAC,KAAK,CAAC,EAAE,MAAM,QAKrC;AAED,wBAAgB,OAAO,CAAC,GAAG,EAAE,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,SAAS,CAAC,aAAa,iBAE7E;AAED,wBAAgB,SAAS,CAAC,MAAM,GAAE,SAAS,CAAC,uBAA4B,oBAMvE;AAED,wBAAgB,UAAU,SAKzB;AAED,wBAAgB,MAAM,SAMrB;AAED,wBAAgB,SAAS,IAAI,OAAO,CAKnC;AAED,wBAAgB,UAAU,IAAI,OAAO,CAcpC;AAED,wBAAgB,eAAe,gBAK9B;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,CAAC,WAAW,EAAE,cAAc,wBAAQ,QA2D/E;AAED,wBAAgB,8BAA8B,gDAI7C;AAGD,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,SAAS,CAAC,iBAAiB,cAK3E;AAQD,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,IAAI,cAKtD;AAED,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,SAAS,CAAC,oBAAoB,cAKjF;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,CAAC,YAAY,QAM5D;AAUD,wBAAgB,QAAQ;;;;;;;;;;;;;gCArae,IAAI;EAua1C;AAoBD,wBAAgB,iBAAiB,0BAEhC;AAED,wBAAgB,iBAAiB,cAEhC;AA2CD,wBAAgB,YAAY;;;;;;;;;;;;;gCA5eW,IAAI;EAgf1C;AAoBD,wBAAgB,iBAAiB,0BAQhC;AAED,wBAAgB,iBAAiB,cAWhC;AAGD,wBAAgB,OAAO,SAItB;AAED,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,GAAG,SAAS,CAAM,CAAA;AAiJ5E,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,CAAA;AAiB1D,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAA;AACtE,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,aAAa,CAAA;IACrB,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,OAAO,CAAA;IAClB,MAAM,EAAE,OAAO,CAAA;CAChB,CAAA;AA2DD,wBAAgB,iBAAiB,IAAI,YAAY,EAAE,CAElD;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,UAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,SAAS,CAkDtF;AA4DD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,UAAU,EAAE,QAGtD;AAED,wBAAsB,MAAM,CAC1B,IAAI,EAAE,MAAM,EACZ,KAAK,CAAC,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,SAAS,CAAC,aAAa,iBAmYlC"}

package/types/utils/url.d.ts

@@ -5,4 +5,6 @@
 export declare function hasUrlProtocolPrefix(href: string): boolean;
 export declare function isWellKnownUri(href: string): boolean;
 export declare function shouldLinkExternally(href: string): boolean;
+export declare function hasFileExtension(href: string): boolean;
+export declare function shouldPreloadRoute(href: string): boolean;
 //# sourceMappingURL=url.d.ts.map

package/types/utils/url.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"url.d.ts","sourceRoot":"","sources":["../../src/utils/url.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAOpD;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAG1D"}
+{"version":3,"file":"url.d.ts","sourceRoot":"","sources":["../../src/utils/url.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAOpD;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAG1D;AAID,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAWtD;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAKxD"}

package/types/utils/url.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=url.test.d.ts.map

package/types/utils/url.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url.test.d.ts","sourceRoot":"","sources":["../../src/utils/url.test.ts"],"names":[],"mappings":""}

package/types/views/PreloadLinks.d.ts

@@ -1,2 +1,12 @@
+/**
+ * Handles link prefetching in production builds.
+ *
+ * Modes:
+ * - 'intent': Predicts navigation based on mouse trajectory (default)
+ * - 'viewport': Prefetches links when they enter the viewport
+ * - 'hover': Prefetches on mouseover
+ * - 'false': Disabled
+ */
+export declare function getPrefetchableHref(anchor: HTMLAnchorElement, url: string): string | null;
 export declare function PreloadLinks(): null;
 //# sourceMappingURL=PreloadLinks.d.ts.map