@pyreon/router 0.12.4 → 0.12.5

package/lib/types/index.d.ts

@@ -36,6 +36,8 @@ interface RouteMeta {
   requiresAuth?: boolean;
   /** Scroll behavior for this route */
   scrollBehavior?: 'top' | 'restore' | 'none';
+  /** Set to false to disable View Transitions API for this route. Default: true */
+  viewTransition?: boolean;
 }
 interface ResolvedRoute<P extends Record<string, string | undefined> = Record<string, string>, Q extends Record<string, string> = Record<string, string>> {
   path: string;
@@ -67,6 +69,25 @@ type RouteComponent = ComponentFn$1 | LazyComponent;
 type NavigationGuardResult = boolean | string | undefined;
 type NavigationGuard = (to: ResolvedRoute, from: ResolvedRoute) => NavigationGuardResult | Promise<NavigationGuardResult>;
 type AfterEachHook = (to: ResolvedRoute, from: ResolvedRoute) => void;
+/**
+ * Context object passed through the middleware chain.
+ * Middleware can read/write arbitrary data on `ctx.data`.
+ */
+interface RouteMiddlewareContext {
+  /** The route being navigated to. */
+  to: ResolvedRoute;
+  /** The route being navigated from. */
+  from: ResolvedRoute;
+  /** Shared data — middleware can accumulate state here for downstream middleware/components. */
+  data: Record<string, unknown>;
+}
+/**
+ * Route middleware function. Called before guards.
+ * - Return nothing/undefined to continue
+ * - Return `false` to cancel navigation
+ * - Return a string to redirect
+ */
+type RouteMiddleware = (ctx: RouteMiddlewareContext) => void | false | string | Promise<void | false | string>;
 /**
  * Called before each navigation. Return `true` to block, `false` to allow.
  * Async blockers are supported (e.g. to show a confirmation dialog).
@@ -125,6 +146,8 @@ interface RouteRecord<TPath extends string = string> {
   staleWhileRevalidate?: boolean;
   /** Component rendered when this route's loader throws an error */
   errorComponent?: ComponentFn$1;
+  /** Per-route middleware — runs before guards, can accumulate context data. */
+  middleware?: RouteMiddleware | RouteMiddleware[];
 }
 type ScrollBehaviorFn = (to: ResolvedRoute, from: ResolvedRoute, savedPosition: number | null) => 'top' | 'restore' | 'none' | number;
 interface RouterOptions {
@@ -172,12 +195,23 @@ interface RouterOptions {
    */
   trailingSlash?: 'strip' | 'add' | 'ignore';
 }
-interface Router {
+/**
+ * Router interface. Parameterized by route name union for type-safe named navigation.
+ *
+ * @example
+ * ```ts
+ * type MyRoutes = 'home' | 'user' | 'settings'
+ * const router: Router<MyRoutes> = createRouter({ routes })
+ * router.push({ name: 'user', params: { id: '42' } }) // ✓
+ * router.push({ name: 'typo' })                        // TS error
+ * ```
+ */
+interface Router<TNames extends string = string> {
   /** Navigate to a path */
   push(path: string): Promise<void>;
-  /** Navigate to a path by name */
+  /** Navigate to a named route */
   push(location: {
-    name: string;
+    name: TNames;
     params?: Record<string, string>;
     query?: Record<string, string>;
   }): Promise<void>;
@@ -185,7 +219,7 @@ interface Router {
   replace(path: string): Promise<void>;
   /** Replace current history entry using a named route */
   replace(location: {
-    name: string;
+    name: TNames;
     params?: Record<string, string>;
     query?: Record<string, string>;
   }): Promise<void>;
@@ -446,8 +480,84 @@ declare function useBlocker(fn: BlockerFn): Blocker;
  * ```
  */
 declare function useIsActive(path: string, exact?: boolean): () => boolean;
+/** Schema entry for typed search params. */
+type SearchParamSchema = {
+  [key: string]: 'string' | 'number' | 'boolean';
+};
+/** Infer the typed result from a search param schema. */
+type InferSearchParams<T extends SearchParamSchema> = { [K in keyof T]: T[K] extends 'number' ? number : T[K] extends 'boolean' ? boolean : string };
+/**
+ * Read and write URL search params reactively.
+ *
+ * @example Basic (untyped)
+ * ```ts
+ * const [params, setParams] = useSearchParams({ page: "1" })
+ * params().page // "1"
+ * setParams({ page: "2" }) // updates URL
+ * ```
+ *
+ * @example Typed with schema
+ * ```ts
+ * const [params, setParams] = useSearchParams({
+ *   page: 'number',
+ *   sort: 'string',
+ *   desc: 'boolean',
+ * })
+ * params().page  // number (auto-coerced)
+ * params().desc  // boolean
+ * ```
+ */
 declare function useSearchParams<T extends Record<string, string>>(defaults?: T): [get: () => T, set: (updates: Partial<T>) => Promise<void>];
+/**
+ * Typed search params with auto-coercion.
+ *
+ * Schema values define the type: `'string'`, `'number'`, or `'boolean'`.
+ * Query string values are automatically coerced to the declared type.
+ *
+ * @example
+ * ```ts
+ * const [params, setParams] = useTypedSearchParams({
+ *   page: 'number',
+ *   sort: 'string',
+ *   desc: 'boolean',
+ * })
+ * params().page  // number (coerced from "3" → 3)
+ * params().desc  // boolean (coerced from "true" → true)
+ * setParams({ page: 2 }) // updates URL with ?page=2
+ * ```
+ */
+declare function useTypedSearchParams<T extends SearchParamSchema>(schema: T): [get: () => InferSearchParams<T>, set: (updates: Partial<InferSearchParams<T>>) => Promise<void>];
+/**
+ * Returns true while a navigation is in progress (guards + loaders running).
+ * Use this to show loading indicators during route transitions.
+ *
+ * @example
+ * ```tsx
+ * const isNavigating = useTransition()
+ * <Show when={isNavigating}>
+ *   <LoadingBar />
+ * </Show>
+ * ```
+ */
+declare function useTransition(): () => boolean;
+/**
+ * Read data accumulated by route middleware.
+ *
+ * @example
+ * ```ts
+ * // In middleware:
+ * const authMiddleware: RouteMiddleware = async (ctx) => {
+ *   ctx.data.user = await getUser(ctx.to)
+ *   if (!ctx.data.user) return '/login'
+ * }
+ *
+ * // In component:
+ * const data = useMiddlewareData()
+ * const user = () => data().user as User
+ * ```
+ */
+declare function useMiddlewareData(): () => Record<string, unknown>;
 declare function createRouter(options: RouterOptions | RouteRecord[]): Router;
 //#endregion
-export { type AfterEachHook, type Blocker, type BlockerFn, type ExtractParams, type LazyComponent, type LoaderContext, type NavigationGuard, type NavigationGuardResult, type ResolvedRoute, type RouteComponent, type RouteLoaderFn, type RouteMeta, type RouteRecord, type Router, RouterContext, RouterLink, type RouterLinkProps, type RouterOptions, RouterProvider, type RouterProviderProps, RouterView, type RouterViewProps, type ScrollBehaviorFn, buildPath, createRouter, findRouteByName, hydrateLoaderData, lazy, onBeforeRouteLeave, onBeforeRouteUpdate, parseQuery, parseQueryMulti, prefetchLoaderData, resolveRoute, serializeLoaderData, stringifyQuery, useBlocker, useIsActive, useLoaderData, useRoute, useRouter, useSearchParams };
+export { type AfterEachHook, type Blocker, type BlockerFn, type ExtractParams, type LazyComponent, type LoaderContext, type NavigationGuard, type NavigationGuardResult, type ResolvedRoute, type RouteComponent, type RouteLoaderFn, type RouteMeta, type RouteMiddleware, type RouteMiddlewareContext, type RouteRecord, type Router, RouterContext, RouterLink, type RouterLinkProps, type RouterOptions, RouterProvider, type RouterProviderProps, RouterView, type RouterViewProps, type ScrollBehaviorFn, buildPath, createRouter, findRouteByName, hydrateLoaderData, lazy, onBeforeRouteLeave, onBeforeRouteUpdate, parseQuery, parseQueryMulti, prefetchLoaderData, resolveRoute, serializeLoaderData, stringifyQuery, useBlocker, useIsActive, useLoaderData, useMiddlewareData, useRoute, useRouter, useSearchParams, useTransition, useTypedSearchParams };
 //# sourceMappingURL=index2.d.ts.map

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.4",
+  "version": "0.12.5",
   "description": "Official router for Pyreon",
   "homepage": "https://github.com/pyreon/pyreon/tree/main/packages/router#readme",
   "bugs": {
@@ -42,9 +42,9 @@
     "prepublishOnly": "bun run build"
   },
   "dependencies": {
-    "@pyreon/core": "^0.12.4",
-    "@pyreon/reactivity": "^0.12.4",
-    "@pyreon/runtime-dom": "^0.12.4"
+    "@pyreon/core": "^0.12.5",
+    "@pyreon/reactivity": "^0.12.5",
+    "@pyreon/runtime-dom": "^0.12.5"
   },
   "devDependencies": {
     "@happy-dom/global-registrator": "^20.8.9",

package/src/components.tsx

@@ -1,5 +1,5 @@
 import type { ComponentFn, Props, VNodeChild } from '@pyreon/core'
-import { createRef, h, onUnmount, provide, useContext } from '@pyreon/core'
+import { createRef, ErrorBoundary, h, onUnmount, provide, useContext } from '@pyreon/core'
 import { LoaderDataContext, prefetchLoaderData } from './loader'
 import { isLazy, RouterContext, setActiveRouter } from './router'
 import type { LazyComponent, ResolvedRoute, RouteRecord, Router, RouterInstance } from './types'
@@ -250,11 +250,28 @@ function renderWithLoader(
   route: Pick<ResolvedRoute, 'params' | 'query' | 'meta'>,
 ): VNodeChild {
   const routeProps = { params: route.params, query: route.query, meta: route.meta }
-  if (!record.loader) {
-    return h(Comp, routeProps)
+
+  // If route has an error component, wrap rendering in error boundary
+  if (record.errorComponent) {
+    return h(ErrorBoundary, {
+      fallback: (error: Error) => h(record.errorComponent!, { ...routeProps, error }),
+      children: record.loader
+        ? renderLoaderContent(router, record, Comp, routeProps)
+        : h(Comp, routeProps),
+    })
   }
+
+  if (!record.loader) return h(Comp, routeProps)
+  return renderLoaderContent(router, record, Comp, routeProps)
+}
+
+function renderLoaderContent(
+  router: RouterInstance,
+  record: RouteRecord,
+  Comp: ComponentFn,
+  routeProps: Record<string, unknown>,
+): VNodeChild {
   const data = router._loaderData.get(record)
-  // If loader data is undefined and route has an errorComponent, render it
   if (data === undefined && record.errorComponent) {
     return h(record.errorComponent, routeProps)
   }

package/src/index.ts

@@ -64,7 +64,10 @@ export {
   useIsActive,
   useRoute,
   useRouter,
+  useMiddlewareData,
   useSearchParams,
+  useTransition,
+  useTypedSearchParams,
 } from './router'
 // Types
 // Data loaders
@@ -81,6 +84,8 @@ export type {
   RouteComponent,
   RouteLoaderFn,
   RouteMeta,
+  RouteMiddleware,
+  RouteMiddlewareContext,
   RouteRecord,
   Router,
   RouterOptions,

package/src/router.ts

@@ -12,6 +12,8 @@ import {
   type NavigationGuard,
   type NavigationGuardResult,
   type ResolvedRoute,
+  type RouteMiddleware,
+  type RouteMiddlewareContext,
   type RouteRecord,
   type Router,
   type RouterInstance,
@@ -227,14 +229,43 @@ function matchSegments(current: string, pattern: string, exact: boolean): boolea
   return ps.every((seg, i) => seg.startsWith(':') || seg === cs[i])
 }
 
+/** Schema entry for typed search params. */
+export type SearchParamSchema = {
+  [key: string]: 'string' | 'number' | 'boolean'
+}
+
+/** Infer the typed result from a search param schema. */
+type InferSearchParams<T extends SearchParamSchema> = {
+  [K in keyof T]: T[K] extends 'number' ? number
+    : T[K] extends 'boolean' ? boolean
+    : string
+}
+
+/**
+ * Read and write URL search params reactively.
+ *
+ * @example Basic (untyped)
+ * ```ts
+ * const [params, setParams] = useSearchParams({ page: "1" })
+ * params().page // "1"
+ * setParams({ page: "2" }) // updates URL
+ * ```
+ *
+ * @example Typed with schema
+ * ```ts
+ * const [params, setParams] = useSearchParams({
+ *   page: 'number',
+ *   sort: 'string',
+ *   desc: 'boolean',
+ * })
+ * params().page  // number (auto-coerced)
+ * params().desc  // boolean
+ * ```
+ */
 export function useSearchParams<T extends Record<string, string>>(
   defaults?: T,
 ): [get: () => T, set: (updates: Partial<T>) => Promise<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}>.',
-    )
+  const router = _getRouter()
   const get = (): T => {
     const query = router.currentRoute().query
     if (!defaults) return query as T
@@ -248,6 +279,98 @@ export function useSearchParams<T extends Record<string, string>>(
   return [get, set]
 }
 
+/**
+ * Typed search params with auto-coercion.
+ *
+ * Schema values define the type: `'string'`, `'number'`, or `'boolean'`.
+ * Query string values are automatically coerced to the declared type.
+ *
+ * @example
+ * ```ts
+ * const [params, setParams] = useTypedSearchParams({
+ *   page: 'number',
+ *   sort: 'string',
+ *   desc: 'boolean',
+ * })
+ * params().page  // number (coerced from "3" → 3)
+ * params().desc  // boolean (coerced from "true" → true)
+ * setParams({ page: 2 }) // updates URL with ?page=2
+ * ```
+ */
+export function useTypedSearchParams<T extends SearchParamSchema>(
+  schema: T,
+): [get: () => InferSearchParams<T>, set: (updates: Partial<InferSearchParams<T>>) => Promise<void>] {
+  const router = _getRouter()
+  const get = (): InferSearchParams<T> => {
+    const query = router.currentRoute().query
+    const result: Record<string, unknown> = {}
+    for (const [key, type] of Object.entries(schema)) {
+      const raw = query[key]
+      if (type === 'number') result[key] = raw !== undefined ? Number(raw) : 0
+      else if (type === 'boolean') result[key] = raw === 'true' || raw === '1'
+      else result[key] = raw ?? ''
+    }
+    return result as InferSearchParams<T>
+  }
+  const set = (updates: Partial<InferSearchParams<T>>): Promise<void> => {
+    const current = get()
+    const merged: Record<string, string> = {}
+    for (const [k, v] of Object.entries({ ...current, ...updates })) {
+      merged[k] = String(v)
+    }
+    const path = router.currentRoute().path + stringifyQuery(merged)
+    return router.replace(path)
+  }
+  return [get, set]
+}
+
+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}>.',
+    )
+  return router
+}
+
+/**
+ * Returns true while a navigation is in progress (guards + loaders running).
+ * Use this to show loading indicators during route transitions.
+ *
+ * @example
+ * ```tsx
+ * const isNavigating = useTransition()
+ * <Show when={isNavigating}>
+ *   <LoadingBar />
+ * </Show>
+ * ```
+ */
+export function useTransition(): () => boolean {
+  const router = _getRouter()
+  return () => router._loadingSignal() > 0
+}
+
+/**
+ * Read data accumulated by route middleware.
+ *
+ * @example
+ * ```ts
+ * // In middleware:
+ * const authMiddleware: RouteMiddleware = async (ctx) => {
+ *   ctx.data.user = await getUser(ctx.to)
+ *   if (!ctx.data.user) return '/login'
+ * }
+ *
+ * // In component:
+ * const data = useMiddlewareData()
+ * const user = () => data().user as User
+ * ```
+ */
+export function useMiddlewareData(): () => Record<string, unknown> {
+  const router = _getRouter()
+  return () => (router.currentRoute() as any)._middlewareData ?? {}
+}
+
 // ─── Factory ──────────────────────────────────────────────────────────────────
 
 export function createRouter(options: RouterOptions | RouteRecord[]): Router {
@@ -489,17 +612,34 @@ export function createRouter(options: RouterOptions | RouteRecord[]): Router {
     from: ResolvedRoute,
   ): void {
     scrollManager.save(from.path)
-    currentPath.set(path)
-    syncBrowserUrl(path, replace)
 
-    if (_isBrowser && to.meta.title) {
-      document.title = to.meta.title
-    }
+    const doCommit = () => {
+      currentPath.set(path)
+      syncBrowserUrl(path, replace)
 
-    for (const record of router._loaderData.keys()) {
-      if (!to.matched.includes(record)) {
-        router._loaderData.delete(record)
+      if (_isBrowser && to.meta.title) {
+        document.title = to.meta.title
       }
+
+      for (const record of router._loaderData.keys()) {
+        if (!to.matched.includes(record)) {
+          router._loaderData.delete(record)
+        }
+      }
+    }
+
+    // Use View Transitions API when available and not explicitly disabled.
+    // Route meta can opt out: meta: { viewTransition: false }
+    const useVT = _isBrowser
+      && to.meta.viewTransition !== false
+      && typeof (document as any).startViewTransition === 'function'
+
+    if (useVT) {
+      (document as any).startViewTransition(() => {
+        doCommit()
+      })
+    } else {
+      doCommit()
     }
 
     for (const hook of afterHooks) {
@@ -529,6 +669,30 @@ export function createRouter(options: RouterOptions | RouteRecord[]): Router {
     return 'continue'
   }
 
+  /** Run per-route middleware chain. Middleware from all matched routes execute in order. */
+  async function runMiddleware(
+    to: ResolvedRoute,
+    from: ResolvedRoute,
+    gen: number,
+  ): Promise<{ action: 'continue' } | { action: 'cancel' } | { action: 'redirect'; target: string }> {
+    const ctx: RouteMiddlewareContext = { to, from, data: {} }
+
+    for (const record of to.matched) {
+      if (!record.middleware) continue
+      const mws = Array.isArray(record.middleware) ? record.middleware : [record.middleware]
+      for (const mw of mws) {
+        if (gen !== _navGen) return { action: 'cancel' }
+        const result = await mw(ctx)
+        if (result === false) return { action: 'cancel' }
+        if (typeof result === 'string') return { action: 'redirect', target: result }
+      }
+    }
+
+    // Store middleware data on the resolved route for component access
+    ;(to as any)._middlewareData = ctx.data
+    return { action: 'continue' }
+  }
+
   async function navigate(rawPath: string, replace: boolean, redirectDepth = 0): Promise<void> {
     if (redirectDepth > 10) {
       if (__DEV__) {
@@ -560,6 +724,16 @@ export function createRouter(options: RouterOptions | RouteRecord[]): Router {
       return
     }
 
+    // Run per-route middleware chain (before guards)
+    const mwResult = await runMiddleware(to, from, gen)
+    if (mwResult.action !== 'continue') {
+      loadingSignal.update((n) => n - 1)
+      if (mwResult.action === 'redirect') {
+        return navigate(sanitizePath(mwResult.target), replace, redirectDepth + 1)
+      }
+      return
+    }
+
     const guardOutcome = await runAllGuards(to, from, gen)
     if (guardOutcome.action !== 'continue') {
       loadingSignal.update((n) => n - 1)

package/src/scroll.ts

@@ -35,6 +35,26 @@ export class ScrollManager {
   }
 
   private _applyResult(result: 'top' | 'restore' | 'none' | number, toPath: string): void {
+    // Hash scrolling: if the path contains #, scroll to the element
+    const hashIdx = toPath.indexOf('#')
+    if (hashIdx >= 0) {
+      const id = toPath.slice(hashIdx + 1)
+      if (id) {
+        // Use requestAnimationFrame to ensure DOM is updated before scrolling
+        requestAnimationFrame(() => {
+          const el = document.getElementById(id)
+          if (el) {
+            el.scrollIntoView({ behavior: 'smooth' })
+            return
+          }
+          // Fallback: try name attribute (for anchors)
+          const namedEl = document.querySelector(`[name="${CSS.escape(id)}"]`)
+          if (namedEl) namedEl.scrollIntoView({ behavior: 'smooth' })
+        })
+        return
+      }
+    }
+
     if (result === 'none') return
     if (result === 'top' || result === undefined) {
       window.scrollTo({ top: 0, behavior: 'instant' as ScrollBehavior })