@pyreon/zero 0.1.1 → 0.2.0

package/src/fs-router.ts

@@ -263,7 +263,7 @@ export function generateRouteModule(
       `${indent}  component: ${comp}`,
       `${indent}  loader: ${mod}.loader`,
       `${indent}  beforeEnter: ${mod}.guard`,
-      `${indent}  meta: ${mod}.meta`,
+      `${indent}  meta: { ...${mod}.meta, renderMode: ${mod}.renderMode }`,
     ]
 
     if (errorName) {
@@ -290,7 +290,7 @@ export function generateRouteModule(
       `${indent}component: ${layoutComp}`,
       `${indent}loader: ${layoutMod}.loader`,
       `${indent}beforeEnter: ${layoutMod}.guard`,
-      `${indent}meta: ${layoutMod}.meta`,
+      `${indent}meta: { ...${layoutMod}.meta, renderMode: ${layoutMod}.renderMode }`,
     ]
     if (errorName) {
       props.push(`${indent}errorComponent: ${errorName}`)
@@ -353,6 +353,38 @@ export function generateRouteModule(
   ].join('\n')
 }
 
+/**
+ * Generate a virtual module that maps URL patterns to their middleware exports.
+ * Used by the server entry to dispatch per-route middleware.
+ */
+export function generateMiddlewareModule(
+  files: string[],
+  routesDir: string,
+): string {
+  const routes = parseFileRoutes(files)
+  const imports: string[] = []
+  const entries: string[] = []
+  let counter = 0
+
+  for (const route of routes) {
+    if (route.isLayout || route.isError || route.isLoading) continue
+    const name = `_mw${counter++}`
+    const fullPath = `${routesDir}/${route.filePath}`
+    imports.push(`import { middleware as ${name} } from "${fullPath}"`)
+    entries.push(
+      `  { pattern: ${JSON.stringify(route.urlPath)}, middleware: ${name} }`,
+    )
+  }
+
+  return [
+    ...imports,
+    '',
+    `export const routeMiddleware = [`,
+    entries.join(',\n'),
+    `].filter(e => e.middleware)`,
+  ].join('\n')
+}
+
 /**
  * Scan a directory for route files.
  * Returns paths relative to the routes directory.

package/src/index.ts

@@ -13,6 +13,7 @@ export { zeroPlugin as default } from './vite-plugin'
 
 export {
   filePathToUrlPath,
+  generateMiddlewareModule,
   generateRouteModule,
   parseFileRoutes,
   scanRouteFiles,
@@ -104,6 +105,41 @@ export {
   seoPlugin,
 } from './seo'
 
+// ─── API routes ──────────────────────────────────────────────────────────────
+
+export type {
+  ApiContext,
+  ApiHandler,
+  ApiRouteEntry,
+  ApiRouteModule,
+  HttpMethod,
+} from './api-routes'
+export { createApiMiddleware, generateApiRouteModule } from './api-routes'
+
+// ─── CORS ────────────────────────────────────────────────────────────────────
+
+export type { CorsConfig } from './cors'
+export { corsMiddleware } from './cors'
+
+// ─── Rate limiting ──────────────────────────────────────────────────────────
+
+export type { RateLimitConfig } from './rate-limit'
+export { rateLimitMiddleware } from './rate-limit'
+
+// ─── Compression ────────────────────────────────────────────────────────────
+
+export type { CompressionConfig } from './compression'
+export {
+  compressionMiddleware,
+  compressResponse,
+  isCompressible,
+} from './compression'
+
+// ─── Actions ─────────────────────────────────────────────────────────────────
+
+export type { Action, ActionContext, ActionHandler } from './actions'
+export { createActionMiddleware, defineAction } from './actions'
+
 // ─── Types ───────────────────────────────────────────────────────────────────
 
 export type {
@@ -114,6 +150,7 @@ export type {
   LoaderContext,
   RenderMode,
   RouteMeta,
+  RouteMiddlewareEntry,
   RouteModule,
   ZeroConfig,
 } from './types'

package/src/rate-limit.ts

@@ -0,0 +1,122 @@
+import type { Middleware, MiddlewareContext } from '@pyreon/server'
+
+// ─── Rate limiting middleware ───────────────────────────────────────────────
+
+export interface RateLimitConfig {
+  /** Maximum requests per window. Default: `100` */
+  max?: number
+  /** Time window in seconds. Default: `60` */
+  window?: number
+  /** Function to extract the client identifier. Default: IP from headers. */
+  keyFn?: (ctx: MiddlewareContext) => string
+  /** Custom response when rate limited. */
+  onLimit?: (ctx: MiddlewareContext) => Response
+  /** URL patterns to rate limit (glob-style). Default: all paths. */
+  include?: string[]
+  /** URL patterns to exclude from rate limiting. */
+  exclude?: string[]
+}
+
+interface RateLimitEntry {
+  count: number
+  resetAt: number
+}
+
+/**
+ * Rate limiting middleware — limits requests per client within a time window.
+ * Uses an in-memory store (suitable for single-instance deployments).
+ *
+ * @example
+ * import { rateLimitMiddleware } from "@pyreon/zero/rate-limit"
+ *
+ * // 100 requests per minute (default)
+ * rateLimitMiddleware()
+ *
+ * // Strict API rate limiting
+ * rateLimitMiddleware({
+ *   max: 20,
+ *   window: 60,
+ *   include: ["/api/*"],
+ * })
+ */
+export function rateLimitMiddleware(config: RateLimitConfig = {}): Middleware {
+  const {
+    max = 100,
+    window: windowSec = 60,
+    keyFn = defaultKeyFn,
+    onLimit,
+    include,
+    exclude,
+  } = config
+
+  const windowMs = windowSec * 1000
+  const store = new Map<string, RateLimitEntry>()
+
+  // Periodic cleanup of expired entries
+  const cleanupInterval = setInterval(() => {
+    const now = Date.now()
+    for (const [key, entry] of store) {
+      if (entry.resetAt <= now) store.delete(key)
+    }
+  }, windowMs)
+
+  // Allow GC to clean up the interval
+  if (typeof cleanupInterval === 'object' && 'unref' in cleanupInterval) {
+    cleanupInterval.unref()
+  }
+
+  return (ctx: MiddlewareContext) => {
+    // Check include/exclude patterns
+    if (include && !include.some((p) => matchSimpleGlob(p, ctx.path))) return
+    if (exclude?.some((p) => matchSimpleGlob(p, ctx.path))) return
+
+    const key = keyFn(ctx)
+    const now = Date.now()
+    let entry = store.get(key)
+
+    if (!entry || entry.resetAt <= now) {
+      entry = { count: 0, resetAt: now + windowMs }
+      store.set(key, entry)
+    }
+
+    entry.count++
+    const remaining = Math.max(0, max - entry.count)
+    const resetSeconds = Math.ceil((entry.resetAt - now) / 1000)
+
+    // Set rate limit headers on all responses
+    ctx.headers.set('X-RateLimit-Limit', String(max))
+    ctx.headers.set('X-RateLimit-Remaining', String(remaining))
+    ctx.headers.set('X-RateLimit-Reset', String(resetSeconds))
+
+    if (entry.count > max) {
+      if (onLimit) return onLimit(ctx)
+
+      return new Response(JSON.stringify({ error: 'Too many requests' }), {
+        status: 429,
+        headers: {
+          'Content-Type': 'application/json',
+          'Retry-After': String(resetSeconds),
+          'X-RateLimit-Limit': String(max),
+          'X-RateLimit-Remaining': '0',
+          'X-RateLimit-Reset': String(resetSeconds),
+        },
+      })
+    }
+  }
+}
+
+function defaultKeyFn(ctx: MiddlewareContext): string {
+  return (
+    ctx.req.headers.get('x-forwarded-for')?.split(',')[0]?.trim() ??
+    ctx.req.headers.get('x-real-ip') ??
+    'unknown'
+  )
+}
+
+/** Simple glob matching for path patterns. Supports trailing `*`. */
+function matchSimpleGlob(pattern: string, path: string): boolean {
+  if (pattern.endsWith('/*')) {
+    return path.startsWith(pattern.slice(0, -1))
+  }
+  return pattern === path
+}

