@real-router/preload-plugin 0.4.3 → 0.5.0

package/dist/cjs/index.js

@@ -1,2 +1,2 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});let e=require(`@real-router/core/api`);const t={delay:65,networkAware:!0},n={capture:!0,passive:!0};function r(){let e=navigator.connection;return e?!!(e.saveData||e.effectiveType?.includes(`2g`)):!1}var i=class{#e;#t;#n;#r;#i;#a=new Map;#o=new Map;#s=null;#c=null;#l=null;#u=0;#d=null;#f=NaN;constructor(e,t,n,r){this.#e=e,this.#t=t,this.#n=n,this.#r=r;let i={...n};this.#i=t.extendRouter({getPreloadSettings:()=>i,getPreloadedState:e=>{let t=this.#o.get(e);return t&&this.#o.delete(e),t}})}getPlugin(){return{onStart:()=>{document.addEventListener(`mouseover`,this.#p,n),document.addEventListener(`touchstart`,this.#m,n),document.addEventListener(`touchmove`,this.#h,n)},onStop:()=>{this.#C()},teardown:()=>{this.#C(),this.#i()}}}#p=e=>{if(this.#b(e))return;let t=this.#g(e.target);if(t===this.#s)return;this.#x(),this.#s=t;let n=this.#_(t);n&&(this.#c=setTimeout(()=>{this.#c=null,n.fn(n.params).catch(()=>{})},this.#n.delay))};#m=e=>{this.#d=e.target,this.#f=e.timeStamp,this.#S();let t=this.#g(e.target),n=this.#_(t);!n||e.touches.length===0||(this.#u=e.touches[0].clientY,this.#l=setTimeout(()=>{this.#l=null,n.fn(n.params).catch(()=>{})},100))};#h=e=>{this.#l===null||e.touches.length===0||Math.abs(e.touches[0].clientY-this.#u)>10&&this.#S()};#g(e){return e instanceof Element?e.closest(`a[href]`):null}#_(e){if(e&&!(`noPreload`in e.dataset)&&!(this.#n.networkAware&&r()))return this.#v(e)}#v(e){let t=this.#e.matchUrl?.(e.href);if(!t)return;this.#y(e.href,t);let n=this.#t.getRouteConfig(t.name),r=typeof n?.preload==`function`?n.preload:void 0;if(!r){this.#a.delete(t.name);return}let i=this.#a.get(t.name);if(i?.factory===r)return{fn:i.fn,params:t.params};let a;try{a=r(this.#e,this.#r)}catch{return}return this.#a.set(t.name,{fn:a,factory:r}),{fn:a,params:t.params}}#y(e,t){if(this.#o.has(e))this.#o.delete(e);else if(this.#o.size>=32)for(let e of this.#o.keys()){this.#o.delete(e);break}this.#o.set(e,t)}#b(e){let t=e.timeStamp-this.#f;return t>=0&&t<2500&&e.target===this.#d}#x(){this.#c!==null&&(clearTimeout(this.#c),this.#c=null),this.#s=null}#S(){this.#l!==null&&(clearTimeout(this.#l),this.#l=null)}#C(){document.removeEventListener(`mouseover`,this.#p,n),document.removeEventListener(`touchstart`,this.#m,n),document.removeEventListener(`touchmove`,this.#h,n),this.#x(),this.#S(),this.#d=null,this.#f=NaN,this.#o.clear()}};function a(n){let r={...t,...n};return(!Number.isFinite(r.delay)||r.delay<0)&&(r.delay=0),function(t,n){return typeof document>`u`?{}:new i(t,(0,e.getPluginApi)(t),r,n).getPlugin()}}exports.preloadPluginFactory=a;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});let e=require("@real-router/core/api");const t={delay:65,networkAware:!0},n={capture:!0,passive:!0};function r(){let e=navigator.connection;return e?!!(e.saveData||e.effectiveType?.includes(`2g`)):!1}var i=class{#e;#t;#n;#r;#i;#a;#o=new Map;#s=new Map;#c=null;#l=null;#u=null;#d=0;#f=null;#p=NaN;constructor(t,n,r,i){this.#e=t,this.#t=n,this.#n=r,this.#r=i;let a={...r};this.#i=n.extendRouter({getPreloadSettings:()=>a,getPreloadedState:e=>{let t=this.#s.get(e);return t&&this.#s.delete(e),t}}),this.#a=(0,e.getRoutesApi)(t).subscribeChanges(e=>{this.#m(e)})}getPlugin(){return{onStart:()=>{document.addEventListener(`mouseover`,this.#g,n),document.addEventListener(`touchstart`,this.#_,n),document.addEventListener(`touchmove`,this.#v,n)},onStop:()=>{this.#E()},teardown:()=>{this.#E(),this.#a(),this.#i()}}}#m(e){switch(e.op){case`remove`:for(let t of e.removedSubtree)this.#o.delete(t.name);this.#h();break;case`replace`:for(let t of e.removed)this.#o.delete(t.name);this.#h();break;case`clear`:this.#o.clear(),this.#h();break}}#h(){this.#s.clear()}#g=e=>{if(this.#C(e))return;let t=this.#y(e.target);if(t===this.#c)return;this.#w(),this.#c=t;let n=this.#b(t);n&&(this.#l=setTimeout(()=>{this.#l=null,n.fn(n.params).catch(()=>{})},this.#n.delay))};#_=e=>{this.#f=e.target,this.#p=e.timeStamp,this.#T();let t=this.#y(e.target),n=this.#b(t);!n||e.touches.length===0||(this.#d=e.touches[0].clientY,this.#u=setTimeout(()=>{this.#u=null,n.fn(n.params).catch(()=>{})},100))};#v=e=>{this.#u===null||e.touches.length===0||Math.abs(e.touches[0].clientY-this.#d)>10&&this.#T()};#y(e){return e instanceof Element?e.closest(`a[href]`):null}#b(e){if(e&&!(`noPreload`in e.dataset)&&!(this.#n.networkAware&&r()))return this.#x(e)}#x(e){let t=this.#e.matchUrl?.(e.href);if(!t)return;this.#S(e.href,t);let n=this.#t.getRouteConfig(t.name),r=typeof n?.preload==`function`?n.preload:void 0;if(!r){this.#o.delete(t.name);return}let i=this.#o.get(t.name);if(i?.factory===r)return{fn:i.fn,params:t.params};let a;try{a=r(this.#e,this.#r)}catch{return}return this.#o.set(t.name,{fn:a,factory:r}),{fn:a,params:t.params}}#S(e,t){if(this.#s.has(e))this.#s.delete(e);else if(this.#s.size>=32)for(let e of this.#s.keys()){this.#s.delete(e);break}this.#s.set(e,t)}#C(e){let t=e.timeStamp-this.#p;return t>=0&&t<2500&&e.target===this.#f}#w(){this.#l!==null&&(clearTimeout(this.#l),this.#l=null),this.#c=null}#T(){this.#u!==null&&(clearTimeout(this.#u),this.#u=null)}#E(){document.removeEventListener(`mouseover`,this.#g,n),document.removeEventListener(`touchstart`,this.#_,n),document.removeEventListener(`touchmove`,this.#v,n),this.#w(),this.#T(),this.#f=null,this.#p=NaN,this.#s.clear()}};function a(n){let r={...t,...n};return(!Number.isFinite(r.delay)||r.delay<0)&&(r.delay=0),function(t,n){return typeof document>`u`?{}:new i(t,(0,e.getPluginApi)(t),r,n).getPlugin()}}exports.preloadPluginFactory=a;
 //# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["#router","#api","#options","#getDependency","#removeExtensions","#compiledPreloads","#stateCache","#handleMouseOver","#handleTouchStart","#handleTouchMove","#cleanup","#isGhostMouseEvent","#findAnchor","#currentAnchor","#cancelHover","#resolveAnchorPreload","#hoverTimer","#lastTouchTarget","#lastTouchTimeStamp","#cancelTouch","#touchStartY","#touchTimer","#resolvePreload","#cacheState"],"sources":["../../src/constants.ts","../../src/network.ts","../../src/plugin.ts","../../src/factory.ts"],"sourcesContent":["import type { PreloadPluginOptions } from \"./types\";\n\nexport const defaultOptions: Required<PreloadPluginOptions> = {\n  delay: 65,\n  networkAware: true,\n};\n\nexport const GHOST_EVENT_THRESHOLD = 2500;\n\nexport const TOUCH_SCROLL_THRESHOLD = 10;\n\nexport const TOUCH_PRELOAD_DELAY = 100;\n\nexport const LISTENER_OPTIONS: AddEventListenerOptions = {\n  capture: true,\n  passive: true,\n};\n","type NetworkConnection =\n  | { saveData?: boolean; effectiveType?: string }\n  | undefined;\n\ninterface NavigatorWithConnection extends Navigator {\n  connection?: NetworkConnection;\n}\n\nexport function isSlowConnection(): boolean {\n  const connection = (navigator as NavigatorWithConnection).connection;\n\n  if (!connection) {\n    return false;\n  }\n  if (connection.saveData) {\n    return true;\n  }\n  if (connection.effectiveType?.includes(\"2g\")) {\n    return true;\n  }\n\n  return false;\n}\n","import {\n  GHOST_EVENT_THRESHOLD,\n  LISTENER_OPTIONS,\n  TOUCH_PRELOAD_DELAY,\n  TOUCH_SCROLL_THRESHOLD,\n} from \"./constants\";\nimport { isSlowConnection } from \"./network\";\n\nimport type {\n  PreloadFn,\n  PreloadFnFactory,\n  PreloadPluginOptions,\n} from \"./types\";\nimport type {\n  Params,\n  Plugin,\n  PluginFactory,\n  Router,\n  State,\n} from \"@real-router/core\";\nimport type { PluginApi } from \"@real-router/core/api\";\n\ndeclare module \"@real-router/core\" {\n  interface Router {\n    matchUrl?: (url: string) => State | undefined;\n  }\n}\n\nconst STATE_CACHE_LIMIT = 32;\n\nexport class PreloadPlugin {\n  readonly #router: Router;\n  readonly #api: PluginApi;\n  readonly #options: Required<PreloadPluginOptions>;\n  readonly #getDependency: Parameters<PluginFactory>[1];\n  readonly #removeExtensions: () => void;\n  readonly #compiledPreloads = new Map<\n    string,\n    { fn: PreloadFn; factory: PreloadFnFactory }\n  >();\n  // Pre-resolved State cache keyed by anchor href. Populated when a hover/touch\n  // resolves a route via router.matchUrl, consumed once via\n  // router.getPreloadedState(href). Single-use semantics (delete-on-read) keep\n  // the cache from drifting out of sync with current world state — once the\n  // consumer commits the snapshot via api.navigateToState, the entry is gone.\n  // Bounded with insertion-order eviction (#562).\n  readonly #stateCache = new Map<string, State>();\n\n  #currentAnchor: HTMLAnchorElement | null = null;\n  #hoverTimer: ReturnType<typeof setTimeout> | null = null;\n  #touchTimer: ReturnType<typeof setTimeout> | null = null;\n  #touchStartY = 0;\n  #lastTouchTarget: EventTarget | null = null;\n  #lastTouchTimeStamp = Number.NaN;\n\n  constructor(\n    router: Router,\n    api: PluginApi,\n    options: Required<PreloadPluginOptions>,\n    getDependency: Parameters<PluginFactory>[1],\n  ) {\n    this.#router = router;\n    this.#api = api;\n    this.#options = options;\n    this.#getDependency = getDependency;\n\n    const cachedOptions = { ...options };\n\n    this.#removeExtensions = api.extendRouter({\n      getPreloadSettings: () => cachedOptions,\n      getPreloadedState: (href: string): State | undefined => {\n        const state = this.#stateCache.get(href);\n\n        if (state) {\n          this.#stateCache.delete(href);\n        }\n\n        return state;\n      },\n    });\n  }\n\n  getPlugin(): Plugin {\n    return {\n      onStart: () => {\n        document.addEventListener(\n          \"mouseover\",\n          this.#handleMouseOver,\n          LISTENER_OPTIONS,\n        );\n        document.addEventListener(\n          \"touchstart\",\n          this.#handleTouchStart,\n          LISTENER_OPTIONS,\n        );\n        document.addEventListener(\n          \"touchmove\",\n          this.#handleTouchMove,\n          LISTENER_OPTIONS,\n        );\n      },\n\n      onStop: () => {\n        this.#cleanup();\n      },\n\n      teardown: () => {\n        this.#cleanup();\n        this.#removeExtensions();\n      },\n    };\n  }\n\n  readonly #handleMouseOver = (event: MouseEvent): void => {\n    if (this.#isGhostMouseEvent(event)) {\n      return;\n    }\n\n    const anchor = this.#findAnchor(event.target);\n\n    if (anchor === this.#currentAnchor) {\n      return;\n    }\n\n    this.#cancelHover();\n    this.#currentAnchor = anchor;\n\n    const preload = this.#resolveAnchorPreload(anchor);\n\n    if (!preload) {\n      return;\n    }\n\n    this.#hoverTimer = setTimeout(() => {\n      this.#hoverTimer = null;\n      preload.fn(preload.params).catch(() => {});\n    }, this.#options.delay);\n  };\n\n  readonly #handleTouchStart = (event: TouchEvent): void => {\n    this.#lastTouchTarget = event.target;\n    this.#lastTouchTimeStamp = event.timeStamp;\n\n    this.#cancelTouch();\n\n    const anchor = this.#findAnchor(event.target);\n    const preload = this.#resolveAnchorPreload(anchor);\n\n    if (!preload || event.touches.length === 0) {\n      return;\n    }\n\n    this.#touchStartY = event.touches[0].clientY;\n\n    this.#touchTimer = setTimeout(() => {\n      this.#touchTimer = null;\n      preload.fn(preload.params).catch(() => {});\n    }, TOUCH_PRELOAD_DELAY);\n  };\n\n  readonly #handleTouchMove = (event: TouchEvent): void => {\n    if (this.#touchTimer === null || event.touches.length === 0) {\n      return;\n    }\n\n    const deltaY = Math.abs(event.touches[0].clientY - this.#touchStartY);\n\n    if (deltaY > TOUCH_SCROLL_THRESHOLD) {\n      this.#cancelTouch();\n    }\n  };\n\n  #findAnchor(target: EventTarget | null): HTMLAnchorElement | null {\n    return target instanceof Element\n      ? target.closest<HTMLAnchorElement>(\"a[href]\")\n      : null;\n  }\n\n  #resolveAnchorPreload(\n    anchor: HTMLAnchorElement | null | undefined,\n  ): { fn: PreloadFn; params: Params } | undefined {\n    if (!anchor) {\n      return undefined;\n    }\n\n    if (\"noPreload\" in anchor.dataset) {\n      return undefined;\n    }\n\n    if (this.#options.networkAware && isSlowConnection()) {\n      return undefined;\n    }\n\n    return this.#resolvePreload(anchor);\n  }\n\n  #resolvePreload(\n    anchor: HTMLAnchorElement,\n  ): { fn: PreloadFn; params: Params } | undefined {\n    const state = this.#router.matchUrl?.(anchor.href);\n\n    if (!state) {\n      return undefined;\n    }\n\n    this.#cacheState(anchor.href, state);\n\n    const config = this.#api.getRouteConfig(state.name);\n    const factory =\n      typeof config?.preload === \"function\"\n        ? (config.preload as PreloadFnFactory)\n        : undefined;\n\n    if (!factory) {\n      this.#compiledPreloads.delete(state.name);\n\n      return undefined;\n    }\n\n    const cached = this.#compiledPreloads.get(state.name);\n\n    if (cached?.factory === factory) {\n      return { fn: cached.fn, params: state.params };\n    }\n\n    let fn: PreloadFn;\n\n    try {\n      fn = factory(this.#router, this.#getDependency);\n    } catch {\n      return undefined;\n    }\n\n    this.#compiledPreloads.set(state.name, { fn, factory });\n\n    return { fn, params: state.params };\n  }\n\n  #cacheState(href: string, state: State): void {\n    // Re-insert to refresh recency ordering (Map iteration is insertion order).\n    if (this.#stateCache.has(href)) {\n      this.#stateCache.delete(href);\n    } else if (this.#stateCache.size >= STATE_CACHE_LIMIT) {\n      // size >= LIMIT > 0 → iterator has at least one key.\n      for (const oldest of this.#stateCache.keys()) {\n        this.#stateCache.delete(oldest);\n\n        break;\n      }\n    }\n\n    this.#stateCache.set(href, state);\n  }\n\n  #isGhostMouseEvent(event: MouseEvent): boolean {\n    const delta = event.timeStamp - this.#lastTouchTimeStamp;\n\n    return (\n      delta >= 0 &&\n      delta < GHOST_EVENT_THRESHOLD &&\n      event.target === this.#lastTouchTarget\n    );\n  }\n\n  #cancelHover(): void {\n    if (this.#hoverTimer !== null) {\n      clearTimeout(this.#hoverTimer);\n      this.#hoverTimer = null;\n    }\n\n    this.#currentAnchor = null;\n  }\n\n  #cancelTouch(): void {\n    if (this.#touchTimer !== null) {\n      clearTimeout(this.#touchTimer);\n      this.#touchTimer = null;\n    }\n  }\n\n  #cleanup(): void {\n    document.removeEventListener(\n      \"mouseover\",\n      this.#handleMouseOver,\n      LISTENER_OPTIONS,\n    );\n    document.removeEventListener(\n      \"touchstart\",\n      this.#handleTouchStart,\n      LISTENER_OPTIONS,\n    );\n    document.removeEventListener(\n      \"touchmove\",\n      this.#handleTouchMove,\n      LISTENER_OPTIONS,\n    );\n\n    this.#cancelHover();\n    this.#cancelTouch();\n    this.#lastTouchTarget = null;\n    this.#lastTouchTimeStamp = Number.NaN;\n    this.#stateCache.clear();\n  }\n}\n","import { getPluginApi } from \"@real-router/core/api\";\n\nimport { defaultOptions } from \"./constants\";\nimport { PreloadPlugin } from \"./plugin\";\n\nimport type { PreloadPluginOptions } from \"./types\";\nimport type { PluginFactory, Router } from \"@real-router/core\";\n\nexport function preloadPluginFactory(\n  opts?: Partial<PreloadPluginOptions>,\n): PluginFactory {\n  const options: Required<PreloadPluginOptions> = {\n    ...defaultOptions,\n    ...opts,\n  };\n\n  if (!Number.isFinite(options.delay) || options.delay < 0) {\n    options.delay = 0;\n  }\n\n  return function preloadPlugin(routerBase, getDependency) {\n    if (typeof document === \"undefined\") {\n      return {};\n    }\n\n    const plugin = new PreloadPlugin(\n      routerBase as Router,\n      getPluginApi(routerBase),\n      options,\n      getDependency,\n    );\n\n    return plugin.getPlugin();\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":["#router","#api","#options","#getDependency","#removeExtensions","#removeChangesSubscription","#compiledPreloads","#stateCache","#onTreeChanged","#handleMouseOver","#handleTouchStart","#handleTouchMove","#cleanup","#invalidateStateCache","#isGhostMouseEvent","#findAnchor","#currentAnchor","#cancelHover","#resolveAnchorPreload","#hoverTimer","#lastTouchTarget","#lastTouchTimeStamp","#cancelTouch","#touchStartY","#touchTimer","#resolvePreload","#cacheState"],"sources":["../../src/constants.ts","../../src/network.ts","../../src/plugin.ts","../../src/factory.ts"],"sourcesContent":["import type { PreloadPluginOptions } from \"./types\";\n\nexport const defaultOptions: Required<PreloadPluginOptions> = {\n  delay: 65,\n  networkAware: true,\n};\n\nexport const GHOST_EVENT_THRESHOLD = 2500;\n\nexport const TOUCH_SCROLL_THRESHOLD = 10;\n\nexport const TOUCH_PRELOAD_DELAY = 100;\n\nexport const LISTENER_OPTIONS: AddEventListenerOptions = {\n  capture: true,\n  passive: true,\n};\n","type NetworkConnection =\n  | { saveData?: boolean; effectiveType?: string }\n  | undefined;\n\ninterface NavigatorWithConnection extends Navigator {\n  connection?: NetworkConnection;\n}\n\nexport function isSlowConnection(): boolean {\n  const connection = (navigator as NavigatorWithConnection).connection;\n\n  if (!connection) {\n    return false;\n  }\n  if (connection.saveData) {\n    return true;\n  }\n  if (connection.effectiveType?.includes(\"2g\")) {\n    return true;\n  }\n\n  return false;\n}\n","import { getRoutesApi } from \"@real-router/core/api\";\n\nimport {\n  GHOST_EVENT_THRESHOLD,\n  LISTENER_OPTIONS,\n  TOUCH_PRELOAD_DELAY,\n  TOUCH_SCROLL_THRESHOLD,\n} from \"./constants\";\nimport { isSlowConnection } from \"./network\";\n\nimport type {\n  PreloadFn,\n  PreloadFnFactory,\n  PreloadPluginOptions,\n} from \"./types\";\nimport type {\n  Params,\n  Plugin,\n  PluginFactory,\n  Router,\n  State,\n  TreeChangedEvent,\n} from \"@real-router/core\";\nimport type { PluginApi } from \"@real-router/core/api\";\n\ndeclare module \"@real-router/core\" {\n  interface Router {\n    matchUrl?: (url: string) => State | undefined;\n  }\n}\n\nconst STATE_CACHE_LIMIT = 32;\n\nexport class PreloadPlugin {\n  readonly #router: Router;\n  readonly #api: PluginApi;\n  readonly #options: Required<PreloadPluginOptions>;\n  readonly #getDependency: Parameters<PluginFactory>[1];\n  readonly #removeExtensions: () => void;\n  readonly #removeChangesSubscription: () => void;\n  readonly #compiledPreloads = new Map<\n    string,\n    { fn: PreloadFn; factory: PreloadFnFactory }\n  >();\n  // Pre-resolved State cache keyed by anchor href. Populated when a hover/touch\n  // resolves a route via router.matchUrl, consumed once via\n  // router.getPreloadedState(href). Single-use semantics (delete-on-read) keep\n  // the cache from drifting out of sync with current world state — once the\n  // consumer commits the snapshot via api.navigateToState, the entry is gone.\n  // Bounded with insertion-order eviction (#562).\n  readonly #stateCache = new Map<string, State>();\n\n  #currentAnchor: HTMLAnchorElement | null = null;\n  #hoverTimer: ReturnType<typeof setTimeout> | null = null;\n  #touchTimer: ReturnType<typeof setTimeout> | null = null;\n  #touchStartY = 0;\n  #lastTouchTarget: EventTarget | null = null;\n  #lastTouchTimeStamp = Number.NaN;\n\n  constructor(\n    router: Router,\n    api: PluginApi,\n    options: Required<PreloadPluginOptions>,\n    getDependency: Parameters<PluginFactory>[1],\n  ) {\n    this.#router = router;\n    this.#api = api;\n    this.#options = options;\n    this.#getDependency = getDependency;\n\n    const cachedOptions = { ...options };\n\n    this.#removeExtensions = api.extendRouter({\n      getPreloadSettings: () => cachedOptions,\n      getPreloadedState: (href: string): State | undefined => {\n        const state = this.#stateCache.get(href);\n\n        if (state) {\n          this.#stateCache.delete(href);\n        }\n\n        return state;\n      },\n    });\n\n    // Drop compiled-preload entries for routes removed from the tree. Without\n    // this, `#resolvePreload` can never reach them again (matchUrl returns\n    // undefined for a removed route), so the entry would be dead memory until\n    // teardown. `add`/`update` need no handling — `#resolvePreload` already\n    // revalidates lazily via the cached `factory` reference.\n    this.#removeChangesSubscription = getRoutesApi(router).subscribeChanges(\n      (event) => {\n        this.#onTreeChanged(event);\n      },\n    );\n  }\n\n  getPlugin(): Plugin {\n    return {\n      onStart: () => {\n        document.addEventListener(\n          \"mouseover\",\n          this.#handleMouseOver,\n          LISTENER_OPTIONS,\n        );\n        document.addEventListener(\n          \"touchstart\",\n          this.#handleTouchStart,\n          LISTENER_OPTIONS,\n        );\n        document.addEventListener(\n          \"touchmove\",\n          this.#handleTouchMove,\n          LISTENER_OPTIONS,\n        );\n      },\n\n      onStop: () => {\n        this.#cleanup();\n      },\n\n      teardown: () => {\n        this.#cleanup();\n        this.#removeChangesSubscription();\n        this.#removeExtensions();\n      },\n    };\n  }\n\n  #onTreeChanged(event: TreeChangedEvent): void {\n    switch (event.op) {\n      case \"remove\": {\n        for (const route of event.removedSubtree) {\n          this.#compiledPreloads.delete(route.name);\n        }\n\n        this.#invalidateStateCache();\n\n        break;\n      }\n      case \"replace\": {\n        for (const route of event.removed) {\n          this.#compiledPreloads.delete(route.name);\n        }\n\n        this.#invalidateStateCache();\n\n        break;\n      }\n      case \"clear\": {\n        this.#compiledPreloads.clear();\n        this.#invalidateStateCache();\n\n        break;\n      }\n      // \"add\" / \"update\": lazy factory-reference revalidation in\n      // #resolvePreload handles these — no eager cleanup needed.\n    }\n  }\n\n  /**\n   * Drops all pre-resolved `State` snapshots. `#stateCache` is keyed by `href`,\n   * not route name, so a removed/changed route cannot be pruned selectively —\n   * clearing the whole (≤32-entry) cache prevents `getPreloadedState(href)` from\n   * handing a consumer a `State` that points at a route no longer in the tree.\n   * Entries repopulate on the next hover/touch.\n   */\n  #invalidateStateCache(): void {\n    this.#stateCache.clear();\n  }\n\n  readonly #handleMouseOver = (event: MouseEvent): void => {\n    if (this.#isGhostMouseEvent(event)) {\n      return;\n    }\n\n    const anchor = this.#findAnchor(event.target);\n\n    if (anchor === this.#currentAnchor) {\n      return;\n    }\n\n    this.#cancelHover();\n    this.#currentAnchor = anchor;\n\n    const preload = this.#resolveAnchorPreload(anchor);\n\n    if (!preload) {\n      return;\n    }\n\n    this.#hoverTimer = setTimeout(() => {\n      this.#hoverTimer = null;\n      preload.fn(preload.params).catch(() => {});\n    }, this.#options.delay);\n  };\n\n  readonly #handleTouchStart = (event: TouchEvent): void => {\n    this.#lastTouchTarget = event.target;\n    this.#lastTouchTimeStamp = event.timeStamp;\n\n    this.#cancelTouch();\n\n    const anchor = this.#findAnchor(event.target);\n    const preload = this.#resolveAnchorPreload(anchor);\n\n    if (!preload || event.touches.length === 0) {\n      return;\n    }\n\n    this.#touchStartY = event.touches[0].clientY;\n\n    this.#touchTimer = setTimeout(() => {\n      this.#touchTimer = null;\n      preload.fn(preload.params).catch(() => {});\n    }, TOUCH_PRELOAD_DELAY);\n  };\n\n  readonly #handleTouchMove = (event: TouchEvent): void => {\n    if (this.#touchTimer === null || event.touches.length === 0) {\n      return;\n    }\n\n    const deltaY = Math.abs(event.touches[0].clientY - this.#touchStartY);\n\n    if (deltaY > TOUCH_SCROLL_THRESHOLD) {\n      this.#cancelTouch();\n    }\n  };\n\n  #findAnchor(target: EventTarget | null): HTMLAnchorElement | null {\n    return target instanceof Element\n      ? target.closest<HTMLAnchorElement>(\"a[href]\")\n      : null;\n  }\n\n  #resolveAnchorPreload(\n    anchor: HTMLAnchorElement | null | undefined,\n  ): { fn: PreloadFn; params: Params } | undefined {\n    if (!anchor) {\n      return undefined;\n    }\n\n    if (\"noPreload\" in anchor.dataset) {\n      return undefined;\n    }\n\n    if (this.#options.networkAware && isSlowConnection()) {\n      return undefined;\n    }\n\n    return this.#resolvePreload(anchor);\n  }\n\n  #resolvePreload(\n    anchor: HTMLAnchorElement,\n  ): { fn: PreloadFn; params: Params } | undefined {\n    const state = this.#router.matchUrl?.(anchor.href);\n\n    if (!state) {\n      return undefined;\n    }\n\n    this.#cacheState(anchor.href, state);\n\n    const config = this.#api.getRouteConfig(state.name);\n    const factory =\n      typeof config?.preload === \"function\"\n        ? (config.preload as PreloadFnFactory)\n        : undefined;\n\n    if (!factory) {\n      this.#compiledPreloads.delete(state.name);\n\n      return undefined;\n    }\n\n    const cached = this.#compiledPreloads.get(state.name);\n\n    if (cached?.factory === factory) {\n      return { fn: cached.fn, params: state.params };\n    }\n\n    let fn: PreloadFn;\n\n    try {\n      fn = factory(this.#router, this.#getDependency);\n    } catch {\n      return undefined;\n    }\n\n    this.#compiledPreloads.set(state.name, { fn, factory });\n\n    return { fn, params: state.params };\n  }\n\n  #cacheState(href: string, state: State): void {\n    // Re-insert to refresh recency ordering (Map iteration is insertion order).\n    if (this.#stateCache.has(href)) {\n      this.#stateCache.delete(href);\n    } else if (this.#stateCache.size >= STATE_CACHE_LIMIT) {\n      // size >= LIMIT > 0 → iterator has at least one key.\n      for (const oldest of this.#stateCache.keys()) {\n        this.#stateCache.delete(oldest);\n\n        break;\n      }\n    }\n\n    this.#stateCache.set(href, state);\n  }\n\n  #isGhostMouseEvent(event: MouseEvent): boolean {\n    const delta = event.timeStamp - this.#lastTouchTimeStamp;\n\n    return (\n      delta >= 0 &&\n      delta < GHOST_EVENT_THRESHOLD &&\n      event.target === this.#lastTouchTarget\n    );\n  }\n\n  #cancelHover(): void {\n    if (this.#hoverTimer !== null) {\n      clearTimeout(this.#hoverTimer);\n      this.#hoverTimer = null;\n    }\n\n    this.#currentAnchor = null;\n  }\n\n  #cancelTouch(): void {\n    if (this.#touchTimer !== null) {\n      clearTimeout(this.#touchTimer);\n      this.#touchTimer = null;\n    }\n  }\n\n  #cleanup(): void {\n    document.removeEventListener(\n      \"mouseover\",\n      this.#handleMouseOver,\n      LISTENER_OPTIONS,\n    );\n    document.removeEventListener(\n      \"touchstart\",\n      this.#handleTouchStart,\n      LISTENER_OPTIONS,\n    );\n    document.removeEventListener(\n      \"touchmove\",\n      this.#handleTouchMove,\n      LISTENER_OPTIONS,\n    );\n\n    this.#cancelHover();\n    this.#cancelTouch();\n    this.#lastTouchTarget = null;\n    this.#lastTouchTimeStamp = Number.NaN;\n    this.#stateCache.clear();\n  }\n}\n","import { getPluginApi } from \"@real-router/core/api\";\n\nimport { defaultOptions } from \"./constants\";\nimport { PreloadPlugin } from \"./plugin\";\n\nimport type { PreloadPluginOptions } from \"./types\";\nimport type { PluginFactory, Router } from \"@real-router/core\";\n\nexport function preloadPluginFactory(\n  opts?: Partial<PreloadPluginOptions>,\n): PluginFactory {\n  const options: Required<PreloadPluginOptions> = {\n    ...defaultOptions,\n    ...opts,\n  };\n\n  if (!Number.isFinite(options.delay) || options.delay < 0) {\n    options.delay = 0;\n  }\n\n  return function preloadPlugin(routerBase, getDependency) {\n    if (typeof document === \"undefined\") {\n      return {};\n    }\n\n    const plugin = new PreloadPlugin(\n      routerBase as Router,\n      getPluginApi(routerBase),\n      options,\n      getDependency,\n    );\n\n    return plugin.getPlugin();\n  };\n}\n"],"mappings":"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"}

package/dist/esm/index.mjs

@@ -1,2 +1,2 @@
-import{getPluginApi as e}from"@real-router/core/api";const t={delay:65,networkAware:!0},n={capture:!0,passive:!0};function r(){let e=navigator.connection;return e?!!(e.saveData||e.effectiveType?.includes(`2g`)):!1}var i=class{#e;#t;#n;#r;#i;#a=new Map;#o=new Map;#s=null;#c=null;#l=null;#u=0;#d=null;#f=NaN;constructor(e,t,n,r){this.#e=e,this.#t=t,this.#n=n,this.#r=r;let i={...n};this.#i=t.extendRouter({getPreloadSettings:()=>i,getPreloadedState:e=>{let t=this.#o.get(e);return t&&this.#o.delete(e),t}})}getPlugin(){return{onStart:()=>{document.addEventListener(`mouseover`,this.#p,n),document.addEventListener(`touchstart`,this.#m,n),document.addEventListener(`touchmove`,this.#h,n)},onStop:()=>{this.#C()},teardown:()=>{this.#C(),this.#i()}}}#p=e=>{if(this.#b(e))return;let t=this.#g(e.target);if(t===this.#s)return;this.#x(),this.#s=t;let n=this.#_(t);n&&(this.#c=setTimeout(()=>{this.#c=null,n.fn(n.params).catch(()=>{})},this.#n.delay))};#m=e=>{this.#d=e.target,this.#f=e.timeStamp,this.#S();let t=this.#g(e.target),n=this.#_(t);!n||e.touches.length===0||(this.#u=e.touches[0].clientY,this.#l=setTimeout(()=>{this.#l=null,n.fn(n.params).catch(()=>{})},100))};#h=e=>{this.#l===null||e.touches.length===0||Math.abs(e.touches[0].clientY-this.#u)>10&&this.#S()};#g(e){return e instanceof Element?e.closest(`a[href]`):null}#_(e){if(e&&!(`noPreload`in e.dataset)&&!(this.#n.networkAware&&r()))return this.#v(e)}#v(e){let t=this.#e.matchUrl?.(e.href);if(!t)return;this.#y(e.href,t);let n=this.#t.getRouteConfig(t.name),r=typeof n?.preload==`function`?n.preload:void 0;if(!r){this.#a.delete(t.name);return}let i=this.#a.get(t.name);if(i?.factory===r)return{fn:i.fn,params:t.params};let a;try{a=r(this.#e,this.#r)}catch{return}return this.#a.set(t.name,{fn:a,factory:r}),{fn:a,params:t.params}}#y(e,t){if(this.#o.has(e))this.#o.delete(e);else if(this.#o.size>=32)for(let e of this.#o.keys()){this.#o.delete(e);break}this.#o.set(e,t)}#b(e){let t=e.timeStamp-this.#f;return t>=0&&t<2500&&e.target===this.#d}#x(){this.#c!==null&&(clearTimeout(this.#c),this.#c=null),this.#s=null}#S(){this.#l!==null&&(clearTimeout(this.#l),this.#l=null)}#C(){document.removeEventListener(`mouseover`,this.#p,n),document.removeEventListener(`touchstart`,this.#m,n),document.removeEventListener(`touchmove`,this.#h,n),this.#x(),this.#S(),this.#d=null,this.#f=NaN,this.#o.clear()}};function a(n){let r={...t,...n};return(!Number.isFinite(r.delay)||r.delay<0)&&(r.delay=0),function(t,n){return typeof document>`u`?{}:new i(t,e(t),r,n).getPlugin()}}export{a as preloadPluginFactory};
+import{getPluginApi as e,getRoutesApi as t}from"@real-router/core/api";const n={delay:65,networkAware:!0},r={capture:!0,passive:!0};function i(){let e=navigator.connection;return e?!!(e.saveData||e.effectiveType?.includes(`2g`)):!1}var a=class{#e;#t;#n;#r;#i;#a;#o=new Map;#s=new Map;#c=null;#l=null;#u=null;#d=0;#f=null;#p=NaN;constructor(e,n,r,i){this.#e=e,this.#t=n,this.#n=r,this.#r=i;let a={...r};this.#i=n.extendRouter({getPreloadSettings:()=>a,getPreloadedState:e=>{let t=this.#s.get(e);return t&&this.#s.delete(e),t}}),this.#a=t(e).subscribeChanges(e=>{this.#m(e)})}getPlugin(){return{onStart:()=>{document.addEventListener(`mouseover`,this.#g,r),document.addEventListener(`touchstart`,this.#_,r),document.addEventListener(`touchmove`,this.#v,r)},onStop:()=>{this.#E()},teardown:()=>{this.#E(),this.#a(),this.#i()}}}#m(e){switch(e.op){case`remove`:for(let t of e.removedSubtree)this.#o.delete(t.name);this.#h();break;case`replace`:for(let t of e.removed)this.#o.delete(t.name);this.#h();break;case`clear`:this.#o.clear(),this.#h();break}}#h(){this.#s.clear()}#g=e=>{if(this.#C(e))return;let t=this.#y(e.target);if(t===this.#c)return;this.#w(),this.#c=t;let n=this.#b(t);n&&(this.#l=setTimeout(()=>{this.#l=null,n.fn(n.params).catch(()=>{})},this.#n.delay))};#_=e=>{this.#f=e.target,this.#p=e.timeStamp,this.#T();let t=this.#y(e.target),n=this.#b(t);!n||e.touches.length===0||(this.#d=e.touches[0].clientY,this.#u=setTimeout(()=>{this.#u=null,n.fn(n.params).catch(()=>{})},100))};#v=e=>{this.#u===null||e.touches.length===0||Math.abs(e.touches[0].clientY-this.#d)>10&&this.#T()};#y(e){return e instanceof Element?e.closest(`a[href]`):null}#b(e){if(e&&!(`noPreload`in e.dataset)&&!(this.#n.networkAware&&i()))return this.#x(e)}#x(e){let t=this.#e.matchUrl?.(e.href);if(!t)return;this.#S(e.href,t);let n=this.#t.getRouteConfig(t.name),r=typeof n?.preload==`function`?n.preload:void 0;if(!r){this.#o.delete(t.name);return}let i=this.#o.get(t.name);if(i?.factory===r)return{fn:i.fn,params:t.params};let a;try{a=r(this.#e,this.#r)}catch{return}return this.#o.set(t.name,{fn:a,factory:r}),{fn:a,params:t.params}}#S(e,t){if(this.#s.has(e))this.#s.delete(e);else if(this.#s.size>=32)for(let e of this.#s.keys()){this.#s.delete(e);break}this.#s.set(e,t)}#C(e){let t=e.timeStamp-this.#p;return t>=0&&t<2500&&e.target===this.#f}#w(){this.#l!==null&&(clearTimeout(this.#l),this.#l=null),this.#c=null}#T(){this.#u!==null&&(clearTimeout(this.#u),this.#u=null)}#E(){document.removeEventListener(`mouseover`,this.#g,r),document.removeEventListener(`touchstart`,this.#_,r),document.removeEventListener(`touchmove`,this.#v,r),this.#w(),this.#T(),this.#f=null,this.#p=NaN,this.#s.clear()}};function o(t){let r={...n,...t};return(!Number.isFinite(r.delay)||r.delay<0)&&(r.delay=0),function(t,n){return typeof document>`u`?{}:new a(t,e(t),r,n).getPlugin()}}export{o as preloadPluginFactory};
 //# sourceMappingURL=index.mjs.map

package/dist/esm/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":["#router","#api","#options","#getDependency","#removeExtensions","#compiledPreloads","#stateCache","#handleMouseOver","#handleTouchStart","#handleTouchMove","#cleanup","#isGhostMouseEvent","#findAnchor","#currentAnchor","#cancelHover","#resolveAnchorPreload","#hoverTimer","#lastTouchTarget","#lastTouchTimeStamp","#cancelTouch","#touchStartY","#touchTimer","#resolvePreload","#cacheState"],"sources":["../../src/constants.ts","../../src/network.ts","../../src/plugin.ts","../../src/factory.ts"],"sourcesContent":["import type { PreloadPluginOptions } from \"./types\";\n\nexport const defaultOptions: Required<PreloadPluginOptions> = {\n  delay: 65,\n  networkAware: true,\n};\n\nexport const GHOST_EVENT_THRESHOLD = 2500;\n\nexport const TOUCH_SCROLL_THRESHOLD = 10;\n\nexport const TOUCH_PRELOAD_DELAY = 100;\n\nexport const LISTENER_OPTIONS: AddEventListenerOptions = {\n  capture: true,\n  passive: true,\n};\n","type NetworkConnection =\n  | { saveData?: boolean; effectiveType?: string }\n  | undefined;\n\ninterface NavigatorWithConnection extends Navigator {\n  connection?: NetworkConnection;\n}\n\nexport function isSlowConnection(): boolean {\n  const connection = (navigator as NavigatorWithConnection).connection;\n\n  if (!connection) {\n    return false;\n  }\n  if (connection.saveData) {\n    return true;\n  }\n  if (connection.effectiveType?.includes(\"2g\")) {\n    return true;\n  }\n\n  return false;\n}\n","import {\n  GHOST_EVENT_THRESHOLD,\n  LISTENER_OPTIONS,\n  TOUCH_PRELOAD_DELAY,\n  TOUCH_SCROLL_THRESHOLD,\n} from \"./constants\";\nimport { isSlowConnection } from \"./network\";\n\nimport type {\n  PreloadFn,\n  PreloadFnFactory,\n  PreloadPluginOptions,\n} from \"./types\";\nimport type {\n  Params,\n  Plugin,\n  PluginFactory,\n  Router,\n  State,\n} from \"@real-router/core\";\nimport type { PluginApi } from \"@real-router/core/api\";\n\ndeclare module \"@real-router/core\" {\n  interface Router {\n    matchUrl?: (url: string) => State | undefined;\n  }\n}\n\nconst STATE_CACHE_LIMIT = 32;\n\nexport class PreloadPlugin {\n  readonly #router: Router;\n  readonly #api: PluginApi;\n  readonly #options: Required<PreloadPluginOptions>;\n  readonly #getDependency: Parameters<PluginFactory>[1];\n  readonly #removeExtensions: () => void;\n  readonly #compiledPreloads = new Map<\n    string,\n    { fn: PreloadFn; factory: PreloadFnFactory }\n  >();\n  // Pre-resolved State cache keyed by anchor href. Populated when a hover/touch\n  // resolves a route via router.matchUrl, consumed once via\n  // router.getPreloadedState(href). Single-use semantics (delete-on-read) keep\n  // the cache from drifting out of sync with current world state — once the\n  // consumer commits the snapshot via api.navigateToState, the entry is gone.\n  // Bounded with insertion-order eviction (#562).\n  readonly #stateCache = new Map<string, State>();\n\n  #currentAnchor: HTMLAnchorElement | null = null;\n  #hoverTimer: ReturnType<typeof setTimeout> | null = null;\n  #touchTimer: ReturnType<typeof setTimeout> | null = null;\n  #touchStartY = 0;\n  #lastTouchTarget: EventTarget | null = null;\n  #lastTouchTimeStamp = Number.NaN;\n\n  constructor(\n    router: Router,\n    api: PluginApi,\n    options: Required<PreloadPluginOptions>,\n    getDependency: Parameters<PluginFactory>[1],\n  ) {\n    this.#router = router;\n    this.#api = api;\n    this.#options = options;\n    this.#getDependency = getDependency;\n\n    const cachedOptions = { ...options };\n\n    this.#removeExtensions = api.extendRouter({\n      getPreloadSettings: () => cachedOptions,\n      getPreloadedState: (href: string): State | undefined => {\n        const state = this.#stateCache.get(href);\n\n        if (state) {\n          this.#stateCache.delete(href);\n        }\n\n        return state;\n      },\n    });\n  }\n\n  getPlugin(): Plugin {\n    return {\n      onStart: () => {\n        document.addEventListener(\n          \"mouseover\",\n          this.#handleMouseOver,\n          LISTENER_OPTIONS,\n        );\n        document.addEventListener(\n          \"touchstart\",\n          this.#handleTouchStart,\n          LISTENER_OPTIONS,\n        );\n        document.addEventListener(\n          \"touchmove\",\n          this.#handleTouchMove,\n          LISTENER_OPTIONS,\n        );\n      },\n\n      onStop: () => {\n        this.#cleanup();\n      },\n\n      teardown: () => {\n        this.#cleanup();\n        this.#removeExtensions();\n      },\n    };\n  }\n\n  readonly #handleMouseOver = (event: MouseEvent): void => {\n    if (this.#isGhostMouseEvent(event)) {\n      return;\n    }\n\n    const anchor = this.#findAnchor(event.target);\n\n    if (anchor === this.#currentAnchor) {\n      return;\n    }\n\n    this.#cancelHover();\n    this.#currentAnchor = anchor;\n\n    const preload = this.#resolveAnchorPreload(anchor);\n\n    if (!preload) {\n      return;\n    }\n\n    this.#hoverTimer = setTimeout(() => {\n      this.#hoverTimer = null;\n      preload.fn(preload.params).catch(() => {});\n    }, this.#options.delay);\n  };\n\n  readonly #handleTouchStart = (event: TouchEvent): void => {\n    this.#lastTouchTarget = event.target;\n    this.#lastTouchTimeStamp = event.timeStamp;\n\n    this.#cancelTouch();\n\n    const anchor = this.#findAnchor(event.target);\n    const preload = this.#resolveAnchorPreload(anchor);\n\n    if (!preload || event.touches.length === 0) {\n      return;\n    }\n\n    this.#touchStartY = event.touches[0].clientY;\n\n    this.#touchTimer = setTimeout(() => {\n      this.#touchTimer = null;\n      preload.fn(preload.params).catch(() => {});\n    }, TOUCH_PRELOAD_DELAY);\n  };\n\n  readonly #handleTouchMove = (event: TouchEvent): void => {\n    if (this.#touchTimer === null || event.touches.length === 0) {\n      return;\n    }\n\n    const deltaY = Math.abs(event.touches[0].clientY - this.#touchStartY);\n\n    if (deltaY > TOUCH_SCROLL_THRESHOLD) {\n      this.#cancelTouch();\n    }\n  };\n\n  #findAnchor(target: EventTarget | null): HTMLAnchorElement | null {\n    return target instanceof Element\n      ? target.closest<HTMLAnchorElement>(\"a[href]\")\n      : null;\n  }\n\n  #resolveAnchorPreload(\n    anchor: HTMLAnchorElement | null | undefined,\n  ): { fn: PreloadFn; params: Params } | undefined {\n    if (!anchor) {\n      return undefined;\n    }\n\n    if (\"noPreload\" in anchor.dataset) {\n      return undefined;\n    }\n\n    if (this.#options.networkAware && isSlowConnection()) {\n      return undefined;\n    }\n\n    return this.#resolvePreload(anchor);\n  }\n\n  #resolvePreload(\n    anchor: HTMLAnchorElement,\n  ): { fn: PreloadFn; params: Params } | undefined {\n    const state = this.#router.matchUrl?.(anchor.href);\n\n    if (!state) {\n      return undefined;\n    }\n\n    this.#cacheState(anchor.href, state);\n\n    const config = this.#api.getRouteConfig(state.name);\n    const factory =\n      typeof config?.preload === \"function\"\n        ? (config.preload as PreloadFnFactory)\n        : undefined;\n\n    if (!factory) {\n      this.#compiledPreloads.delete(state.name);\n\n      return undefined;\n    }\n\n    const cached = this.#compiledPreloads.get(state.name);\n\n    if (cached?.factory === factory) {\n      return { fn: cached.fn, params: state.params };\n    }\n\n    let fn: PreloadFn;\n\n    try {\n      fn = factory(this.#router, this.#getDependency);\n    } catch {\n      return undefined;\n    }\n\n    this.#compiledPreloads.set(state.name, { fn, factory });\n\n    return { fn, params: state.params };\n  }\n\n  #cacheState(href: string, state: State): void {\n    // Re-insert to refresh recency ordering (Map iteration is insertion order).\n    if (this.#stateCache.has(href)) {\n      this.#stateCache.delete(href);\n    } else if (this.#stateCache.size >= STATE_CACHE_LIMIT) {\n      // size >= LIMIT > 0 → iterator has at least one key.\n      for (const oldest of this.#stateCache.keys()) {\n        this.#stateCache.delete(oldest);\n\n        break;\n      }\n    }\n\n    this.#stateCache.set(href, state);\n  }\n\n  #isGhostMouseEvent(event: MouseEvent): boolean {\n    const delta = event.timeStamp - this.#lastTouchTimeStamp;\n\n    return (\n      delta >= 0 &&\n      delta < GHOST_EVENT_THRESHOLD &&\n      event.target === this.#lastTouchTarget\n    );\n  }\n\n  #cancelHover(): void {\n    if (this.#hoverTimer !== null) {\n      clearTimeout(this.#hoverTimer);\n      this.#hoverTimer = null;\n    }\n\n    this.#currentAnchor = null;\n  }\n\n  #cancelTouch(): void {\n    if (this.#touchTimer !== null) {\n      clearTimeout(this.#touchTimer);\n      this.#touchTimer = null;\n    }\n  }\n\n  #cleanup(): void {\n    document.removeEventListener(\n      \"mouseover\",\n      this.#handleMouseOver,\n      LISTENER_OPTIONS,\n    );\n    document.removeEventListener(\n      \"touchstart\",\n      this.#handleTouchStart,\n      LISTENER_OPTIONS,\n    );\n    document.removeEventListener(\n      \"touchmove\",\n      this.#handleTouchMove,\n      LISTENER_OPTIONS,\n    );\n\n    this.#cancelHover();\n    this.#cancelTouch();\n    this.#lastTouchTarget = null;\n    this.#lastTouchTimeStamp = Number.NaN;\n    this.#stateCache.clear();\n  }\n}\n","import { getPluginApi } from \"@real-router/core/api\";\n\nimport { defaultOptions } from \"./constants\";\nimport { PreloadPlugin } from \"./plugin\";\n\nimport type { PreloadPluginOptions } from \"./types\";\nimport type { PluginFactory, Router } from \"@real-router/core\";\n\nexport function preloadPluginFactory(\n  opts?: Partial<PreloadPluginOptions>,\n): PluginFactory {\n  const options: Required<PreloadPluginOptions> = {\n    ...defaultOptions,\n    ...opts,\n  };\n\n  if (!Number.isFinite(options.delay) || options.delay < 0) {\n    options.delay = 0;\n  }\n\n  return function preloadPlugin(routerBase, getDependency) {\n    if (typeof document === \"undefined\") {\n      return {};\n    }\n\n    const plugin = new PreloadPlugin(\n      routerBase as Router,\n      getPluginApi(routerBase),\n      options,\n      getDependency,\n    );\n\n    return plugin.getPlugin();\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.mjs","names":["#router","#api","#options","#getDependency","#removeExtensions","#removeChangesSubscription","#compiledPreloads","#stateCache","#onTreeChanged","#handleMouseOver","#handleTouchStart","#handleTouchMove","#cleanup","#invalidateStateCache","#isGhostMouseEvent","#findAnchor","#currentAnchor","#cancelHover","#resolveAnchorPreload","#hoverTimer","#lastTouchTarget","#lastTouchTimeStamp","#cancelTouch","#touchStartY","#touchTimer","#resolvePreload","#cacheState"],"sources":["../../src/constants.ts","../../src/network.ts","../../src/plugin.ts","../../src/factory.ts"],"sourcesContent":["import type { PreloadPluginOptions } from \"./types\";\n\nexport const defaultOptions: Required<PreloadPluginOptions> = {\n  delay: 65,\n  networkAware: true,\n};\n\nexport const GHOST_EVENT_THRESHOLD = 2500;\n\nexport const TOUCH_SCROLL_THRESHOLD = 10;\n\nexport const TOUCH_PRELOAD_DELAY = 100;\n\nexport const LISTENER_OPTIONS: AddEventListenerOptions = {\n  capture: true,\n  passive: true,\n};\n","type NetworkConnection =\n  | { saveData?: boolean; effectiveType?: string }\n  | undefined;\n\ninterface NavigatorWithConnection extends Navigator {\n  connection?: NetworkConnection;\n}\n\nexport function isSlowConnection(): boolean {\n  const connection = (navigator as NavigatorWithConnection).connection;\n\n  if (!connection) {\n    return false;\n  }\n  if (connection.saveData) {\n    return true;\n  }\n  if (connection.effectiveType?.includes(\"2g\")) {\n    return true;\n  }\n\n  return false;\n}\n","import { getRoutesApi } from \"@real-router/core/api\";\n\nimport {\n  GHOST_EVENT_THRESHOLD,\n  LISTENER_OPTIONS,\n  TOUCH_PRELOAD_DELAY,\n  TOUCH_SCROLL_THRESHOLD,\n} from \"./constants\";\nimport { isSlowConnection } from \"./network\";\n\nimport type {\n  PreloadFn,\n  PreloadFnFactory,\n  PreloadPluginOptions,\n} from \"./types\";\nimport type {\n  Params,\n  Plugin,\n  PluginFactory,\n  Router,\n  State,\n  TreeChangedEvent,\n} from \"@real-router/core\";\nimport type { PluginApi } from \"@real-router/core/api\";\n\ndeclare module \"@real-router/core\" {\n  interface Router {\n    matchUrl?: (url: string) => State | undefined;\n  }\n}\n\nconst STATE_CACHE_LIMIT = 32;\n\nexport class PreloadPlugin {\n  readonly #router: Router;\n  readonly #api: PluginApi;\n  readonly #options: Required<PreloadPluginOptions>;\n  readonly #getDependency: Parameters<PluginFactory>[1];\n  readonly #removeExtensions: () => void;\n  readonly #removeChangesSubscription: () => void;\n  readonly #compiledPreloads = new Map<\n    string,\n    { fn: PreloadFn; factory: PreloadFnFactory }\n  >();\n  // Pre-resolved State cache keyed by anchor href. Populated when a hover/touch\n  // resolves a route via router.matchUrl, consumed once via\n  // router.getPreloadedState(href). Single-use semantics (delete-on-read) keep\n  // the cache from drifting out of sync with current world state — once the\n  // consumer commits the snapshot via api.navigateToState, the entry is gone.\n  // Bounded with insertion-order eviction (#562).\n  readonly #stateCache = new Map<string, State>();\n\n  #currentAnchor: HTMLAnchorElement | null = null;\n  #hoverTimer: ReturnType<typeof setTimeout> | null = null;\n  #touchTimer: ReturnType<typeof setTimeout> | null = null;\n  #touchStartY = 0;\n  #lastTouchTarget: EventTarget | null = null;\n  #lastTouchTimeStamp = Number.NaN;\n\n  constructor(\n    router: Router,\n    api: PluginApi,\n    options: Required<PreloadPluginOptions>,\n    getDependency: Parameters<PluginFactory>[1],\n  ) {\n    this.#router = router;\n    this.#api = api;\n    this.#options = options;\n    this.#getDependency = getDependency;\n\n    const cachedOptions = { ...options };\n\n    this.#removeExtensions = api.extendRouter({\n      getPreloadSettings: () => cachedOptions,\n      getPreloadedState: (href: string): State | undefined => {\n        const state = this.#stateCache.get(href);\n\n        if (state) {\n          this.#stateCache.delete(href);\n        }\n\n        return state;\n      },\n    });\n\n    // Drop compiled-preload entries for routes removed from the tree. Without\n    // this, `#resolvePreload` can never reach them again (matchUrl returns\n    // undefined for a removed route), so the entry would be dead memory until\n    // teardown. `add`/`update` need no handling — `#resolvePreload` already\n    // revalidates lazily via the cached `factory` reference.\n    this.#removeChangesSubscription = getRoutesApi(router).subscribeChanges(\n      (event) => {\n        this.#onTreeChanged(event);\n      },\n    );\n  }\n\n  getPlugin(): Plugin {\n    return {\n      onStart: () => {\n        document.addEventListener(\n          \"mouseover\",\n          this.#handleMouseOver,\n          LISTENER_OPTIONS,\n        );\n        document.addEventListener(\n          \"touchstart\",\n          this.#handleTouchStart,\n          LISTENER_OPTIONS,\n        );\n        document.addEventListener(\n          \"touchmove\",\n          this.#handleTouchMove,\n          LISTENER_OPTIONS,\n        );\n      },\n\n      onStop: () => {\n        this.#cleanup();\n      },\n\n      teardown: () => {\n        this.#cleanup();\n        this.#removeChangesSubscription();\n        this.#removeExtensions();\n      },\n    };\n  }\n\n  #onTreeChanged(event: TreeChangedEvent): void {\n    switch (event.op) {\n      case \"remove\": {\n        for (const route of event.removedSubtree) {\n          this.#compiledPreloads.delete(route.name);\n        }\n\n        this.#invalidateStateCache();\n\n        break;\n      }\n      case \"replace\": {\n        for (const route of event.removed) {\n          this.#compiledPreloads.delete(route.name);\n        }\n\n        this.#invalidateStateCache();\n\n        break;\n      }\n      case \"clear\": {\n        this.#compiledPreloads.clear();\n        this.#invalidateStateCache();\n\n        break;\n      }\n      // \"add\" / \"update\": lazy factory-reference revalidation in\n      // #resolvePreload handles these — no eager cleanup needed.\n    }\n  }\n\n  /**\n   * Drops all pre-resolved `State` snapshots. `#stateCache` is keyed by `href`,\n   * not route name, so a removed/changed route cannot be pruned selectively —\n   * clearing the whole (≤32-entry) cache prevents `getPreloadedState(href)` from\n   * handing a consumer a `State` that points at a route no longer in the tree.\n   * Entries repopulate on the next hover/touch.\n   */\n  #invalidateStateCache(): void {\n    this.#stateCache.clear();\n  }\n\n  readonly #handleMouseOver = (event: MouseEvent): void => {\n    if (this.#isGhostMouseEvent(event)) {\n      return;\n    }\n\n    const anchor = this.#findAnchor(event.target);\n\n    if (anchor === this.#currentAnchor) {\n      return;\n    }\n\n    this.#cancelHover();\n    this.#currentAnchor = anchor;\n\n    const preload = this.#resolveAnchorPreload(anchor);\n\n    if (!preload) {\n      return;\n    }\n\n    this.#hoverTimer = setTimeout(() => {\n      this.#hoverTimer = null;\n      preload.fn(preload.params).catch(() => {});\n    }, this.#options.delay);\n  };\n\n  readonly #handleTouchStart = (event: TouchEvent): void => {\n    this.#lastTouchTarget = event.target;\n    this.#lastTouchTimeStamp = event.timeStamp;\n\n    this.#cancelTouch();\n\n    const anchor = this.#findAnchor(event.target);\n    const preload = this.#resolveAnchorPreload(anchor);\n\n    if (!preload || event.touches.length === 0) {\n      return;\n    }\n\n    this.#touchStartY = event.touches[0].clientY;\n\n    this.#touchTimer = setTimeout(() => {\n      this.#touchTimer = null;\n      preload.fn(preload.params).catch(() => {});\n    }, TOUCH_PRELOAD_DELAY);\n  };\n\n  readonly #handleTouchMove = (event: TouchEvent): void => {\n    if (this.#touchTimer === null || event.touches.length === 0) {\n      return;\n    }\n\n    const deltaY = Math.abs(event.touches[0].clientY - this.#touchStartY);\n\n    if (deltaY > TOUCH_SCROLL_THRESHOLD) {\n      this.#cancelTouch();\n    }\n  };\n\n  #findAnchor(target: EventTarget | null): HTMLAnchorElement | null {\n    return target instanceof Element\n      ? target.closest<HTMLAnchorElement>(\"a[href]\")\n      : null;\n  }\n\n  #resolveAnchorPreload(\n    anchor: HTMLAnchorElement | null | undefined,\n  ): { fn: PreloadFn; params: Params } | undefined {\n    if (!anchor) {\n      return undefined;\n    }\n\n    if (\"noPreload\" in anchor.dataset) {\n      return undefined;\n    }\n\n    if (this.#options.networkAware && isSlowConnection()) {\n      return undefined;\n    }\n\n    return this.#resolvePreload(anchor);\n  }\n\n  #resolvePreload(\n    anchor: HTMLAnchorElement,\n  ): { fn: PreloadFn; params: Params } | undefined {\n    const state = this.#router.matchUrl?.(anchor.href);\n\n    if (!state) {\n      return undefined;\n    }\n\n    this.#cacheState(anchor.href, state);\n\n    const config = this.#api.getRouteConfig(state.name);\n    const factory =\n      typeof config?.preload === \"function\"\n        ? (config.preload as PreloadFnFactory)\n        : undefined;\n\n    if (!factory) {\n      this.#compiledPreloads.delete(state.name);\n\n      return undefined;\n    }\n\n    const cached = this.#compiledPreloads.get(state.name);\n\n    if (cached?.factory === factory) {\n      return { fn: cached.fn, params: state.params };\n    }\n\n    let fn: PreloadFn;\n\n    try {\n      fn = factory(this.#router, this.#getDependency);\n    } catch {\n      return undefined;\n    }\n\n    this.#compiledPreloads.set(state.name, { fn, factory });\n\n    return { fn, params: state.params };\n  }\n\n  #cacheState(href: string, state: State): void {\n    // Re-insert to refresh recency ordering (Map iteration is insertion order).\n    if (this.#stateCache.has(href)) {\n      this.#stateCache.delete(href);\n    } else if (this.#stateCache.size >= STATE_CACHE_LIMIT) {\n      // size >= LIMIT > 0 → iterator has at least one key.\n      for (const oldest of this.#stateCache.keys()) {\n        this.#stateCache.delete(oldest);\n\n        break;\n      }\n    }\n\n    this.#stateCache.set(href, state);\n  }\n\n  #isGhostMouseEvent(event: MouseEvent): boolean {\n    const delta = event.timeStamp - this.#lastTouchTimeStamp;\n\n    return (\n      delta >= 0 &&\n      delta < GHOST_EVENT_THRESHOLD &&\n      event.target === this.#lastTouchTarget\n    );\n  }\n\n  #cancelHover(): void {\n    if (this.#hoverTimer !== null) {\n      clearTimeout(this.#hoverTimer);\n      this.#hoverTimer = null;\n    }\n\n    this.#currentAnchor = null;\n  }\n\n  #cancelTouch(): void {\n    if (this.#touchTimer !== null) {\n      clearTimeout(this.#touchTimer);\n      this.#touchTimer = null;\n    }\n  }\n\n  #cleanup(): void {\n    document.removeEventListener(\n      \"mouseover\",\n      this.#handleMouseOver,\n      LISTENER_OPTIONS,\n    );\n    document.removeEventListener(\n      \"touchstart\",\n      this.#handleTouchStart,\n      LISTENER_OPTIONS,\n    );\n    document.removeEventListener(\n      \"touchmove\",\n      this.#handleTouchMove,\n      LISTENER_OPTIONS,\n    );\n\n    this.#cancelHover();\n    this.#cancelTouch();\n    this.#lastTouchTarget = null;\n    this.#lastTouchTimeStamp = Number.NaN;\n    this.#stateCache.clear();\n  }\n}\n","import { getPluginApi } from \"@real-router/core/api\";\n\nimport { defaultOptions } from \"./constants\";\nimport { PreloadPlugin } from \"./plugin\";\n\nimport type { PreloadPluginOptions } from \"./types\";\nimport type { PluginFactory, Router } from \"@real-router/core\";\n\nexport function preloadPluginFactory(\n  opts?: Partial<PreloadPluginOptions>,\n): PluginFactory {\n  const options: Required<PreloadPluginOptions> = {\n    ...defaultOptions,\n    ...opts,\n  };\n\n  if (!Number.isFinite(options.delay) || options.delay < 0) {\n    options.delay = 0;\n  }\n\n  return function preloadPlugin(routerBase, getDependency) {\n    if (typeof document === \"undefined\") {\n      return {};\n    }\n\n    const plugin = new PreloadPlugin(\n      routerBase as Router,\n      getPluginApi(routerBase),\n      options,\n      getDependency,\n    );\n\n    return plugin.getPlugin();\n  };\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@real-router/preload-plugin",
-  "version": "0.4.3",
+  "version": "0.5.0",
   "type": "commonjs",
   "description": "Preload plugin — trigger data preloading on navigation intent (hover, touch)",
   "main": "./dist/cjs/index.js",
@@ -18,8 +18,7 @@
     }
   },
   "files": [
-    "dist",
-    "src"
+    "dist"
   ],
   "repository": {
     "type": "git",
@@ -45,11 +44,11 @@
   },
   "sideEffects": false,
   "dependencies": {
-    "@real-router/core": "^0.54.1",
-    "@real-router/types": "^0.35.0"
+    "@real-router/core": "^0.56.0",
+    "@real-router/types": "^0.36.0"
   },
   "devDependencies": {
-    "jsdom": "28.1.0"
+    "jsdom": "29.1.1"
   },
   "scripts": {
     "test": "vitest",

package/src/constants.ts

@@ -1,17 +0,0 @@
-import type { PreloadPluginOptions } from "./types";
-
-export const defaultOptions: Required<PreloadPluginOptions> = {
-  delay: 65,
-  networkAware: true,
-};
-
-export const GHOST_EVENT_THRESHOLD = 2500;
-
-export const TOUCH_SCROLL_THRESHOLD = 10;
-
-export const TOUCH_PRELOAD_DELAY = 100;
-
-export const LISTENER_OPTIONS: AddEventListenerOptions = {
-  capture: true,
-  passive: true,
-};

package/src/factory.ts

@@ -1,35 +0,0 @@
-import { getPluginApi } from "@real-router/core/api";
-
-import { defaultOptions } from "./constants";
-import { PreloadPlugin } from "./plugin";
-
-import type { PreloadPluginOptions } from "./types";
-import type { PluginFactory, Router } from "@real-router/core";
-
-export function preloadPluginFactory(
-  opts?: Partial<PreloadPluginOptions>,
-): PluginFactory {
-  const options: Required<PreloadPluginOptions> = {
-    ...defaultOptions,
-    ...opts,
-  };
-
-  if (!Number.isFinite(options.delay) || options.delay < 0) {
-    options.delay = 0;
-  }
-
-  return function preloadPlugin(routerBase, getDependency) {
-    if (typeof document === "undefined") {
-      return {};
-    }
-
-    const plugin = new PreloadPlugin(
-      routerBase as Router,
-      getPluginApi(routerBase),
-      options,
-      getDependency,
-    );
-
-    return plugin.getPlugin();
-  };
-}

package/src/index.ts

@@ -1,22 +0,0 @@
-/* eslint-disable @typescript-eslint/method-signature-style -- method syntax required for declaration merging overload (property syntax causes TS2717) */
-import type { PreloadFnFactory, PreloadPluginOptions } from "./types";
-import type { DefaultDependencies, State } from "@real-router/core";
-
-export { preloadPluginFactory } from "./factory";
-
-export type {
-  PreloadPluginOptions,
-  PreloadFn,
-  PreloadFnFactory,
-} from "./types";
-
-declare module "@real-router/core" {
-  interface Route<Dependencies extends DefaultDependencies> {
-    preload?: PreloadFnFactory<Dependencies>;
-  }
-
-  interface Router {
-    getPreloadedState?: (href: string) => State | undefined;
-    getPreloadSettings(): PreloadPluginOptions;
-  }
-}

package/src/network.ts

@@ -1,23 +0,0 @@
-type NetworkConnection =
-  | { saveData?: boolean; effectiveType?: string }
-  | undefined;
-
-interface NavigatorWithConnection extends Navigator {
-  connection?: NetworkConnection;
-}
-
-export function isSlowConnection(): boolean {
-  const connection = (navigator as NavigatorWithConnection).connection;
-
-  if (!connection) {
-    return false;
-  }
-  if (connection.saveData) {
-    return true;
-  }
-  if (connection.effectiveType?.includes("2g")) {
-    return true;
-  }
-
-  return false;
-}

package/src/plugin.ts

@@ -1,304 +0,0 @@
-import {
-  GHOST_EVENT_THRESHOLD,
-  LISTENER_OPTIONS,
-  TOUCH_PRELOAD_DELAY,
-  TOUCH_SCROLL_THRESHOLD,
-} from "./constants";
-import { isSlowConnection } from "./network";
-
-import type {
-  PreloadFn,
-  PreloadFnFactory,
-  PreloadPluginOptions,
-} from "./types";
-import type {
-  Params,
-  Plugin,
-  PluginFactory,
-  Router,
-  State,
-} from "@real-router/core";
-import type { PluginApi } from "@real-router/core/api";
-
-declare module "@real-router/core" {
-  interface Router {
-    matchUrl?: (url: string) => State | undefined;
-  }
-}
-
-const STATE_CACHE_LIMIT = 32;
-
-export class PreloadPlugin {
-  readonly #router: Router;
-  readonly #api: PluginApi;
-  readonly #options: Required<PreloadPluginOptions>;
-  readonly #getDependency: Parameters<PluginFactory>[1];
-  readonly #removeExtensions: () => void;
-  readonly #compiledPreloads = new Map<
-    string,
-    { fn: PreloadFn; factory: PreloadFnFactory }
-  >();
-  // Pre-resolved State cache keyed by anchor href. Populated when a hover/touch
-  // resolves a route via router.matchUrl, consumed once via
-  // router.getPreloadedState(href). Single-use semantics (delete-on-read) keep
-  // the cache from drifting out of sync with current world state — once the
-  // consumer commits the snapshot via api.navigateToState, the entry is gone.
-  // Bounded with insertion-order eviction (#562).
-  readonly #stateCache = new Map<string, State>();
-
-  #currentAnchor: HTMLAnchorElement | null = null;
-  #hoverTimer: ReturnType<typeof setTimeout> | null = null;
-  #touchTimer: ReturnType<typeof setTimeout> | null = null;
-  #touchStartY = 0;
-  #lastTouchTarget: EventTarget | null = null;
-  #lastTouchTimeStamp = Number.NaN;
-
-  constructor(
-    router: Router,
-    api: PluginApi,
-    options: Required<PreloadPluginOptions>,
-    getDependency: Parameters<PluginFactory>[1],
-  ) {
-    this.#router = router;
-    this.#api = api;
-    this.#options = options;
-    this.#getDependency = getDependency;
-
-    const cachedOptions = { ...options };
-
-    this.#removeExtensions = api.extendRouter({
-      getPreloadSettings: () => cachedOptions,
-      getPreloadedState: (href: string): State | undefined => {
-        const state = this.#stateCache.get(href);
-
-        if (state) {
-          this.#stateCache.delete(href);
-        }
-
-        return state;
-      },
-    });
-  }
-
-  getPlugin(): Plugin {
-    return {
-      onStart: () => {
-        document.addEventListener(
-          "mouseover",
-          this.#handleMouseOver,
-          LISTENER_OPTIONS,
-        );
-        document.addEventListener(
-          "touchstart",
-          this.#handleTouchStart,
-          LISTENER_OPTIONS,
-        );
-        document.addEventListener(
-          "touchmove",
-          this.#handleTouchMove,
-          LISTENER_OPTIONS,
-        );
-      },
-
-      onStop: () => {
-        this.#cleanup();
-      },
-
-      teardown: () => {
-        this.#cleanup();
-        this.#removeExtensions();
-      },
-    };
-  }
-
-  readonly #handleMouseOver = (event: MouseEvent): void => {
-    if (this.#isGhostMouseEvent(event)) {
-      return;
-    }
-
-    const anchor = this.#findAnchor(event.target);
-
-    if (anchor === this.#currentAnchor) {
-      return;
-    }
-
-    this.#cancelHover();
-    this.#currentAnchor = anchor;
-
-    const preload = this.#resolveAnchorPreload(anchor);
-
-    if (!preload) {
-      return;
-    }
-
-    this.#hoverTimer = setTimeout(() => {
-      this.#hoverTimer = null;
-      preload.fn(preload.params).catch(() => {});
-    }, this.#options.delay);
-  };
-
-  readonly #handleTouchStart = (event: TouchEvent): void => {
-    this.#lastTouchTarget = event.target;
-    this.#lastTouchTimeStamp = event.timeStamp;
-
-    this.#cancelTouch();
-
-    const anchor = this.#findAnchor(event.target);
-    const preload = this.#resolveAnchorPreload(anchor);
-
-    if (!preload || event.touches.length === 0) {
-      return;
-    }
-
-    this.#touchStartY = event.touches[0].clientY;
-
-    this.#touchTimer = setTimeout(() => {
-      this.#touchTimer = null;
-      preload.fn(preload.params).catch(() => {});
-    }, TOUCH_PRELOAD_DELAY);
-  };
-
-  readonly #handleTouchMove = (event: TouchEvent): void => {
-    if (this.#touchTimer === null || event.touches.length === 0) {
-      return;
-    }
-
-    const deltaY = Math.abs(event.touches[0].clientY - this.#touchStartY);
-
-    if (deltaY > TOUCH_SCROLL_THRESHOLD) {
-      this.#cancelTouch();
-    }
-  };
-
-  #findAnchor(target: EventTarget | null): HTMLAnchorElement | null {
-    return target instanceof Element
-      ? target.closest<HTMLAnchorElement>("a[href]")
-      : null;
-  }
-
-  #resolveAnchorPreload(
-    anchor: HTMLAnchorElement | null | undefined,
-  ): { fn: PreloadFn; params: Params } | undefined {
-    if (!anchor) {
-      return undefined;
-    }
-
-    if ("noPreload" in anchor.dataset) {
-      return undefined;
-    }
-
-    if (this.#options.networkAware && isSlowConnection()) {
-      return undefined;
-    }
-
-    return this.#resolvePreload(anchor);
-  }
-
-  #resolvePreload(
-    anchor: HTMLAnchorElement,
-  ): { fn: PreloadFn; params: Params } | undefined {
-    const state = this.#router.matchUrl?.(anchor.href);
-
-    if (!state) {
-      return undefined;
-    }
-
-    this.#cacheState(anchor.href, state);
-
-    const config = this.#api.getRouteConfig(state.name);
-    const factory =
-      typeof config?.preload === "function"
-        ? (config.preload as PreloadFnFactory)
-        : undefined;
-
-    if (!factory) {
-      this.#compiledPreloads.delete(state.name);
-
-      return undefined;
-    }
-
-    const cached = this.#compiledPreloads.get(state.name);
-
-    if (cached?.factory === factory) {
-      return { fn: cached.fn, params: state.params };
-    }
-
-    let fn: PreloadFn;
-
-    try {
-      fn = factory(this.#router, this.#getDependency);
-    } catch {
-      return undefined;
-    }
-
-    this.#compiledPreloads.set(state.name, { fn, factory });
-
-    return { fn, params: state.params };
-  }
-
-  #cacheState(href: string, state: State): void {
-    // Re-insert to refresh recency ordering (Map iteration is insertion order).
-    if (this.#stateCache.has(href)) {
-      this.#stateCache.delete(href);
-    } else if (this.#stateCache.size >= STATE_CACHE_LIMIT) {
-      // size >= LIMIT > 0 → iterator has at least one key.
-      for (const oldest of this.#stateCache.keys()) {
-        this.#stateCache.delete(oldest);
-
-        break;
-      }
-    }
-
-    this.#stateCache.set(href, state);
-  }
-
-  #isGhostMouseEvent(event: MouseEvent): boolean {
-    const delta = event.timeStamp - this.#lastTouchTimeStamp;
-
-    return (
-      delta >= 0 &&
-      delta < GHOST_EVENT_THRESHOLD &&
-      event.target === this.#lastTouchTarget
-    );
-  }
-
-  #cancelHover(): void {
-    if (this.#hoverTimer !== null) {
-      clearTimeout(this.#hoverTimer);
-      this.#hoverTimer = null;
-    }
-
-    this.#currentAnchor = null;
-  }
-
-  #cancelTouch(): void {
-    if (this.#touchTimer !== null) {
-      clearTimeout(this.#touchTimer);
-      this.#touchTimer = null;
-    }
-  }
-
-  #cleanup(): void {
-    document.removeEventListener(
-      "mouseover",
-      this.#handleMouseOver,
-      LISTENER_OPTIONS,
-    );
-    document.removeEventListener(
-      "touchstart",
-      this.#handleTouchStart,
-      LISTENER_OPTIONS,
-    );
-    document.removeEventListener(
-      "touchmove",
-      this.#handleTouchMove,
-      LISTENER_OPTIONS,
-    );
-
-    this.#cancelHover();
-    this.#cancelTouch();
-    this.#lastTouchTarget = null;
-    this.#lastTouchTimeStamp = Number.NaN;
-    this.#stateCache.clear();
-  }
-}

package/src/types.ts

@@ -1,26 +0,0 @@
-import type { DefaultDependencies, Params, Router } from "@real-router/types";
-
-export interface PreloadPluginOptions {
-  /** Hover debounce delay in ms. @default 65 */
-  delay?: number;
-  /** Check saveData/2g and disable preloading on slow connections. @default true */
-  networkAware?: boolean;
-}
-
-/**
- * Preload function called when navigation intent is detected (hover, touch).
- * Fire-and-forget: return values and errors are discarded.
- */
-export type PreloadFn = (params: Params) => Promise<unknown>;
-
-/**
- * Factory function for creating preload hooks.
- * Receives the router instance and a dependency getter (same pattern as GuardFnFactory).
- * Factory runs once at first invocation; the returned function is cached per route.
- */
-export type PreloadFnFactory<
-  Dependencies extends DefaultDependencies = DefaultDependencies,
-> = (
-  router: Router<Dependencies>,
-  getDependency: <K extends keyof Dependencies>(key: K) => Dependencies[K],
-) => PreloadFn;