@flight-framework/core 0.2.6 → 0.3.1

package/README.md

@@ -1,18 +1,17 @@
 # @flight-framework/core
 
-Core primitives for Flight Framework - the agnostic full-stack framework with maximum flexibility and zero lock-in.
+Core primitives for Flight Framework, including configuration, routing, caching, streaming SSR, and server actions.
 
 ## Features
 
-- **Multi-Render Mode** - SSR, SSG, ISR, and streaming in one unified API
-- **Framework Agnostic** - Works with React, Vue, Svelte, Solid, HTMX, and more
-- **File-Based Routing** - Automatic route discovery from filesystem
-- **Server Actions** - Type-safe server functions with form support
-- **Streaming SSR** - Out-of-order streaming with priority control
-- **Islands Architecture** - Partial hydration with any UI framework
-- **Caching System** - Pluggable cache adapters with deduplication
-- **Error Handling** - Structured errors with type guards and React integration
-- **Zero Lock-in** - Every component is replaceable
+- Multi-render mode: SSR, SSG, ISR, and streaming
+- Framework support: React, Vue, Svelte, Solid, HTMX
+- File-based routing with automatic route discovery
+- Type-safe server actions with form support
+- Streaming SSR with priority control
+- Islands architecture for partial hydration
+- Pluggable cache adapters with deduplication
+- Structured error handling with type guards
 
 ## Installation
 
@@ -171,20 +170,153 @@ hydrateIslands({
 
 ### Middleware
 
-```typescript
-import { createMiddlewareChain } from '@flight-framework/core/middleware';
+Flight provides a composable middleware system for request/response handling.
+
+#### Middleware Chain
 
-const middleware = createMiddlewareChain([
-  async (ctx, next) => {
+```typescript
+import { 
+  createMiddlewareChain, 
+  cors, 
+  logger, 
+  securityHeaders 
+} from '@flight-framework/core/middleware';
+
+const chain = createMiddlewareChain();
+
+chain
+  .use(logger())
+  .use(cors({ origin: ['https://app.example.com'] }))
+  .use(securityHeaders())
+  .use(async (ctx, next) => {
     const start = Date.now();
     await next();
     console.log(`Request took ${Date.now() - start}ms`);
+  });
+```
+
+#### Error Handling
+
+Centralized error handling with the `errorHandler` factory:
+
+```typescript
+import { createMiddlewareChain, errorHandler } from '@flight-framework/core/middleware';
+
+const chain = createMiddlewareChain();
+
+// Place error handler first in the chain
+chain.use(errorHandler({
+  expose: process.env.NODE_ENV === 'development',
+  emit: (error, ctx) => {
+    logger.error(`[${ctx.method}] ${ctx.url.pathname}:`, error);
+    errorTracker.capture(error);
+  },
+}));
+
+chain.use(authMiddleware);
+chain.use(routeHandler);
+```
+
+The error handler catches all downstream errors, sets appropriate status codes, and supports custom error handlers:
+
+```typescript
+chain.use(errorHandler({
+  onError: async ({ error, status, ctx, timestamp }) => {
+    ctx.status = status;
+    ctx.responseBody = JSON.stringify({
+      error: error.message,
+      timestamp,
+      requestId: ctx.locals.requestId,
+    });
   },
-  authMiddleware,
-  loggingMiddleware,
-]);
+}));
 ```
 
+#### Typed Context
+
+Middleware context supports generics for type-safe data sharing:
+
+```typescript
+import type { Middleware, MiddlewareContext } from '@flight-framework/core/middleware';
+
+interface AppLocals {
+  user: { id: string; role: string };
+  requestId: string;
+  db: DatabaseClient;
+}
+
+const authMiddleware: Middleware<AppLocals> = async (ctx, next) => {
+  const token = ctx.headers.get('Authorization');
+  const user = await verifyToken(token);
+  
+  ctx.locals.user = user;
+  ctx.locals.requestId = crypto.randomUUID();
+  
+  await next();
+};
+
+// Type-safe access in subsequent middleware
+const roleGuard: Middleware<AppLocals> = async (ctx, next) => {
+  if (ctx.locals.user.role !== 'admin') {
+    ctx.status = 403;
+    ctx.responseBody = 'Forbidden';
+    return;
+  }
+  await next();
+};
+```
+
+#### CORS
+
+CORS middleware with dynamic origin validation and CDN compatibility:
+
+```typescript
+import { cors } from '@flight-framework/core/middleware';
+
+// Static origins
+chain.use(cors({
+  origin: ['https://app.example.com', 'https://admin.example.com'],
+  methods: ['GET', 'POST', 'PUT', 'DELETE'],
+  credentials: true,
+}));
+
+// Async validation (database lookup)
+chain.use(cors({
+  origin: async (requestOrigin) => {
+    return await db.allowedOrigins.exists(requestOrigin);
+  },
+  exposeHeaders: ['X-Request-Id', 'X-RateLimit-Remaining'],
+}));
+```
+
+Dynamic origins automatically set `Vary: Origin` for CDN/cache compatibility.
+
+#### Built-in Middleware
+
+| Middleware | Purpose |
+|------------|---------|
+| `cors(options?)` | Cross-origin resource sharing |
+| `logger(options?)` | Request logging with configurable levels |
+| `securityHeaders(options?)` | Security headers (CSP, X-Frame-Options, etc.) |
+| `errorHandler(options?)` | Centralized error handling |
+| `compress()` | Mark responses for compression |
+
+#### Logger Configuration
+
+```typescript
+import { logger } from '@flight-framework/core/middleware';
+
+chain.use(logger({
+  level: 'info',           // 'debug' | 'info' | 'warn' | 'error' | 'silent'
+  format: 'json',          // 'pretty' | 'json' | 'combined' | 'common' | 'short'
+  skip: (ctx) => ctx.url.pathname === '/health',
+  writer: (entry, formatted) => externalLogger.log(entry),
+}));
+```
+
+The logger captures errors from downstream middleware before re-throwing, ensuring all requests are logged including failures.
+
+
 ### Error Handling
 
 ```typescript