package/src/testing.ts

@@ -0,0 +1,150 @@
+import type { Middleware, MiddlewareContext } from '@pyreon/server'
+import type { ApiHandler, ApiRouteEntry } from './api-routes'
+import { createApiMiddleware } from './api-routes'
+
+// ─── Test helpers for Zero applications ─────────────────────────────────────
+
+/**
+ * Create a mock MiddlewareContext for testing middleware.
+ *
+ * @example
+ * import { createTestContext } from "@pyreon/zero/testing"
+ *
+ * const ctx = createTestContext("/api/posts", { method: "POST", body: { title: "Hello" } })
+ * const result = await myMiddleware(ctx)
+ */
+export function createTestContext(
+  path: string,
+  options: {
+    method?: string
+    headers?: Record<string, string>
+    body?: unknown
+  } = {},
+): MiddlewareContext {
+  const { method = 'GET', headers = {}, body } = options
+  const url = new URL(`http://localhost${path}`)
+
+  const requestHeaders: Record<string, string> = { ...headers }
+  let requestBody: string | undefined
+
+  if (body !== undefined) {
+    requestHeaders['Content-Type'] = 'application/json'
+    requestBody = JSON.stringify(body)
+  }
+
+  const req = new Request(url.toString(), {
+    method,
+    headers: requestHeaders,
+    body: requestBody,
+  })
+
+  return {
+    req,
+    url,
+    path,
+    headers: new Headers(),
+    locals: {},
+  }
+}
+
+/**
+ * Test a middleware by running it with a mock context and returning
+ * the result along with the response headers it set.
+ *
+ * @example
+ * import { testMiddleware } from "@pyreon/zero/testing"
+ *
+ * const { response, headers } = await testMiddleware(
+ *   corsMiddleware({ origin: "*" }),
+ *   "/api/posts"
+ * )
+ * expect(headers.get("Access-Control-Allow-Origin")).toBe("*")
+ */
+export async function testMiddleware(
+  middleware: Middleware,
+  path: string,
+  options: {
+    method?: string
+    headers?: Record<string, string>
+    body?: unknown
+  } = {},
+): Promise<{ response: Response | undefined; headers: Headers }> {
+  const ctx = createTestContext(path, options)
+  const response = (await middleware(ctx)) as Response | undefined
+  return { response, headers: ctx.headers }
+}
+
+/**
+ * Create a test server for API routes. Returns a function that
+ * accepts Request objects and dispatches to the correct handler.
+ *
+ * @example
+ * import { createTestApiServer } from "@pyreon/zero/testing"
+ *
+ * const server = createTestApiServer([
+ *   { pattern: "/api/posts", module: postsApi },
+ *   { pattern: "/api/posts/:id", module: postByIdApi },
+ * ])
+ *
+ * const response = await server.request("/api/posts")
+ * expect(response.status).toBe(200)
+ *
+ * const data = await server.request("/api/posts", { method: "POST", body: { title: "Hi" } })
+ * expect(data.status).toBe(201)
+ */
+export function createTestApiServer(routes: ApiRouteEntry[]) {
+  const middleware = createApiMiddleware(routes)
+
+  return {
+    async request(
+      path: string,
+      options: {
+        method?: string
+        headers?: Record<string, string>
+        body?: unknown
+      } = {},
+    ): Promise<Response> {
+      const ctx = createTestContext(path, options)
+      const result = await middleware(ctx)
+      if (!result) {
+        return new Response('Not Found', { status: 404 })
+      }
+      return result
+    },
+  }
+}
+
+/**
+ * Create a mock API handler for testing.
+ * Records all calls and returns a configurable response.
+ *
+ * @example
+ * import { createMockHandler } from "@pyreon/zero/testing"
+ *
+ * const handler = createMockHandler({ status: 200, body: { ok: true } })
+ * // ... use handler in your API route module
+ * expect(handler.calls).toHaveLength(1)
+ * expect(handler.calls[0].params).toEqual({ id: "123" })
+ */
+export function createMockHandler(
+  responseConfig: {
+    status?: number
+    body?: unknown
+    headers?: Record<string, string>
+  } = {},
+): ApiHandler & {
+  calls: Array<{ path: string; params: Record<string, string> }>
+} {
+  const { status = 200, body = null, headers = {} } = responseConfig
+  const calls: Array<{ path: string; params: Record<string, string> }> = []
+
+  const handler: ApiHandler = (ctx) => {
+    calls.push({ path: ctx.path, params: ctx.params })
+    return new Response(JSON.stringify(body), {
+      status,
+      headers: { 'Content-Type': 'application/json', ...headers },
+    })
+  }
+
+  return Object.assign(handler, { calls })
+}

