@pyreon/router 0.12.12 → 0.12.14

package/lib/types/index.d.ts

@@ -242,6 +242,19 @@ interface Router<TNames extends string = string> {
    * Useful for SSR and for delaying rendering until the first route is resolved.
    */
   isReady(): Promise<void>;
+  /**
+   * Resolve `path` and prepare everything needed to render it: load any lazy
+   * route components into the router's cache and run the matched routes'
+   * loaders. After this resolves, a `RouterView` rendered against this router
+   * for `path` will produce final HTML synchronously — no loading fallbacks,
+   * no `useLoaderData()` returning `undefined`.
+   *
+   * Used by SSR/SSG to hydrate the route tree before `renderToString`.
+   * The router's `currentRoute` is NOT changed by `preload` — pass the path
+   * separately when creating the router (`createRouter({ url, ... })`) or
+   * call this for the same `url` you initialised the router with.
+   */
+  preload(path: string): Promise<void>;
   /** Remove all event listeners, clear caches, and abort in-flight navigations. */
   destroy(): void;
 }

package/lib/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index2.d.ts","names":[],"sources":["../../../src/types.ts","../../../src/components.tsx","../../../src/loader.ts","../../../src/match.ts","../../../src/router.ts"],"mappings":"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"}
+{"version":3,"file":"index2.d.ts","names":[],"sources":["../../../src/types.ts","../../../src/components.tsx","../../../src/loader.ts","../../../src/match.ts","../../../src/router.ts"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pyreon/router",
-  "version": "0.12.12",
+  "version": "0.12.14",
   "description": "Official router for Pyreon",
   "homepage": "https://github.com/pyreon/pyreon/tree/main/packages/router#readme",
   "bugs": {
@@ -37,17 +37,20 @@
     "build": "vl_rolldown_build",
     "dev": "vl_rolldown_build-watch",
     "test": "vitest run",
+    "test:browser": "vitest run --config ./vitest.browser.config.ts",
     "typecheck": "tsc --noEmit",
     "lint": "oxlint .",
     "prepublishOnly": "bun run build"
   },
   "dependencies": {
-    "@pyreon/core": "^0.12.12",
-    "@pyreon/reactivity": "^0.12.12",
-    "@pyreon/runtime-dom": "^0.12.12"
+    "@pyreon/core": "^0.12.14",
+    "@pyreon/reactivity": "^0.12.14",
+    "@pyreon/runtime-dom": "^0.12.14"
   },
   "devDependencies": {
     "@happy-dom/global-registrator": "^20.8.9",
+    "@pyreon/test-utils": "^0.12.10",
+    "@vitest/browser-playwright": "^4.1.4",
     "happy-dom": "^20.8.3"
   }
 }

package/src/router.ts

@@ -56,7 +56,7 @@ export function useRouter(): Router {
   const router = useContext(RouterContext) ?? _activeRouter
   if (!router)
     throw new Error(
-      '[pyreon-router] No router installed. Wrap your app in <RouterProvider router={router}>.',
+      '[Pyreon] No router installed. Wrap your app in <RouterProvider router={router}>.',
     )
   return router
 }
@@ -68,7 +68,7 @@ export function useRoute<TPath extends string = string>(): () => ResolvedRoute<
   const router = useContext(RouterContext) ?? _activeRouter
   if (!router)
     throw new Error(
-      '[pyreon-router] No router installed. Wrap your app in <RouterProvider router={router}>.',
+      '[Pyreon] No router installed. Wrap your app in <RouterProvider router={router}>.',
     )
   return router.currentRoute as never
 }