@@ -342,6 +474,68 @@ import type {
 } from '@flight-framework/core';
 ```
 
+## Build Plugins
+
+### Critical CSS Extraction
+
+Extract and inline critical CSS for improved LCP:
+
+```bash
+npm install critters
+```
+
+```typescript
+// vite.config.ts
+import { criticalCSS } from '@flight-framework/core/plugins';
+
+export default defineConfig({
+    plugins: [
+        criticalCSS({
+            // Strategy for loading non-critical CSS
+            preload: 'swap', // 'body' | 'media' | 'swap' | 'swap-high' | 'js' | 'js-lazy'
+            
+            // Remove inlined CSS from source
+            pruneSource: false,
+            
+            // Routes to process
+            include: ['**/*.html'],
+            exclude: ['/api/**'],
+        }),
+    ],
+});
+```
+
+#### Preload Strategies
+
+| Strategy | Description |
+|----------|-------------|
+| `swap` | Use rel="preload" and swap on load |
+| `swap-high` | Like swap with fetchpriority="high" |
+| `media` | Use media="print" and swap |
+| `js` | Load via JavaScript |
+| `js-lazy` | Load via JavaScript when idle |
+| `body` | Move stylesheets to end of body |
+
+#### CSS Utilities
+
+```typescript
+import {
+    extractInlineStyles,
+    mergeCSS,
+    generatePreloadLink,
+    generateNoscriptFallback,
+} from '@flight-framework/core/plugins/critical-css';
+
+// Extract styles from HTML
+const { html, styles } = extractInlineStyles(htmlString);
+
+// Generate preload link
+const preload = generatePreloadLink('/styles.css', 'swap');
+
+// Generate noscript fallback
+const fallback = generateNoscriptFallback('/styles.css');
+```
+
 ## License
 
 MIT

package/dist/{chunk-54HPVE7N.js → chunk-3KRBRSRJ.js}

@@ -39,6 +39,11 @@ async function scanRoutes(options) {
             routes.push(...interceptRoutes);
             continue;
           }
+          const groupMatch = entry.name.match(/^\(([^.]+)\)$/);
+          if (groupMatch) {
+            await scanDir(fullPath, basePath);
+            continue;
+          }
           await scanDir(fullPath, `${basePath}/${entry.name}`);
         } else if (entry.isFile()) {
           const ext = extname(entry.name);
@@ -268,7 +273,156 @@ async function createFileRouter(options) {
     refresh
   };
 }
+function resolveParallelSlots(routes, currentPath) {
+  const slots = {};
+  const normalizedPath = normalizePath(currentPath);
+  const slotNames = /* @__PURE__ */ new Set();
+  for (const route of routes) {
+    if (route.slot) {
+      slotNames.add(route.slot);
+    }
+  }
+  for (const slotName of slotNames) {
+    const slotRoutes = routes.filter((r) => r.slot === slotName);
+    let matchingRoute = slotRoutes.find((r) => {
+      const routePath = normalizePath(r.path);
+      return pathMatches(routePath, normalizedPath);
+    });
+    if (!matchingRoute) {
+      matchingRoute = slotRoutes.find(
+        (r) => r.path.endsWith("/default") || r.filePath.includes("default.page")
+      );
+    }
+    if (matchingRoute && matchingRoute.component) {
+      slots[slotName] = {
+        component: matchingRoute.component,
+        route: matchingRoute
+      };
+    } else {
+      slots[slotName] = null;
+    }
+  }
+  return slots;
+}
+function getSlotDefault(routes, slotName, basePath = "") {
+  const normalizedBase = normalizePath(basePath);
+  return routes.find(
+    (r) => r.slot === slotName && (r.filePath.includes("default.page") || r.path === `${normalizedBase}/default`)
+  ) || null;
+}
+function getSlotNames(routes) {
+  const names = /* @__PURE__ */ new Set();
+  for (const route of routes) {
+    if (route.slot) {
+      names.add(route.slot);
+    }
+  }
+  return Array.from(names);
+}
+function findInterceptingRoute(routes, fromPath, toPath) {
+  const normalizedFrom = normalizePath(fromPath);
+  const normalizedTo = normalizePath(toPath);
+  const interceptingRoutes = routes.filter((r) => r.interceptInfo);
+  for (const route of interceptingRoutes) {
+    const { interceptInfo } = route;
+    if (!interceptInfo) continue;
+    const interceptPath = normalizePath(interceptInfo.interceptPath);
+    if (!pathMatches(interceptPath, normalizedTo)) {
+      continue;
+    }
+    let validOrigin = false;
+    const routePathStr = normalizePath(route.path);
+    const interceptMarkerMatch = routePathStr.match(/\/\(\.+\)/);
+    if (interceptInfo.level >= 3) {
+      validOrigin = true;
+    } else if (interceptMarkerMatch && interceptMarkerMatch.index !== void 0) {
+      const routeBase = routePathStr.substring(0, interceptMarkerMatch.index);
+      if (interceptInfo.level === 1) {
+        validOrigin = normalizedFrom === routeBase || normalizedFrom.startsWith(routeBase + "/") || routeBase === "" && normalizedFrom.startsWith("/");
+      } else if (interceptInfo.level === 2) {
+        validOrigin = normalizedFrom === routeBase || normalizedFrom.startsWith(routeBase + "/");
+      }
+    }
+    if (validOrigin) {
+      return route;
+    }
+  }
+  return null;
+}
+function shouldDismissIntercept(currentRoute, toPath) {
+  if (!currentRoute || !currentRoute.interceptInfo) {
+    return false;
+  }
+  const normalizedTo = normalizePath(toPath);
+  const interceptPath = normalizePath(currentRoute.interceptInfo.interceptPath);
+  return !pathMatches(interceptPath, normalizedTo);
+}
+function extractRouteParams(routePath, actualPath) {
+  const routeParts = routePath.split("/").filter(Boolean);
+  const actualParts = actualPath.split("/").filter(Boolean);
+  if (routeParts.length !== actualParts.length) {
+    const hasCatchAll = routeParts.some((p) => p.endsWith("+") || p.endsWith("*"));
+    if (!hasCatchAll) {
+      return null;
+    }
+  }
+  const params = {};
+  for (let i = 0; i < routeParts.length; i++) {
+    const routePart = routeParts[i];
+    const actualPart = actualParts[i];
+    if (!routePart) continue;
+    if (routePart.startsWith(":")) {
+      const paramName = routePart.slice(1).replace(/[+*]$/, "");
+      if (routePart.endsWith("+") || routePart.endsWith("*")) {
+        params[paramName] = actualParts.slice(i).join("/");
+        break;
+      }
+      if (!actualPart) {
+        if (routePart.endsWith("*")) {
+          params[paramName] = "";
+          break;
+        }
+        return null;
+      }
+      params[paramName] = actualPart;
+    } else if (routePart !== actualPart) {
+      return null;
+    }
+  }
+  return params;
+}
+function normalizePath(path) {
+  let normalized = path.trim();
+  if (!normalized.startsWith("/")) {
+    normalized = "/" + normalized;
+  }
+  if (normalized !== "/" && normalized.endsWith("/")) {
+    normalized = normalized.slice(0, -1);
+  }
+  normalized = normalized.replace(/\/+/g, "/");
+  return normalized;
+}
+function pathMatches(routePath, actualPath) {
+  const routeParts = routePath.split("/").filter(Boolean);
+  const actualParts = actualPath.split("/").filter(Boolean);
+  for (let i = 0; i < routeParts.length; i++) {
+    const routePart = routeParts[i];
+    const actualPart = actualParts[i];
+    if (!routePart) continue;
+    if (routePart.startsWith(":") && (routePart.endsWith("+") || routePart.endsWith("*"))) {
+      return true;
+    }
+    if (routePart.startsWith(":")) {
+      if (!actualPart) return false;
+      continue;
+    }
+    if (routePart !== actualPart) {
+      return false;
+    }
+  }
+  return routeParts.length === actualParts.length;
+}
 
-export { createFileRouter, loadRoutes, scanRoutes };
-//# sourceMappingURL=chunk-54HPVE7N.js.map
-//# sourceMappingURL=chunk-54HPVE7N.js.map
+export { createFileRouter, extractRouteParams, findInterceptingRoute, getSlotDefault, getSlotNames, loadRoutes, resolveParallelSlots, scanRoutes, shouldDismissIntercept };
+//# sourceMappingURL=chunk-3KRBRSRJ.js.map
+//# sourceMappingURL=chunk-3KRBRSRJ.js.map

package/dist/chunk-3KRBRSRJ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/file-router/index.ts"],"names":[],"mappings":"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","file":"chunk-3KRBRSRJ.js","sourcesContent":["/**\r\n * @flight-framework/core - File Router\r\n * \r\n * Auto-discovery of routes from file system.\r\n * Similar to Next.js App Router and Nuxt server/api patterns.\r\n */\r\n\r\nimport { readdir } from 'node:fs/promises';\r\nimport { join, basename, extname } from 'node:path';\r\nimport { pathToFileURL } from 'node:url';\r\n\r\n// ============================================================================\r\n// Types\r\n// ============================================================================\r\n\r\nexport type HttpMethod = 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH' | 'HEAD' | 'OPTIONS';\r\n\r\nexport type Handler = (context: unknown) => Response | Promise<Response>;\r\nexport type Middleware = (context: unknown, next: () => Promise<Response>) => Response | Promise<Response>;\r\n\r\nexport interface FileRoute {\r\n    /** HTTP method (GET, POST, etc) or 'ALL' */\r\n    method: HttpMethod | 'ALL';\r\n    /** Route path with params (e.g., /users/:id) */\r\n    path: string;\r\n    /** Original file path */\r\n    filePath: string;\r\n    /** Handler function (for APIs) */\r\n    handler?: Handler;\r\n    /** Route-specific middleware */\r\n    middleware?: Middleware[];\r\n    /** Route type: 'page' for SSR pages, 'api' for API endpoints */\r\n    type: 'page' | 'api';\r\n    /** Component function (for pages) */\r\n    component?: () => unknown;\r\n    /** Page metadata (title, description, etc) */\r\n    meta?: Record<string, unknown>;\r\n    /** Parallel route slot name (for @folder convention) */\r\n    slot?: string;\r\n    /** Intercepting route info (for (.) (..) (...) convention) */\r\n    interceptInfo?: {\r\n        /** Number of levels to intercept: 1 = same, 2 = parent, 3+ = root */\r\n        level: number;\r\n        /** Target route segment to intercept */\r\n        target: string;\r\n        /** Original path that triggers interception */\r\n        interceptPath: string;\r\n    };\r\n}\r\n\r\nexport interface FileRouterOptions {\r\n    /** Root directory to scan (default: src/routes) */\r\n    directory: string;\r\n    /** File extensions to consider (default: ['.ts', '.js']) */\r\n    extensions?: string[];\r\n    /** Whether to watch for changes (default: false in prod) */\r\n    watch?: boolean;\r\n    /** \r\n     * Custom module loader for development with Vite.\r\n     * Pass vite.ssrLoadModule to load TSX files correctly.\r\n     * Falls back to native import() if not provided.\r\n     */\r\n    moduleLoader?: (filePath: string) => Promise<any>;\r\n}\r\n\r\nexport interface ScanResult {\r\n    routes: FileRoute[];\r\n    errors: string[];\r\n}\r\n\r\n// ============================================================================\r\n// File Scanner\r\n// ============================================================================\r\n\r\n/**\r\n * Scan a directory for route files\r\n */\r\nexport async function scanRoutes(options: FileRouterOptions): Promise<ScanResult> {\r\n    const {\r\n        directory,\r\n        extensions = ['.ts', '.js'],\r\n    } = options;\r\n\r\n    const routes: FileRoute[] = [];\r\n    const errors: string[] = [];\r\n\r\n    async function scanDir(dir: string, basePath: string = ''): Promise<void> {\r\n        try {\r\n            const entries = await readdir(dir, { withFileTypes: true });\r\n\r\n            for (const entry of entries) {\r\n                const fullPath = join(dir, entry.name);\r\n\r\n                if (entry.isDirectory()) {\r\n                    // Skip hidden directories and node_modules\r\n                    if (entry.name.startsWith('.') || entry.name === 'node_modules') {\r\n                        continue;\r\n                    }\r\n\r\n                    // Detect parallel route slots (@folder convention)\r\n                    if (entry.name.startsWith('@')) {\r\n                        const slotName = entry.name.slice(1);\r\n                        // Scan slot directory and mark routes with slot name\r\n                        const slotRoutes = await scanSlotDir(fullPath, basePath, slotName, extensions);\r\n                        routes.push(...slotRoutes);\r\n                        continue;\r\n                    }\r\n\r\n                    // Detect intercepting routes ((.) (..) (...) convention)\r\n                    const interceptMatch = entry.name.match(/^\\((\\.+)\\)(.+)$/);\r\n                    if (interceptMatch) {\r\n                        const level = interceptMatch[1].length;\r\n                        const targetSegment = interceptMatch[2];\r\n                        // Scan intercept directory and mark routes with interceptInfo\r\n                        const interceptRoutes = await scanInterceptDir(\r\n                            fullPath,\r\n                            basePath,\r\n                            level,\r\n                            targetSegment,\r\n                            extensions\r\n                        );\r\n                        routes.push(...interceptRoutes);\r\n                        continue;\r\n                    }\r\n\r\n                    // Detect route groups ((groupName) without dots - organizational only)\r\n                    // Route groups allow organizing routes without affecting URL structure\r\n                    // Example: (marketing)/about.page.tsx -> /about (not /marketing/about)\r\n                    const groupMatch = entry.name.match(/^\\(([^.]+)\\)$/);\r\n                    if (groupMatch) {\r\n                        // This is a route group - scan contents but don't add group to path\r\n                        await scanDir(fullPath, basePath);\r\n                        continue;\r\n                    }\r\n\r\n                    // Recurse into subdirectory\r\n                    await scanDir(fullPath, `${basePath}/${entry.name}`);\r\n                } else if (entry.isFile()) {\r\n                    const ext = extname(entry.name);\r\n\r\n                    if (!extensions.includes(ext)) {\r\n                        continue;\r\n                    }\r\n\r\n                    // Parse route from filename\r\n                    const routeInfo = parseRouteFile(entry.name, basePath);\r\n\r\n                    if (routeInfo && routeInfo.method && routeInfo.path) {\r\n                        routes.push({\r\n                            method: routeInfo.method,\r\n                            path: routeInfo.path,\r\n                            filePath: fullPath,\r\n                            type: routeInfo.type,\r\n                        });\r\n                    }\r\n                }\r\n            }\r\n        } catch (error) {\r\n            errors.push(`Failed to scan ${dir}: ${error}`);\r\n        }\r\n    }\r\n\r\n    await scanDir(directory);\r\n\r\n    return { routes, errors };\r\n}\r\n\r\n/**\r\n * Scan a parallel route slot directory\r\n */\r\nasync function scanSlotDir(\r\n    dir: string,\r\n    basePath: string,\r\n    slotName: string,\r\n    extensions: string[] = ['.ts', '.js', '.tsx', '.jsx']\r\n): Promise<FileRoute[]> {\r\n    const routes: FileRoute[] = [];\r\n\r\n    try {\r\n        const entries = await readdir(dir, { withFileTypes: true });\r\n\r\n        for (const entry of entries) {\r\n            const fullPath = join(dir, entry.name);\r\n\r\n            if (entry.isFile()) {\r\n                const ext = extname(entry.name);\r\n\r\n                if (!extensions.includes(ext)) {\r\n                    continue;\r\n                }\r\n\r\n                const routeInfo = parseRouteFile(entry.name, basePath);\r\n\r\n                if (routeInfo && routeInfo.method && routeInfo.path) {\r\n                    routes.push({\r\n                        method: routeInfo.method,\r\n                        path: routeInfo.path,\r\n                        filePath: fullPath,\r\n                        type: routeInfo.type,\r\n                        slot: slotName,\r\n                    });\r\n                }\r\n            }\r\n        }\r\n    } catch (error) {\r\n        console.error(`[Flight] Failed to scan slot @${slotName}:`, error);\r\n    }\r\n\r\n    return routes;\r\n}\r\n\r\n/**\r\n * Scan an intercepting route directory\r\n * Uses (.) (..) (...) convention similar to Next.js\r\n * - (.)segment - intercepts from same level\r\n * - (..)segment - intercepts from parent level\r\n * - (...)segment - intercepts from root\r\n */\r\nasync function scanInterceptDir(\r\n    dir: string,\r\n    basePath: string,\r\n    level: number,\r\n    targetSegment: string,\r\n    extensions: string[] = ['.ts', '.js', '.tsx', '.jsx']\r\n): Promise<FileRoute[]> {\r\n    const routes: FileRoute[] = [];\r\n\r\n    // Calculate the intercept path based on level\r\n    const pathParts = basePath.split('/').filter(Boolean);\r\n    let interceptPath: string;\r\n\r\n    if (level === 1) {\r\n        // (.) - Same level, intercepts sibling route\r\n        interceptPath = `${basePath}/${targetSegment}`;\r\n    } else if (level === 2) {\r\n        // (..) - Parent level\r\n        pathParts.pop();\r\n        interceptPath = `/${pathParts.join('/')}/${targetSegment}`;\r\n    } else {\r\n        // (...) - Root level (3 or more dots)\r\n        interceptPath = `/${targetSegment}`;\r\n    }\r\n\r\n    try {\r\n        const entries = await readdir(dir, { withFileTypes: true });\r\n\r\n        for (const entry of entries) {\r\n            const fullPath = join(dir, entry.name);\r\n\r\n            if (entry.isFile()) {\r\n                const ext = extname(entry.name);\r\n\r\n                if (!extensions.includes(ext)) {\r\n                    continue;\r\n                }\r\n\r\n                const routeInfo = parseRouteFile(entry.name, basePath);\r\n\r\n                if (routeInfo && routeInfo.method && routeInfo.path) {\r\n                    routes.push({\r\n                        method: routeInfo.method,\r\n                        path: routeInfo.path,\r\n                        filePath: fullPath,\r\n                        type: routeInfo.type,\r\n                        interceptInfo: {\r\n                            level,\r\n                            target: targetSegment,\r\n                            interceptPath: interceptPath.replace(/\\/+/g, '/') || '/',\r\n                        },\r\n                    });\r\n                }\r\n            } else if (entry.isDirectory()) {\r\n                // Recurse into subdirectories within intercept folder\r\n                const subRoutes = await scanInterceptDir(\r\n                    fullPath,\r\n                    `${basePath}/${entry.name}`,\r\n                    level,\r\n                    targetSegment,\r\n                    extensions\r\n                );\r\n                routes.push(...subRoutes);\r\n            }\r\n        }\r\n    } catch (error) {\r\n        console.error(`[Flight] Failed to scan intercept (${'.'.repeat(level)})${targetSegment}:`, error);\r\n    }\r\n\r\n    return routes;\r\n}\r\n\r\n// ============================================================================\r\n// Route Parser\r\n// ============================================================================\r\n\r\ninterface ParsedRoute {\r\n    method: HttpMethod | 'ALL';\r\n    path: string;\r\n    type: 'page' | 'api';\r\n}\r\n\r\n/**\r\n * Parse route information from filename and path\r\n * \r\n * Patterns:\r\n * - index.ts → /\r\n * - users.ts → /users\r\n * - users.get.ts → GET /users (API)\r\n * - users.post.ts → POST /users (API)\r\n * - about.page.tsx → GET /about (Page)\r\n * - blog/[slug].page.tsx → GET /blog/:slug (Page)\r\n * - [id].ts → /:id\r\n * - [...slug].ts → /* (catch-all)\r\n * - [[...slug]].ts → /* (optional catch-all)\r\n */\r\nfunction parseRouteFile(filename: string, basePath: string): ParsedRoute | null {\r\n    const ext = extname(filename);\r\n    const nameWithoutExt = basename(filename, ext);\r\n\r\n    // Skip files starting with underscore (private)\r\n    if (nameWithoutExt.startsWith('_')) {\r\n        return null;\r\n    }\r\n\r\n    // Detect route type\r\n    let type: 'page' | 'api' = 'api';\r\n    let routeName = nameWithoutExt;\r\n    let method: HttpMethod | 'ALL' = 'ALL';\r\n\r\n    // Check for page suffix (e.g., about.page.tsx, index.page.tsx)\r\n    const pageMatch = nameWithoutExt.match(/^(.+)?\\.page$/i);\r\n    if (pageMatch) {\r\n        type = 'page';\r\n        method = 'GET'; // Pages are always GET\r\n        routeName = pageMatch[1] || 'index';\r\n    } else {\r\n        // Check for method suffix (e.g., users.get.ts)\r\n        const methodMatch = nameWithoutExt.match(/^(.+)\\.(get|post|put|delete|patch|head|options)$/i);\r\n        if (methodMatch) {\r\n            routeName = methodMatch[1] || nameWithoutExt;\r\n            method = (methodMatch[2] || 'ALL').toUpperCase() as HttpMethod;\r\n        }\r\n    }\r\n\r\n    // Also check if file is in /api/ directory\r\n    if (basePath.startsWith('/api') || basePath.includes('/api/')) {\r\n        type = 'api';\r\n    }\r\n\r\n    // Build route path\r\n    let path = basePath;\r\n\r\n    if (routeName !== 'index') {\r\n        path = `${basePath}/${convertToRoutePath(routeName)}`;\r\n    }\r\n\r\n    // Ensure path starts with /\r\n    if (!path.startsWith('/')) {\r\n        path = '/' + path;\r\n    }\r\n\r\n    // Remove trailing slash (except for root)\r\n    if (path !== '/' && path.endsWith('/')) {\r\n        path = path.slice(0, -1);\r\n    }\r\n\r\n    return { method, path, type };\r\n}\r\n\r\n/**\r\n * Convert filename segment to route path segment\r\n * \r\n * - [id] → :id\r\n * - [...slug] → *\r\n * - [[...slug]] → *?\r\n */\r\nfunction convertToRoutePath(name: string): string {\r\n    // Optional catch-all: [[...slug]]\r\n    if (name.startsWith('[[...') && name.endsWith(']]')) {\r\n        const paramName = name.slice(5, -2);\r\n        return `:${paramName}*`;\r\n    }\r\n\r\n    // Catch-all: [...slug]\r\n    if (name.startsWith('[...') && name.endsWith(']')) {\r\n        const paramName = name.slice(4, -1);\r\n        return `:${paramName}+`;\r\n    }\r\n\r\n    // Dynamic param: [id]\r\n    if (name.startsWith('[') && name.endsWith(']')) {\r\n        const paramName = name.slice(1, -1);\r\n        return `:${paramName}`;\r\n    }\r\n\r\n    return name;\r\n}\r\n\r\n// ============================================================================\r\n// Route Loader\r\n// ============================================================================\r\n\r\n/**\r\n * Load routes with their handlers or components\r\n * @param scanResult - Result from scanRoutes\r\n * @param moduleLoader - Optional custom loader (use vite.ssrLoadModule for dev)\r\n */\r\nexport async function loadRoutes(\r\n    scanResult: ScanResult,\r\n    moduleLoader?: (filePath: string) => Promise<any>\r\n): Promise<FileRoute[]> {\r\n    const loadedRoutes: FileRoute[] = [];\r\n\r\n    for (const route of scanResult.routes) {\r\n        try {\r\n            // Use custom loader if provided (Vite ssrLoadModule for TSX)\r\n            // Otherwise fall back to native import() for production\r\n            let module: any;\r\n            if (moduleLoader) {\r\n                module = await moduleLoader(route.filePath);\r\n            } else {\r\n                // Convert to file:// URL for Windows ESM compatibility\r\n                const fileUrl = pathToFileURL(route.filePath).href;\r\n                module = await import(fileUrl);\r\n            }\r\n\r\n            // Handle PAGE routes\r\n            if (route.type === 'page') {\r\n                // Pages export default component\r\n                const component = module.default;\r\n                const meta = module.meta || module.metadata || {};\r\n\r\n                if (component) {\r\n                    loadedRoutes.push({\r\n                        ...route,\r\n                        component,\r\n                        meta,\r\n                    });\r\n                }\r\n                continue;\r\n            }\r\n\r\n            // Handle API routes\r\n            if (route.method === 'ALL') {\r\n                // Look for named exports: GET, POST, PUT, DELETE, etc\r\n                const methods: HttpMethod[] = ['GET', 'POST', 'PUT', 'DELETE', 'PATCH', 'HEAD', 'OPTIONS'];\r\n\r\n                for (const method of methods) {\r\n                    if (typeof module[method] === 'function') {\r\n                        loadedRoutes.push({\r\n                            ...route,\r\n                            method,\r\n                            handler: module[method],\r\n                        });\r\n                    }\r\n                }\r\n\r\n                // Also check for default export as handler\r\n                if (typeof module.default === 'function') {\r\n                    loadedRoutes.push({\r\n                        ...route,\r\n                        method: 'ALL',\r\n                        handler: module.default,\r\n                    });\r\n                }\r\n            } else {\r\n                // Specific method from filename suffix\r\n                const handler = module[route.method] || module.default;\r\n\r\n                if (typeof handler === 'function') {\r\n                    loadedRoutes.push({\r\n                        ...route,\r\n                        handler,\r\n                    });\r\n                }\r\n            }\r\n        } catch (error) {\r\n            console.error(`[Flight] Failed to load route ${route.filePath}:`, error);\r\n        }\r\n    }\r\n\r\n    return loadedRoutes;\r\n}\r\n\r\n// ============================================================================\r\n// File Router Factory\r\n// ============================================================================\r\n\r\nexport interface FileRouter {\r\n    routes: FileRoute[];\r\n    refresh: () => Promise<void>;\r\n}\r\n\r\n/**\r\n * Create a file-based router\r\n * \r\n * @example\r\n * ```typescript\r\n * import { createFileRouter } from '@flight-framework/core/file-router';\r\n * import { createServer } from '@flight-framework/http';\r\n * \r\n * const router = await createFileRouter({ directory: './src/routes' });\r\n * const app = createServer();\r\n * \r\n * // Register all discovered routes\r\n * for (const route of router.routes) {\r\n *     app[route.method.toLowerCase()](route.path, route.handler);\r\n * }\r\n * ```\r\n */\r\nexport async function createFileRouter(options: FileRouterOptions): Promise<FileRouter> {\r\n    let routes: FileRoute[] = [];\r\n    const { moduleLoader } = options;\r\n\r\n    async function refresh(): Promise<void> {\r\n        const scanResult = await scanRoutes(options);\r\n\r\n        if (scanResult.errors.length > 0) {\r\n            console.warn('[Flight] Route scan errors:', scanResult.errors);\r\n        }\r\n\r\n        routes = await loadRoutes(scanResult, moduleLoader);\r\n\r\n        console.log(`[Flight] Loaded ${routes.length} routes from ${options.directory}`);\r\n    }\r\n\r\n    // Initial load\r\n    await refresh();\r\n\r\n    return {\r\n        get routes() {\r\n            return routes;\r\n        },\r\n        refresh,\r\n    };\r\n}\r\n\r\n// ============================================================================\r\n// Parallel Routes Resolution\r\n// ============================================================================\r\n\r\n/**\r\n * Resolved parallel route slots for a layout.\r\n * Each slot name maps to its resolved component or null if not matched.\r\n */\r\nexport interface ResolvedSlots {\r\n    [slotName: string]: {\r\n        /** The component to render */\r\n        component: () => unknown;\r\n        /** The full route information */\r\n        route: FileRoute;\r\n    } | null;\r\n}\r\n\r\n/**\r\n * Resolve parallel route slots for a given path.\r\n * \r\n * Parallel routes use the @folder convention to define named slots\r\n * that can render alongside the main content in a layout.\r\n * \r\n * @param routes - All loaded routes from the file router\r\n * @param currentPath - The current URL path to resolve slots for\r\n * @returns Object mapping slot names to their resolved components\r\n * \r\n * @example\r\n * ```typescript\r\n * // Given routes from @modal/ and @sidebar/ directories\r\n * const slots = resolveParallelSlots(router.routes, '/dashboard');\r\n * \r\n * // In layout:\r\n * if (slots.modal) {\r\n *     renderModal(slots.modal.component);\r\n * }\r\n * ```\r\n */\r\nexport function resolveParallelSlots(\r\n    routes: FileRoute[],\r\n    currentPath: string\r\n): ResolvedSlots {\r\n    const slots: ResolvedSlots = {};\r\n    const normalizedPath = normalizePath(currentPath);\r\n\r\n    // Get all unique slot names from routes\r\n    const slotNames = new Set<string>();\r\n    for (const route of routes) {\r\n        if (route.slot) {\r\n            slotNames.add(route.slot);\r\n        }\r\n    }\r\n\r\n    // For each slot, find matching route or default\r\n    for (const slotName of slotNames) {\r\n        const slotRoutes = routes.filter(r => r.slot === slotName);\r\n\r\n        // Find exact match for current path\r\n        let matchingRoute = slotRoutes.find(r => {\r\n            const routePath = normalizePath(r.path);\r\n            return pathMatches(routePath, normalizedPath);\r\n        });\r\n\r\n        // If no match, look for default.page in the slot\r\n        if (!matchingRoute) {\r\n            matchingRoute = slotRoutes.find(r =>\r\n                r.path.endsWith('/default') || r.filePath.includes('default.page')\r\n            );\r\n        }\r\n\r\n        if (matchingRoute && matchingRoute.component) {\r\n            slots[slotName] = {\r\n                component: matchingRoute.component,\r\n                route: matchingRoute,\r\n            };\r\n        } else {\r\n            // Slot has no matching content for this path\r\n            slots[slotName] = null;\r\n        }\r\n    }\r\n\r\n    return slots;\r\n}\r\n\r\n/**\r\n * Get the default page for an unmatched slot.\r\n * \r\n * When a parallel route slot doesn't have a matching route for the current path,\r\n * it should render its default.page if one exists, or null.\r\n * \r\n * @param routes - All loaded routes\r\n * @param slotName - Name of the slot (without @)\r\n * @param basePath - Base path to search from\r\n * @returns The default route for the slot, or null\r\n */\r\nexport function getSlotDefault(\r\n    routes: FileRoute[],\r\n    slotName: string,\r\n    basePath: string = ''\r\n): FileRoute | null {\r\n    const normalizedBase = normalizePath(basePath);\r\n\r\n    return routes.find(r =>\r\n        r.slot === slotName &&\r\n        (r.filePath.includes('default.page') || r.path === `${normalizedBase}/default`)\r\n    ) || null;\r\n}\r\n\r\n/**\r\n * Get all slot names used in the routes.\r\n * \r\n * @param routes - All loaded routes\r\n * @returns Array of unique slot names\r\n */\r\nexport function getSlotNames(routes: FileRoute[]): string[] {\r\n    const names = new Set<string>();\r\n    for (const route of routes) {\r\n        if (route.slot) {\r\n            names.add(route.slot);\r\n        }\r\n    }\r\n    return Array.from(names);\r\n}\r\n\r\n// ============================================================================\r\n// Intercepting Routes Resolution\r\n// ============================================================================\r\n\r\n/**\r\n * Check if a navigation should be intercepted by an intercepting route.\r\n * \r\n * Intercepting routes use the (.) (..) (...) convention:\r\n * - (.)segment - intercepts from same level\r\n * - (..)segment - intercepts from parent level  \r\n * - (...)segment - intercepts from root\r\n * \r\n * @param routes - All loaded routes\r\n * @param fromPath - Current path where navigation originates\r\n * @param toPath - Target path the user wants to navigate to\r\n * @returns The intercepting route if found, null otherwise\r\n * \r\n * @example\r\n * ```typescript\r\n * // User is on /feed and clicks link to /photo/123\r\n * const intercepted = findInterceptingRoute(routes, '/feed', '/photo/123');\r\n * \r\n * if (intercepted) {\r\n *     // Render intercepted.component as modal instead of navigating\r\n *     showModal(intercepted);\r\n * }\r\n * ```\r\n */\r\nexport function findInterceptingRoute(\r\n    routes: FileRoute[],\r\n    fromPath: string,\r\n    toPath: string\r\n): FileRoute | null {\r\n    const normalizedFrom = normalizePath(fromPath);\r\n    const normalizedTo = normalizePath(toPath);\r\n\r\n    // Filter to only intercepting routes\r\n    const interceptingRoutes = routes.filter(r => r.interceptInfo);\r\n\r\n    for (const route of interceptingRoutes) {\r\n        const { interceptInfo } = route;\r\n        if (!interceptInfo) continue;\r\n\r\n        // Check if the interceptPath matches the target path\r\n        const interceptPath = normalizePath(interceptInfo.interceptPath);\r\n\r\n        if (!pathMatches(interceptPath, normalizedTo)) {\r\n            continue;\r\n        }\r\n\r\n        // Check if we're navigating from a valid origin based on level\r\n        // For level 1 (.), the intercept route is at same level as navigation origin\r\n        // For level 2 (..), the intercept route is one level up from navigation origin\r\n        // For level 3+ (...), intercepts from anywhere\r\n\r\n        let validOrigin = false;\r\n\r\n        // Find the intercept marker position in route path\r\n        // Route path example: /feed/(.)photo/:id -> base is /feed\r\n        const routePathStr = normalizePath(route.path);\r\n        const interceptMarkerMatch = routePathStr.match(/\\/\\(\\.+\\)/);\r\n\r\n        if (interceptInfo.level >= 3) {\r\n            // (...) - Root level: intercepts from anywhere\r\n            validOrigin = true;\r\n        } else if (interceptMarkerMatch && interceptMarkerMatch.index !== undefined) {\r\n            // Extract the base path before the intercept marker\r\n            const routeBase = routePathStr.substring(0, interceptMarkerMatch.index);\r\n\r\n            if (interceptInfo.level === 1) {\r\n                // (.) - Same level: origin should be at or under the route base\r\n                // Route at /feed/(.)photo, origin should be /feed or /feed/*\r\n                validOrigin = normalizedFrom === routeBase ||\r\n                    normalizedFrom.startsWith(routeBase + '/') ||\r\n                    (routeBase === '' && normalizedFrom.startsWith('/'));\r\n            } else if (interceptInfo.level === 2) {\r\n                // (..) - Parent level: origin is one level deeper\r\n                // Route at /gallery/albums/(..)photo, origin should be /gallery/albums/*\r\n                validOrigin = normalizedFrom === routeBase ||\r\n                    normalizedFrom.startsWith(routeBase + '/');\r\n            }\r\n        }\r\n\r\n        if (validOrigin) {\r\n            return route;\r\n        }\r\n    }\r\n\r\n    return null;\r\n}\r\n\r\n/**\r\n * Check if an intercepting route should be dismissed on this navigation.\r\n * \r\n * @param currentRoute - The currently active intercepting route\r\n * @param toPath - The path being navigated to\r\n * @returns true if the interception should be dismissed\r\n */\r\nexport function shouldDismissIntercept(\r\n    currentRoute: FileRoute | null,\r\n    toPath: string\r\n): boolean {\r\n    if (!currentRoute || !currentRoute.interceptInfo) {\r\n        return false;\r\n    }\r\n\r\n    const normalizedTo = normalizePath(toPath);\r\n    const interceptPath = normalizePath(currentRoute.interceptInfo.interceptPath);\r\n\r\n    // Dismiss if navigating away from the intercepted path\r\n    return !pathMatches(interceptPath, normalizedTo);\r\n}\r\n\r\n/**\r\n * Get route params from a path match.\r\n * \r\n * @param routePath - The route pattern with params (e.g., /photo/:id)\r\n * @param actualPath - The actual URL path (e.g., /photo/123)\r\n * @returns Object with matched params, or null if no match\r\n */\r\nexport function extractRouteParams(\r\n    routePath: string,\r\n    actualPath: string\r\n): Record<string, string> | null {\r\n    const routeParts = routePath.split('/').filter(Boolean);\r\n    const actualParts = actualPath.split('/').filter(Boolean);\r\n\r\n    if (routeParts.length !== actualParts.length) {\r\n        // Check for catch-all\r\n        const hasCatchAll = routeParts.some(p => p.endsWith('+') || p.endsWith('*'));\r\n        if (!hasCatchAll) {\r\n            return null;\r\n        }\r\n    }\r\n\r\n    const params: Record<string, string> = {};\r\n\r\n    for (let i = 0; i < routeParts.length; i++) {\r\n        const routePart = routeParts[i];\r\n        const actualPart = actualParts[i];\r\n\r\n        if (!routePart) continue;\r\n\r\n        if (routePart.startsWith(':')) {\r\n            // Dynamic param\r\n            const paramName = routePart.slice(1).replace(/[+*]$/, '');\r\n\r\n            if (routePart.endsWith('+') || routePart.endsWith('*')) {\r\n                // Catch-all: collect remaining parts\r\n                params[paramName] = actualParts.slice(i).join('/');\r\n                break;\r\n            }\r\n\r\n            if (!actualPart) {\r\n                if (routePart.endsWith('*')) {\r\n                    // Optional catch-all, can be empty\r\n                    params[paramName] = '';\r\n                    break;\r\n                }\r\n                return null;\r\n            }\r\n\r\n            params[paramName] = actualPart;\r\n        } else if (routePart !== actualPart) {\r\n            return null;\r\n        }\r\n    }\r\n\r\n    return params;\r\n}\r\n\r\n// ============================================================================\r\n// Path Utilities\r\n// ============================================================================\r\n\r\n/**\r\n * Normalize a path for consistent comparison.\r\n */\r\nfunction normalizePath(path: string): string {\r\n    let normalized = path.trim();\r\n\r\n    // Ensure starts with /\r\n    if (!normalized.startsWith('/')) {\r\n        normalized = '/' + normalized;\r\n    }\r\n\r\n    // Remove trailing slash (except for root)\r\n    if (normalized !== '/' && normalized.endsWith('/')) {\r\n        normalized = normalized.slice(0, -1);\r\n    }\r\n\r\n    // Remove duplicate slashes\r\n    normalized = normalized.replace(/\\/+/g, '/');\r\n\r\n    return normalized;\r\n}\r\n\r\n/**\r\n * Check if a route path matches an actual path.\r\n * Handles dynamic segments (:param) and catch-alls.\r\n */\r\nfunction pathMatches(routePath: string, actualPath: string): boolean {\r\n    const routeParts = routePath.split('/').filter(Boolean);\r\n    const actualParts = actualPath.split('/').filter(Boolean);\r\n\r\n    for (let i = 0; i < routeParts.length; i++) {\r\n        const routePart = routeParts[i];\r\n        const actualPart = actualParts[i];\r\n\r\n        if (!routePart) continue;\r\n\r\n        // Catch-all segment\r\n        if (routePart.startsWith(':') && (routePart.endsWith('+') || routePart.endsWith('*'))) {\r\n            return true; // Matches rest of path\r\n        }\r\n\r\n        // Dynamic segment\r\n        if (routePart.startsWith(':')) {\r\n            if (!actualPart) return false;\r\n            continue; // Any value matches\r\n        }\r\n\r\n        // Static segment - must match exactly\r\n        if (routePart !== actualPart) {\r\n            return false;\r\n        }\r\n    }\r\n\r\n    // Check lengths match (unless catch-all was present)\r\n    return routeParts.length === actualParts.length;\r\n}\r\n\r\n"]}