package/src/types.ts

@@ -111,6 +111,14 @@ export interface FileRoute {
   renderMode: RenderMode
 }
 
+// ─── Route middleware ────────────────────────────────────────────────────
+
+/** Entry mapping a URL pattern to its route-level middleware. */
+export interface RouteMiddlewareEntry {
+  pattern: string
+  middleware: Middleware | Middleware[]
+}
+
 // ─── Adapter ─────────────────────────────────────────────────────────────────
 
 export interface Adapter {

package/src/vite-plugin.ts

@@ -1,11 +1,23 @@
 import type { Plugin } from 'vite'
+import { generateApiRouteModule } from './api-routes'
 import { resolveConfig } from './config'
-import { generateRouteModule, scanRouteFiles } from './fs-router'
+import { renderErrorOverlay } from './error-overlay'
+import {
+  generateMiddlewareModule,
+  generateRouteModule,
+  scanRouteFiles,
+} from './fs-router'
 import type { ZeroConfig } from './types'
 
 const VIRTUAL_ROUTES_ID = 'virtual:zero/routes'
 const RESOLVED_VIRTUAL_ROUTES_ID = `\0${VIRTUAL_ROUTES_ID}`
 
+const VIRTUAL_MIDDLEWARE_ID = 'virtual:zero/route-middleware'
+const RESOLVED_VIRTUAL_MIDDLEWARE_ID = `\0${VIRTUAL_MIDDLEWARE_ID}`
+
+const VIRTUAL_API_ROUTES_ID = 'virtual:zero/api-routes'
+const RESOLVED_VIRTUAL_API_ROUTES_ID = `\0${VIRTUAL_API_ROUTES_ID}`
+
 /**
  * Zero Vite plugin — adds file-based routing and zero-config conventions
  * on top of @pyreon/vite-plugin.
@@ -35,9 +47,9 @@ export function zeroPlugin(userConfig: ZeroConfig = {}): Plugin {
     },
 
     resolveId(id) {
-      if (id === VIRTUAL_ROUTES_ID) {
-        return RESOLVED_VIRTUAL_ROUTES_ID
-      }
+      if (id === VIRTUAL_ROUTES_ID) return RESOLVED_VIRTUAL_ROUTES_ID
+      if (id === VIRTUAL_MIDDLEWARE_ID) return RESOLVED_VIRTUAL_MIDDLEWARE_ID
+      if (id === VIRTUAL_API_ROUTES_ID) return RESOLVED_VIRTUAL_API_ROUTES_ID
     },
 
     async load(id) {
@@ -49,25 +61,78 @@ export function zeroPlugin(userConfig: ZeroConfig = {}): Plugin {
           return `export const routes = []`
         }
       }
+
+      if (id === RESOLVED_VIRTUAL_MIDDLEWARE_ID) {
+        try {
+          const files = await scanRouteFiles(routesDir)
+          return generateMiddlewareModule(files, routesDir)
+        } catch (_err) {
+          return `export const routeMiddleware = []`
+        }
+      }
+
+      if (id === RESOLVED_VIRTUAL_API_ROUTES_ID) {
+        try {
+          const files = await scanRouteFiles(routesDir)
+          return generateApiRouteModule(files, routesDir)
+        } catch (_err) {
+          return `export const apiRoutes = []`
+        }
+      }
     },
 
     configureServer(server) {
+      // SSR error overlay — intercept HTML requests and catch SSR errors
+      // This runs as a late middleware (return function) so it wraps
+      // Vite's own SSR handling and catches rendering failures.
+      server.middlewares.use((req, res, next) => {
+        const accept = req.headers.accept ?? ''
+        if (!accept.includes('text/html')) return next()
+
+        // Monkey-patch res.end to catch errors from SSR rendering
+        const originalEnd = res.end.bind(res)
+        let errored = false
+
+        const handleError = (err: unknown) => {
+          if (errored) return
+          errored = true
+          const error = err instanceof Error ? err : new Error(String(err))
+          server.ssrFixStacktrace(error)
+          const html = renderErrorOverlay(error)
+          res.statusCode = 500
+          res.setHeader('Content-Type', 'text/html; charset=utf-8')
+          res.setHeader('Content-Length', Buffer.byteLength(html))
+          originalEnd(html)
+        }
+
+        res.on('error', handleError)
+
+        // Wrap next() in try/catch to handle synchronous errors
+        try {
+          next()
+        } catch (err) {
+          handleError(err)
+        }
+      })
+
       // Watch routes directory for changes
       server.watcher.add(`${routesDir}/**/*.{tsx,jsx,ts,js}`)
 
-      // Invalidate virtual module when route files change
+      // Invalidate virtual modules when route files change
       server.watcher.on('all', (event, path) => {
         if (
           path.startsWith(routesDir) &&
           (event === 'add' || event === 'unlink')
         ) {
-          const mod = server.moduleGraph.getModuleById(
+          for (const resolvedId of [
             RESOLVED_VIRTUAL_ROUTES_ID,
-          )
-          if (mod) {
-            server.moduleGraph.invalidateModule(mod)
-            server.ws.send({ type: 'full-reload' })
+            RESOLVED_VIRTUAL_MIDDLEWARE_ID,
+            RESOLVED_VIRTUAL_API_ROUTES_ID,
+          ]) {
+            const mod = server.moduleGraph.getModuleById(resolvedId)
+            if (mod) server.moduleGraph.invalidateModule(mod)
           }
+          server.ws.send({ type: 'full-reload' })
         }
       })
     },

package/lib/fs-router-jfd1QGLB.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"fs-router-jfd1QGLB.js","names":[],"sources":["../src/fs-router.ts"],"sourcesContent":["import type { FileRoute, RenderMode } from './types'\n\n// ─── File-system route conventions ──────────────────────────────────────────\n//\n// src/routes/\n//   _layout.tsx          → layout for all routes\n//   index.tsx            → /\n//   about.tsx            → /about\n//   users/\n//     _layout.tsx        → layout for /users/*\n//     _loading.tsx       → loading fallback for /users/*\n//     _error.tsx         → error boundary for /users/*\n//     index.tsx          → /users\n//     [id].tsx           → /users/:id\n//     [id]/\n//       settings.tsx     → /users/:id/settings\n//   blog/\n//     [...slug].tsx      → /blog/* (catch-all)\n//\n// Conventions:\n//   [param]     → dynamic segment  → :param\n//   [...param]  → catch-all        → :param*\n//   _layout     → layout wrapper (not a route itself)\n//   _error      → error component\n//   _loading    → loading component\n//   (group)     → route group (directory ignored in URL)\n\nconst ROUTE_EXTENSIONS = ['.tsx', '.jsx', '.ts', '.js']\n\n/**\n * Parse a set of file paths (relative to routes dir) into FileRoute objects.\n *\n * @param files Array of file paths like [\"index.tsx\", \"users/[id].tsx\"]\n * @param defaultMode Default rendering mode from config\n */\nexport function parseFileRoutes(\n  files: string[],\n  defaultMode: RenderMode = 'ssr',\n): FileRoute[] {\n  return files\n    .filter((f) => ROUTE_EXTENSIONS.some((ext) => f.endsWith(ext)))\n    .map((filePath) => parseFilePath(filePath, defaultMode))\n    .sort(sortRoutes)\n}\n\nfunction parseFilePath(filePath: string, defaultMode: RenderMode): FileRoute {\n  // Remove extension\n  let route = filePath\n  for (const ext of ROUTE_EXTENSIONS) {\n    if (route.endsWith(ext)) {\n      route = route.slice(0, -ext.length)\n      break\n    }\n  }\n\n  const fileName = getFileName(route)\n  const isLayout = fileName === '_layout'\n  const isError = fileName === '_error'\n  const isLoading = fileName === '_loading'\n  const isCatchAll = route.includes('[...')\n\n  // Get directory path (strip groups for consistent grouping)\n  const parts = route.split('/')\n  parts.pop() // remove filename\n  const dirPath = parts\n    .filter((s) => !(s.startsWith('(') && s.endsWith(')')))\n    .join('/')\n\n  // Convert file path to URL pattern\n  const urlPath = filePathToUrlPath(route)\n  const depth = urlPath === '/' ? 0 : urlPath.split('/').filter(Boolean).length\n\n  return {\n    filePath,\n    urlPath,\n    dirPath,\n    depth,\n    isLayout,\n    isError,\n    isLoading,\n    isCatchAll,\n    renderMode: defaultMode,\n  }\n}\n\n/**\n * Convert a file path (without extension) to a URL path pattern.\n *\n * Examples:\n *   \"index\"            → \"/\"\n *   \"about\"            → \"/about\"\n *   \"users/index\"      → \"/users\"\n *   \"users/[id]\"       → \"/users/:id\"\n *   \"blog/[...slug]\"   → \"/blog/:slug*\"\n *   \"(auth)/login\"     → \"/login\"         (group stripped)\n *   \"_layout\"          → \"/\"              (layout marker)\n */\nexport function filePathToUrlPath(filePath: string): string {\n  const segments = filePath.split('/')\n  const urlSegments: string[] = []\n\n  for (const seg of segments) {\n    // Skip route groups \"(name)\"\n    if (seg.startsWith('(') && seg.endsWith(')')) continue\n\n    // Skip special files\n    if (seg === '_layout' || seg === '_error' || seg === '_loading') continue\n\n    // \"index\" maps to the parent path\n    if (seg === 'index') continue\n\n    // Catch-all: [...param] → :param*\n    const catchAll = seg.match(/^\\[\\.\\.\\.(\\w+)\\]$/)\n    if (catchAll) {\n      urlSegments.push(`:${catchAll[1]}*`)\n      continue\n    }\n\n    // Dynamic: [param] → :param\n    const dynamic = seg.match(/^\\[(\\w+)\\]$/)\n    if (dynamic) {\n      urlSegments.push(`:${dynamic[1]}`)\n      continue\n    }\n\n    urlSegments.push(seg)\n  }\n\n  const path = `/${urlSegments.join('/')}`\n  return path || '/'\n}\n\n/** Sort routes: static before dynamic, catch-all last. */\nfunction sortRoutes(a: FileRoute, b: FileRoute): number {\n  // Catch-all routes go last\n  if (a.isCatchAll !== b.isCatchAll) return a.isCatchAll ? 1 : -1\n  // Layouts go first within same depth\n  if (a.isLayout !== b.isLayout) return a.isLayout ? -1 : 1\n  // Static segments before dynamic\n  const aDynamic = a.urlPath.includes(':')\n  const bDynamic = b.urlPath.includes(':')\n  if (aDynamic !== bDynamic) return aDynamic ? 1 : -1\n  // Alphabetical\n  return a.urlPath.localeCompare(b.urlPath)\n}\n\nfunction getFileName(filePath: string): string {\n  const parts = filePath.split('/')\n  return parts[parts.length - 1] ?? ''\n}\n\n// ─── Route generation (for Vite plugin) ─────────────────────────────────────\n\n/** Internal tree node for building nested route structures. */\ninterface RouteNode {\n  /** Page routes at this directory level. */\n  pages: FileRoute[]\n  /** Layout file for this directory (if any). */\n  layout?: FileRoute\n  /** Error boundary file (if any). */\n  error?: FileRoute\n  /** Loading fallback file (if any). */\n  loading?: FileRoute\n  /** Child directories. */\n  children: Map<string, RouteNode>\n}\n\n/**\n * Group flat file routes into a directory tree.\n */\nfunction getOrCreateChild(node: RouteNode, segment: string): RouteNode {\n  let child = node.children.get(segment)\n  if (!child) {\n    child = { pages: [], children: new Map() }\n    node.children.set(segment, child)\n  }\n  return child\n}\n\nfunction resolveNode(root: RouteNode, dirPath: string): RouteNode {\n  let node = root\n  if (dirPath) {\n    for (const segment of dirPath.split('/')) {\n      node = getOrCreateChild(node, segment)\n    }\n  }\n  return node\n}\n\nfunction placeRoute(node: RouteNode, route: FileRoute) {\n  if (route.isLayout) node.layout = route\n  else if (route.isError) node.error = route\n  else if (route.isLoading) node.loading = route\n  else node.pages.push(route)\n}\n\nfunction buildRouteTree(routes: FileRoute[]): RouteNode {\n  const root: RouteNode = { pages: [], children: new Map() }\n  for (const route of routes) {\n    placeRoute(resolveNode(root, route.dirPath), route)\n  }\n  return root\n}\n\n/**\n * Generate a virtual module that exports a nested route tree.\n * Wires up layouts as parent routes with children, loaders, guards,\n * error/loading components, middleware, and meta from route module exports.\n */\nexport function generateRouteModule(\n  files: string[],\n  routesDir: string,\n): string {\n  const routes = parseFileRoutes(files)\n  const tree = buildRouteTree(routes)\n  const imports: string[] = []\n  let importCounter = 0\n\n  function nextImport(filePath: string, exportName = 'default'): string {\n    const name = `_${importCounter++}`\n    const fullPath = `${routesDir}/${filePath}`\n    if (exportName === 'default') {\n      imports.push(`import ${name} from \"${fullPath}\"`)\n    } else {\n      imports.push(`import { ${exportName} as ${name} } from \"${fullPath}\"`)\n    }\n    return name\n  }\n\n  function nextLazy(\n    filePath: string,\n    loadingName?: string,\n    errorName?: string,\n  ): string {\n    const name = `_${importCounter++}`\n    const fullPath = `${routesDir}/${filePath}`\n    const opts: string[] = []\n    if (loadingName) opts.push(`loading: ${loadingName}`)\n    if (errorName) opts.push(`error: ${errorName}`)\n    const optsStr = opts.length > 0 ? `, { ${opts.join(', ')} }` : ''\n    imports.push(`const ${name} = lazy(() => import(\"${fullPath}\")${optsStr})`)\n    return name\n  }\n\n  function nextModuleImport(filePath: string): string {\n    const name = `_m${importCounter++}`\n    const fullPath = `${routesDir}/${filePath}`\n    imports.push(`import * as ${name} from \"${fullPath}\"`)\n    return name\n  }\n\n  function generatePageRoute(\n    page: FileRoute,\n    indent: string,\n    loadingName: string | undefined,\n    errorName: string | undefined,\n  ): string {\n    const mod = nextModuleImport(page.filePath)\n    const comp = nextLazy(page.filePath, loadingName, errorName)\n\n    const props: string[] = [\n      `${indent}  path: ${JSON.stringify(page.urlPath)}`,\n      `${indent}  component: ${comp}`,\n      `${indent}  loader: ${mod}.loader`,\n      `${indent}  beforeEnter: ${mod}.guard`,\n      `${indent}  meta: ${mod}.meta`,\n    ]\n\n    if (errorName) {\n      props.push(`${indent}  errorComponent: ${mod}.error || ${errorName}`)\n    } else {\n      props.push(`${indent}  errorComponent: ${mod}.error`)\n    }\n\n    return `${indent}{\\n${props.join(',\\n')}\\n${indent}}`\n  }\n\n  function wrapWithLayout(\n    node: RouteNode,\n    children: string[],\n    indent: string,\n    errorName: string | undefined,\n  ): string {\n    const layout = node.layout as FileRoute\n    const layoutMod = nextModuleImport(layout.filePath)\n    const layoutComp = nextImport(layout.filePath, 'layout')\n\n    const props: string[] = [\n      `${indent}path: ${JSON.stringify(layout.urlPath)}`,\n      `${indent}component: ${layoutComp}`,\n      `${indent}loader: ${layoutMod}.loader`,\n      `${indent}beforeEnter: ${layoutMod}.guard`,\n      `${indent}meta: ${layoutMod}.meta`,\n    ]\n    if (errorName) {\n      props.push(`${indent}errorComponent: ${errorName}`)\n    }\n    if (children.length > 0) {\n      props.push(`${indent}children: [\\n${children.join(',\\n')}\\n${indent}]`)\n    }\n\n    return `${indent}{\\n${props.map((p) => `  ${p}`).join(',\\n')}\\n${indent}}`\n  }\n\n  /**\n   * Generate route definitions for a tree node.\n   */\n  function generateNode(node: RouteNode, depth: number): string[] {\n    const indent = '  '.repeat(depth + 1)\n\n    const errorName = node.error ? nextImport(node.error.filePath) : undefined\n    const loadingName = node.loading\n      ? nextImport(node.loading.filePath)\n      : undefined\n\n    const childRouteDefs: string[] = []\n    for (const [, childNode] of node.children) {\n      childRouteDefs.push(...generateNode(childNode, depth + 1))\n    }\n\n    const pageRouteDefs = node.pages.map((page) =>\n      generatePageRoute(page, indent, loadingName, errorName),\n    )\n\n    const allChildren = [...pageRouteDefs, ...childRouteDefs]\n\n    if (node.layout) {\n      return [wrapWithLayout(node, allChildren, indent, errorName)]\n    }\n    return allChildren\n  }\n\n  const routeDefs = generateNode(tree, 0)\n\n  return [\n    `import { lazy } from \"@pyreon/router\"`,\n    '',\n    ...imports,\n    '',\n    // Filter out undefined properties at runtime\n    `function clean(routes) {`,\n    `  return routes.map(r => {`,\n    `    const c = {}`,\n    `    for (const k in r) if (r[k] !== undefined) c[k] = r[k]`,\n    `    if (c.children) c.children = clean(c.children)`,\n    `    return c`,\n    `  })`,\n    `}`,\n    '',\n    `export const routes = clean([`,\n    routeDefs.join(',\\n'),\n    `])`,\n  ].join('\\n')\n}\n\n/**\n * Scan a directory for route files.\n * Returns paths relative to the routes directory.\n */\nexport async function scanRouteFiles(routesDir: string): Promise<string[]> {\n  const { readdir } = await import('node:fs/promises')\n  const { join, relative } = await import('node:path')\n\n  const files: string[] = []\n\n  async function walk(dir: string) {\n    const entries = await readdir(dir, { withFileTypes: true })\n    for (const entry of entries) {\n      const fullPath = join(dir, entry.name)\n      if (entry.isDirectory()) {\n        await walk(fullPath)\n      } else if (ROUTE_EXTENSIONS.some((ext) => entry.name.endsWith(ext))) {\n        files.push(relative(routesDir, fullPath))\n      }\n    }\n  }\n\n  await walk(routesDir)\n  return files\n}\n"],"mappings":"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"}