@@ -87,7 +87,7 @@ export function onBeforeRouteLeave(guard: NavigationGuard): () => void {
   const router = (useContext(RouterContext) ?? _activeRouter) as RouterInstance | null
   if (!router)
     throw new Error(
-      '[pyreon-router] No router installed. Wrap your app in <RouterProvider router={router}>.',
+      '[Pyreon] No router installed. Wrap your app in <RouterProvider router={router}>.',
     )
   // Register as a global guard that only fires when leaving the current route
   const currentMatched = router.currentRoute().matched
@@ -116,7 +116,7 @@ export function onBeforeRouteUpdate(guard: NavigationGuard): () => void {
   const router = (useContext(RouterContext) ?? _activeRouter) as RouterInstance | null
   if (!router)
     throw new Error(
-      '[pyreon-router] No router installed. Wrap your app in <RouterProvider router={router}>.',
+      '[Pyreon] No router installed. Wrap your app in <RouterProvider router={router}>.',
     )
   const currentMatched = router.currentRoute().matched
   const wrappedGuard: NavigationGuard = (to, from) => {
@@ -148,7 +148,7 @@ export function useBlocker(fn: BlockerFn): Blocker {
   const router = (useContext(RouterContext) ?? _activeRouter) as RouterInstance | null
   if (!router)
     throw new Error(
-      '[pyreon-router] No router installed. Wrap your app in <RouterProvider router={router}>.',
+      '[Pyreon] No router installed. Wrap your app in <RouterProvider router={router}>.',
     )
   router._blockers.add(fn)
 
@@ -207,7 +207,7 @@ export function useIsActive(path: string, exact = false): () => boolean {
   const router = (useContext(RouterContext) ?? _activeRouter) as RouterInstance | null
   if (!router)
     throw new Error(
-      '[pyreon-router] No router installed. Wrap your app in <RouterProvider router={router}>.',
+      '[Pyreon] No router installed. Wrap your app in <RouterProvider router={router}>.',
     )
   return () => {
     const current = router.currentRoute().path
@@ -331,7 +331,7 @@ function _getRouter(): RouterInstance {
   const router = (useContext(RouterContext) ?? _activeRouter) as RouterInstance | null
   if (!router)
     throw new Error(
-      '[pyreon-router] No router installed. Wrap your app in <RouterProvider router={router}>.',
+      '[Pyreon] No router installed. Wrap your app in <RouterProvider router={router}>.',
     )
   return router
 }
@@ -428,19 +428,17 @@ export function createRouter(options: RouterOptions | RouteRecord[]): Router {
   const currentPath = signal(normalizeTrailingSlash(getInitialLocation(), trailingSlash))
   const currentRoute = computed<ResolvedRoute>(() => resolveRoute(currentPath(), routes))
 
-  // Browser event listeners — stored so destroy() can remove them
-  let _popstateHandler: (() => void) | null = null
-  let _hashchangeHandler: (() => void) | null = null
+  // Browser event listeners — stored so destroy() can remove them.
+  // Ternary-bound on `_isBrowser` (a typeof-derived const) so the lint rule
+  // can trace these to an SSR-safe shape without needing `if (_isBrowser &&
+  // handler)` contortions at every use site.
+  const _popstateHandler: (() => void) | null =
+    _isBrowser && mode === 'history' ? () => currentPath.set(getCurrentLocation()) : null
+  const _hashchangeHandler: (() => void) | null =
+    _isBrowser && mode !== 'history' ? () => currentPath.set(getCurrentLocation()) : null
 
-  if (_isBrowser) {
-    if (mode === 'history') {
-      _popstateHandler = () => currentPath.set(getCurrentLocation())
-      window.addEventListener('popstate', _popstateHandler)
-    } else {
-      _hashchangeHandler = () => currentPath.set(getCurrentLocation())
-      window.addEventListener('hashchange', _hashchangeHandler)
-    }
-  }
+  if (_popstateHandler) window.addEventListener('popstate', _popstateHandler)
+  if (_hashchangeHandler) window.addEventListener('hashchange', _hashchangeHandler)
 
   const componentCache = new Map<RouteRecord, ComponentFn>()
   const loadingSignal = signal(0)
@@ -608,12 +606,12 @@ export function createRouter(options: RouterOptions | RouteRecord[]): Router {
     return true
   }
 
-  function commitNavigation(
+  async function commitNavigation(
     path: string,
     replace: boolean,
     to: ResolvedRoute,
     from: ResolvedRoute,
-  ): void {
+  ): Promise<void> {
     scrollManager.save(from.path)
 
     const doCommit = () => {
@@ -638,9 +636,54 @@ export function createRouter(options: RouterOptions | RouteRecord[]): Router {
       && typeof (document as any).startViewTransition === 'function'
 
     if (useVT) {
-      (document as any).startViewTransition(() => {
-        doCommit()
-      })
+      // `startViewTransition(cb)` runs `cb` inside an async transition. Its
+      // `.updateCallbackDone` promise resolves as soon as the callback
+      // finishes — DOM has swapped, state is live, but the fade/slide
+      // animation is still running. That's what `await router.push()`
+      // should wait for: callers need the new route live before they act
+      // (e.g. focus an element, inspect `location`, query a new DOM node);
+      // they don't want to block on the full animation (`.finished`),
+      // which would add 200-300ms to every programmatic navigation.
+      //
+      // Before this await, `commitNavigation` was sync: the transition
+      // callback ran in a later microtask, so `await router.push()`
+      // resolved BEFORE the DOM swap. Browser smoke tests had to opt out
+      // of View Transitions per-route via `meta: { viewTransition: false }`
+      // to stay deterministic — a flag whose only purpose was to paper
+      // over this bug.
+      type ViewTransitionLike = {
+        updateCallbackDone?: Promise<void>
+        ready?: Promise<void>
+        finished?: Promise<void>
+      }
+      const vt = (document as { startViewTransition?: (cb: () => void) => ViewTransitionLike | undefined })
+        .startViewTransition!(() => {
+          doCommit()
+        })
+      // `startViewTransition` may return `undefined` in test doubles
+      // that shim it with a bare `(cb) => cb()`. Guard accordingly.
+      if (vt) {
+        // The ViewTransition object exposes THREE promises —
+        // `updateCallbackDone`, `ready`, `finished`. When a newer
+        // `startViewTransition()` starts while this one is in flight,
+        // `ready` and `finished` reject with `AbortError: Transition
+        // was skipped`. We only need to wait on `updateCallbackDone`
+        // (the DOM-commit signal), but the other two MUST still be
+        // handled or the rejection surfaces as an unhandled promise
+        // rejection that breaks test runners and CI dashboards.
+        vt.ready?.catch(() => {})
+        vt.finished?.catch(() => {})
+        if (vt.updateCallbackDone) {
+          try {
+            await vt.updateCallbackDone
+          } catch {
+            // `updateCallbackDone` rejects if the callback itself throws.
+            // The DOM may be in a partial-commit state; the newer
+            // navigation (if any) will re-commit. Swallow so the
+            // navigation chain never hangs on a transition error.
+          }
+        }
+      }
     } else {
       doCommit()
     }
@@ -756,7 +799,7 @@ export function createRouter(options: RouterOptions | RouteRecord[]): Router {
       return
     }
 
-    commitNavigation(path, replace, to, from)
+    await commitNavigation(path, replace, to, from)
     loadingSignal.update((n) => n - 1)
   }
 
@@ -861,15 +904,46 @@ export function createRouter(options: RouterOptions | RouteRecord[]): Router {
       return router._readyPromise
     },
 
+    async preload(path: string) {
+      const resolved = resolveRoute(path, routes)
+      // Load lazy components in parallel and populate the component cache so
+      // the synchronous render pass finds ready components instead of kicking
+      // off async imports (which would fall back to loadingComponent).
+      await Promise.all(
+        resolved.matched.map(async (record) => {
+          if (componentCache.has(record)) return
+          const raw = record.component
+          if (!isLazy(raw)) {
+            componentCache.set(record, raw)
+            return
+          }
+          const mod = await raw.loader()
+          const comp = typeof mod === 'function' ? mod : mod.default
+          componentCache.set(record, comp)
+        }),
+      )
+      // Run loaders for the matched path — uses the same code path SSR
+      // already relied on, so loader data ends up in `_loaderData` under the
+      // matched route records.
+      const ac = new AbortController()
+      router._abortController = ac
+      await Promise.all(
+        resolved.matched
+          .filter((r) => r.loader)
+          .map(async (r) => {
+            const data = await r.loader?.({
+              params: resolved.params,
+              query: resolved.query,
+              signal: ac.signal,
+            })
+            router._loaderData.set(r, data)
+          }),
+      )
+    },
+
     destroy() {
-      if (_popstateHandler) {
-        window.removeEventListener('popstate', _popstateHandler)
-        _popstateHandler = null
-      }
-      if (_hashchangeHandler) {
-        window.removeEventListener('hashchange', _hashchangeHandler)
-        _hashchangeHandler = null
-      }
+      if (_popstateHandler) window.removeEventListener('popstate', _popstateHandler)
+      if (_hashchangeHandler) window.removeEventListener('hashchange', _hashchangeHandler)
       guards.length = 0
       afterHooks.length = 0
       router._blockers.clear()

package/src/scroll.ts

@@ -16,7 +16,11 @@ export class ScrollManager {
 
   /** Call before navigating away — saves current scroll position for `fromPath` */
   save(fromPath: string): void {
-    // save/restore are only called from browser navigation paths (guarded by caller)
+    // ScrollManager methods are only invoked from browser navigation paths,
+    // but an explicit early-return documents the SSR-safety contract at the
+    // callsite (the `no-window-in-ssr` lint rule can't AST-trace indirect
+    // calls from router setup).
+    if (typeof window === 'undefined') return
     this._positions.set(fromPath, window.scrollY)
   }
 
@@ -35,6 +39,7 @@ export class ScrollManager {
   }
 
   private _applyResult(result: 'top' | 'restore' | 'none' | number, toPath: string): void {
+    if (typeof window === 'undefined') return
     // Hash scrolling: if the path contains #, scroll to the element
     const hashIdx = toPath.indexOf('#')
     if (hashIdx >= 0) {

package/src/tests/loader.test.ts

@@ -1,5 +1,6 @@
 import { hydrateLoaderData, prefetchLoaderData, serializeLoaderData } from '../loader'
 import { createRouter, setActiveRouter, useIsActive, useSearchParams } from '../router'
+import { lazy } from '../types'
 import type { RouteRecord, RouterInstance } from '../types'
 
 const Home = () => null
@@ -119,7 +120,7 @@ describe('useIsActive — edge cases', () => {
   })
 
   test('throws when no router installed', () => {
-    expect(() => useIsActive('/')).toThrow('[pyreon-router] No router installed')
+    expect(() => useIsActive('/')).toThrow('[Pyreon] No router installed')
   })
 
   test('exact match for root path', () => {
@@ -227,7 +228,7 @@ describe('useSearchParams — edge cases', () => {
   })
 
   test('throws when no router installed', () => {
-    expect(() => useSearchParams()).toThrow('[pyreon-router] No router installed')
+    expect(() => useSearchParams()).toThrow('[Pyreon] No router installed')
   })
 
   test('returns query params from current route', () => {
@@ -513,3 +514,52 @@ describe('router — staleWhileRevalidate', () => {
     expect(loaderCallCount).toBe(2)
   })
 })
+
+describe('router.preload', () => {
+  test('runs loaders for the preloaded path', async () => {
+    let calls = 0
+    const routes: RouteRecord[] = [
+      { path: '/', component: Home },
+      {
+        path: '/u/:id',
+        component: User,
+        loader: async ({ params }) => {
+          calls++
+          return { id: params.id, name: `User ${params.id}` }
+        },
+      },
+    ]
+    const router = createRouter({ routes, url: '/' }) as RouterInstance
+
+    await router.preload('/u/7')
+
+    expect(calls).toBe(1)
+    expect(router._loaderData.get(routes[1] as RouteRecord)).toEqual({
+      id: '7',
+      name: 'User 7',
+    })
+    // currentRoute is unchanged — preload prepares data, doesn't navigate
+    expect(router.currentRoute().path).toBe('/')
+  })
+
+  test('loads lazy components into the cache so render is synchronous', async () => {
+    let lazyLoadCalls = 0
+    const Lazy = () => null
+    const routes: RouteRecord[] = [
+      { path: '/', component: Home },
+      {
+        path: '/lazy',
+        component: lazy(async () => {
+          lazyLoadCalls++
+          return Lazy
+        }),
+      },
+    ]
+    const router = createRouter({ routes, url: '/' }) as RouterInstance
+
+    await router.preload('/lazy')
+
+    expect(lazyLoadCalls).toBe(1)
+    expect(router._componentCache.get(routes[1] as RouteRecord)).toBe(Lazy)
+  })
+})