@ereo/router 0.1.6

package/dist/matcher.d.ts

@@ -0,0 +1,67 @@
+/**
+ * @ereo/router - URL Pattern Matching
+ *
+ * Matches URLs against route patterns and extracts parameters.
+ * Supports dynamic segments, catch-all, and optional segments.
+ */
+import type { Route, RouteMatch } from '@ereo/core';
+import type { RouteSegment, MatchResult } from './types';
+/**
+ * Parse a path pattern into segments.
+ */
+export declare function parsePathSegments(path: string): RouteSegment[];
+/**
+ * Calculate route score for sorting.
+ * Higher scores are matched first.
+ */
+export declare function calculateRouteScore(segments: RouteSegment[]): number;
+/**
+ * Convert route pattern to regex.
+ */
+export declare function patternToRegex(segments: RouteSegment[]): RegExp;
+/**
+ * Match a URL path against a single route.
+ */
+export declare function matchRoute(pathname: string, route: Route, segments: RouteSegment[]): RouteMatch | null;
+/**
+ * Route matcher class.
+ * Pre-compiles routes for efficient matching.
+ */
+export declare class RouteMatcher {
+    private routes;
+    constructor(routes: Route[]);
+    /**
+     * Compile and sort routes.
+     */
+    private compileRoutes;
+    /**
+     * Flatten nested routes.
+     */
+    private flattenRoutes;
+    /**
+     * Match a URL pathname against compiled routes.
+     */
+    match(pathname: string): RouteMatch | null;
+    /**
+     * Get all routes.
+     */
+    getRoutes(): Route[];
+    /**
+     * Add a route dynamically.
+     */
+    addRoute(route: Route): void;
+    /**
+     * Remove a route by ID.
+     */
+    removeRoute(routeId: string): boolean;
+}
+/**
+ * Create a route matcher from routes.
+ */
+export declare function createMatcher(routes: Route[]): RouteMatcher;
+/**
+ * Match with layout resolution.
+ * Returns all matching layouts from root to the matched route.
+ */
+export declare function matchWithLayouts(pathname: string, routes: Route[]): MatchResult | null;
+//# sourceMappingURL=matcher.d.ts.map

package/dist/matcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"matcher.d.ts","sourceRoot":"","sources":["../src/matcher.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAe,UAAU,EAAE,MAAM,YAAY,CAAC;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAQzD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,EAAE,CA8C9D;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,YAAY,EAAE,GAAG,MAAM,CAyBpE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,YAAY,EAAE,GAAG,MAAM,CA4B/D;AASD;;GAEG;AACH,wBAAgB,UAAU,CACxB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,YAAY,EAAE,GACvB,UAAU,GAAG,IAAI,CA8BnB;AAED;;;GAGG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAKN;gBAEI,MAAM,EAAE,KAAK,EAAE;IAI3B;;OAEG;IACH,OAAO,CAAC,aAAa;IAgBrB;;OAEG;IACH,OAAO,CAAC,aAAa;IAiBrB;;OAEG;IACH,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAkC1C;;OAEG;IACH,SAAS,IAAI,KAAK,EAAE;IAIpB;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAkB5B;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;CAQtC;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,YAAY,CAE3D;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,KAAK,EAAE,GACd,WAAW,GAAG,IAAI,CAyCpB"}

package/dist/middleware-chain.d.ts

@@ -0,0 +1,249 @@
+/**
+ * @ereo/router - Middleware Chain Executor
+ *
+ * Executes route-level middleware chains with support for named middleware,
+ * inline middleware functions, and type-safe context passing.
+ *
+ * ## Type Compatibility
+ *
+ * This module provides `TypedMiddlewareHandler<TProvides, TRequires>` which extends
+ * the base `MiddlewareHandler` from `@ereo/core`. The typed version adds generic
+ * parameters for compile-time context type checking while remaining fully compatible
+ * with the core middleware system.
+ *
+ * ```typescript
+ * // Base type from @ereo/core:
+ * type MiddlewareHandler = (
+ *   request: Request,
+ *   context: AppContext,
+ *   next: NextFunction
+ * ) => Response | Promise<Response>
+ *
+ * // Typed version (compatible with base):
+ * type TypedMiddlewareHandler<TProvides, TRequires> = (
+ *   request: Request,
+ *   context: AppContext & TRequires,  // Extends AppContext
+ *   next: NextFunction
+ * ) => Response | Promise<Response>
+ * ```
+ *
+ * Both types can be used interchangeably with `@ereo/server`'s middleware chain.
+ */
+import type { MiddlewareReference, MiddlewareHandler, AppContext, NextFunction, RouteConfig } from '@ereo/core';
+/**
+ * Typed middleware context values.
+ * Middleware can declare what values it adds to the context.
+ */
+export interface TypedMiddlewareContext {
+    [key: string]: unknown;
+}
+/**
+ * Typed middleware handler that declares its context additions.
+ *
+ * This type is fully compatible with `MiddlewareHandler` from `@ereo/core`.
+ * The generic parameters allow TypeScript to track what context values
+ * are provided and required by each middleware.
+ *
+ * @template TProvides - Context keys/types this middleware adds
+ * @template TRequires - Context keys/types this middleware expects to exist
+ *
+ * @example
+ * // A TypedMiddlewareHandler can be used anywhere a MiddlewareHandler is expected:
+ * const typed: TypedMiddlewareHandler<{ user: User }> = async (req, ctx, next) => {
+ *   ctx.set('user', await getUser(req));
+ *   return next();
+ * };
+ *
+ * // This works because TypedMiddlewareHandler extends MiddlewareHandler:
+ * const handler: MiddlewareHandler = typed; // OK!
+ */
+export type TypedMiddlewareHandler<TProvides extends TypedMiddlewareContext = {}, TRequires extends TypedMiddlewareContext = {}> = (request: Request, context: AppContext & TRequires, next: NextFunction) => Response | Promise<Response>;
+/**
+ * Typed middleware definition with metadata.
+ */
+export interface TypedMiddleware<TProvides extends TypedMiddlewareContext = {}, TRequires extends TypedMiddlewareContext = {}> {
+    name: string;
+    handler: TypedMiddlewareHandler<TProvides, TRequires>;
+    /** Keys this middleware provides to the context */
+    provides?: (keyof TProvides)[];
+    /** Keys this middleware requires from the context */
+    requires?: (keyof TRequires)[];
+}
+/**
+ * Create a typed middleware with context type safety.
+ *
+ * @example
+ * const authMiddleware = createMiddleware<{ user: User }>({
+ *   name: 'auth',
+ *   provides: ['user'],
+ *   handler: async (req, ctx, next) => {
+ *     const session = await getSession(req);
+ *     if (!session) {
+ *       return new Response('Unauthorized', { status: 401 });
+ *     }
+ *     ctx.set('user', session.user); // TypeScript knows 'user' is valid
+ *     return next();
+ *   },
+ * });
+ *
+ * // In your loader:
+ * export const loader = async ({ context }) => {
+ *   const user = context.get<User>('user'); // Set by auth middleware
+ * };
+ */
+export declare function createMiddleware<TProvides extends TypedMiddlewareContext = {}, TRequires extends TypedMiddlewareContext = {}>(config: TypedMiddleware<TProvides, TRequires>): TypedMiddleware<TProvides, TRequires> & {
+    register: () => void;
+};
+/**
+ * Chain multiple typed middleware together with type inference.
+ *
+ * @example
+ * const protectedRoute = chainMiddleware(
+ *   authMiddleware,    // provides: { user: User }
+ *   adminMiddleware,   // requires: { user: User }, provides: { isAdmin: boolean }
+ *   rateLimitMiddleware
+ * );
+ */
+export declare function chainMiddleware<M1 extends TypedMiddleware<any, any>, M2 extends TypedMiddleware<any, any>>(m1: M1, m2: M2): TypedMiddleware<M1 extends TypedMiddleware<infer P1, any> ? (M2 extends TypedMiddleware<infer P2, any> ? P1 & P2 : P1) : {}, M1 extends TypedMiddleware<any, infer R1> ? R1 : {}>;
+export declare function chainMiddleware<M1 extends TypedMiddleware<any, any>, M2 extends TypedMiddleware<any, any>, M3 extends TypedMiddleware<any, any>>(m1: M1, m2: M2, m3: M3): TypedMiddleware<any, any>;
+/**
+ * Register a named middleware in the global registry.
+ *
+ * @example
+ * registerMiddleware('auth', async (req, ctx, next) => {
+ *   if (!ctx.get('user')) {
+ *     return new Response('Unauthorized', { status: 401 });
+ *   }
+ *   return next();
+ * });
+ */
+export declare function registerMiddleware(name: string, handler: MiddlewareHandler): void;
+/**
+ * Register a typed middleware with metadata.
+ */
+export declare function registerTypedMiddleware<TProvides extends TypedMiddlewareContext, TRequires extends TypedMiddlewareContext>(middleware: TypedMiddleware<TProvides, TRequires>): void;
+/**
+ * Get typed middleware metadata.
+ */
+export declare function getTypedMiddleware(name: string): TypedMiddleware<any, any> | undefined;
+/**
+ * Validate middleware chain for type safety.
+ * Ensures that all required context values are provided by preceding middleware.
+ */
+export declare function validateMiddlewareChain(names: string[]): {
+    valid: boolean;
+    errors: string[];
+};
+/**
+ * Get a named middleware from the registry.
+ */
+export declare function getMiddleware(name: string): MiddlewareHandler | undefined;
+/**
+ * Check if a named middleware exists in the registry.
+ */
+export declare function hasMiddleware(name: string): boolean;
+/**
+ * Remove a named middleware from the registry.
+ */
+export declare function unregisterMiddleware(name: string): boolean;
+/**
+ * Clear all named middleware from the registry.
+ */
+export declare function clearMiddlewareRegistry(): void;
+/**
+ * Resolve a middleware reference to a handler function.
+ * String references are looked up in the named middleware registry.
+ */
+export declare function resolveMiddleware(reference: MiddlewareReference): MiddlewareHandler | undefined;
+/**
+ * Options for executing a middleware chain.
+ */
+export interface MiddlewareChainOptions {
+    /** Request object */
+    request: Request;
+    /** Application context */
+    context: AppContext;
+    /** Final handler to call when chain completes */
+    finalHandler: NextFunction;
+    /** Error handler for middleware errors */
+    onError?: (error: Error) => Response | Promise<Response>;
+}
+/**
+ * Execute a middleware chain.
+ *
+ * @param middleware Array of middleware references
+ * @param options Chain execution options
+ * @returns Response from the chain
+ *
+ * @example
+ * const response = await executeMiddlewareChain(
+ *   ['csrf', 'auth', customMiddleware],
+ *   {
+ *     request,
+ *     context,
+ *     finalHandler: async () => renderRoute(),
+ *   }
+ * );
+ */
+export declare function executeMiddlewareChain(middleware: MiddlewareReference[], options: MiddlewareChainOptions): Promise<Response>;
+/**
+ * Create a middleware chain executor bound to a route config.
+ *
+ * @param config Route configuration containing middleware array
+ * @returns Function to execute the middleware chain
+ *
+ * @example
+ * const executor = createMiddlewareExecutor(routeConfig);
+ * const response = await executor({ request, context, finalHandler });
+ */
+export declare function createMiddlewareExecutor(config: RouteConfig): (options: Omit<MiddlewareChainOptions, "finalHandler"> & {
+    finalHandler: NextFunction;
+}) => Promise<Response>;
+/**
+ * Compose multiple middleware handlers into a single handler.
+ */
+export declare function composeMiddleware(...handlers: MiddlewareHandler[]): MiddlewareHandler;
+/**
+ * Create a conditional middleware that only runs when the predicate matches.
+ */
+export declare function when(predicate: (request: Request, context: AppContext) => boolean | Promise<boolean>, middleware: MiddlewareHandler): MiddlewareHandler;
+/**
+ * Create a middleware that only runs for specific HTTP methods.
+ */
+export declare function method(methods: string | string[], middleware: MiddlewareHandler): MiddlewareHandler;
+/**
+ * Convert a glob pattern to a RegExp.
+ * Supports * (match anything except /) and ** (match anything including /).
+ */
+export declare function globToRegex(glob: string): RegExp;
+/**
+ * Create a middleware that only runs for specific path patterns.
+ */
+export declare function path(patterns: string | string[] | RegExp | RegExp[], middleware: MiddlewareHandler): MiddlewareHandler;
+/**
+ * Create a logging middleware.
+ */
+export declare function createLoggerMiddleware(options?: {
+    includeBody?: boolean;
+    includeHeaders?: string[];
+}): MiddlewareHandler;
+/**
+ * Create a CORS middleware.
+ */
+export declare function createCorsMiddleware(options?: {
+    origin?: string | string[] | ((origin: string) => boolean);
+    methods?: string[];
+    headers?: string[];
+    credentials?: boolean;
+    maxAge?: number;
+}): MiddlewareHandler;
+/**
+ * Create a rate limiting middleware.
+ */
+export declare function createRateLimitMiddleware(options?: {
+    windowMs?: number;
+    maxRequests?: number;
+    keyGenerator?: (request: Request) => string;
+    skipSuccessfulRequests?: boolean;
+}): MiddlewareHandler;
+//# sourceMappingURL=middleware-chain.d.ts.map

package/dist/middleware-chain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware-chain.d.ts","sourceRoot":"","sources":["../src/middleware-chain.ts"],"names":[],"mappings":"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"}

package/dist/route-config.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @ereo/router - Route Configuration Parser
+ *
+ * Parses and validates route-level configuration exports.
+ */
+import type { RouteConfig, RenderConfig, IslandsConfig, RouteCacheConfig, ProgressiveConfig, AuthConfig, DevConfig, RouteVariant, MiddlewareReference } from '@ereo/core';
+/** Parse and validate middleware chain */
+export declare function parseMiddleware(middleware: unknown): MiddlewareReference[] | undefined;
+/** Parse render configuration */
+export declare function parseRenderConfig(config: unknown): RenderConfig;
+/** Parse islands configuration */
+export declare function parseIslandsConfig(config: unknown): IslandsConfig;
+/** Parse cache configuration */
+export declare function parseCacheConfig(config: unknown): RouteCacheConfig | undefined;
+/** Parse progressive enhancement config */
+export declare function parseProgressiveConfig(config: unknown): ProgressiveConfig;
+/** Parse auth configuration */
+export declare function parseAuthConfig(config: unknown): AuthConfig | undefined;
+/** Parse dev configuration */
+export declare function parseDevConfig(config: unknown): DevConfig | undefined;
+/** Parse route variants */
+export declare function parseVariants(config: unknown): RouteVariant[] | undefined;
+/** Parse complete route configuration */
+export declare function parseRouteConfig(config: unknown): RouteConfig;
+/** Merge parent and child route configs */
+export declare function mergeRouteConfigs(parent: RouteConfig | undefined, child: RouteConfig | undefined): RouteConfig;
+//# sourceMappingURL=route-config.d.ts.map

package/dist/route-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-config.d.ts","sourceRoot":"","sources":["../src/route-config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,UAAU,EACV,SAAS,EACT,YAAY,EACZ,mBAAmB,EAIpB,MAAM,YAAY,CAAC;AAoBpB,0CAA0C;AAC1C,wBAAgB,eAAe,CAC7B,UAAU,EAAE,OAAO,GAClB,mBAAmB,EAAE,GAAG,SAAS,CAWnC;AAED,iCAAiC;AACjC,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,OAAO,GAAG,YAAY,CAkB/D;AAyDD,kCAAkC;AAClC,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,OAAO,GAAG,aAAa,CAkBjE;AAED,gCAAgC;AAChC,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,OAAO,GAAG,gBAAgB,GAAG,SAAS,CAS9E;AAyCD,2CAA2C;AAC3C,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,OAAO,GAAG,iBAAiB,CAUzE;AAqCD,+BAA+B;AAC/B,wBAAgB,eAAe,CAAC,MAAM,EAAE,OAAO,GAAG,UAAU,GAAG,SAAS,CAiBvE;AAED,8BAA8B;AAC9B,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,CASrE;AAYD,2BAA2B;AAC3B,wBAAgB,aAAa,CAAC,MAAM,EAAE,OAAO,GAAG,YAAY,EAAE,GAAG,SAAS,CAsBzE;AAED,yCAAyC;AACzC,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,OAAO,GAAG,WAAW,CAiB7D;AAED,2CAA2C;AAC3C,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,WAAW,GAAG,SAAS,EAC/B,KAAK,EAAE,WAAW,GAAG,SAAS,GAC7B,WAAW,CAeb"}

package/dist/route-tree.d.ts

@@ -0,0 +1,86 @@
+/**
+ * @ereo/router - Route Tree
+ *
+ * Builds a hierarchical route tree from flat routes.
+ * Handles layout nesting and route groups.
+ */
+import type { Route } from '@ereo/core';
+import type { RouteNode } from './types';
+/**
+ * Route tree builder.
+ */
+export declare class RouteTree {
+    private root;
+    constructor();
+    /**
+     * Create a route node.
+     */
+    private createNode;
+    /**
+     * Add a route to the tree.
+     */
+    addRoute(id: string, path: string, file: string, options?: {
+        index?: boolean;
+        layout?: boolean;
+    }): RouteNode;
+    /**
+     * Find the parent node for a path.
+     */
+    private findParent;
+    /**
+     * Get the root node.
+     */
+    getRoot(): RouteNode;
+    /**
+     * Convert tree to flat Route array.
+     */
+    toRoutes(): Route[];
+    /**
+     * Convert a node to a Route.
+     */
+    private nodeToRoute;
+    /**
+     * Find a node by path.
+     */
+    findByPath(path: string): RouteNode | null;
+    /**
+     * Find a node by ID.
+     */
+    findById(id: string): RouteNode | null;
+    /**
+     * Remove a route by ID.
+     */
+    removeById(id: string): boolean;
+    /**
+     * Get all routes as a flat array.
+     */
+    flatten(): RouteNode[];
+    /**
+     * Get all layout routes.
+     */
+    getLayouts(): RouteNode[];
+    /**
+     * Get the layout chain for a route.
+     */
+    getLayoutChain(routeId: string): RouteNode[];
+}
+/**
+ * Convert a file path to a URL path.
+ */
+export declare function filePathToUrlPath(filePath: string, routesDir: string): {
+    path: string;
+    index: boolean;
+    layout: boolean;
+};
+/**
+ * Build a route tree from file paths.
+ */
+export declare function buildRouteTree(files: Array<{
+    relativePath: string;
+    absolutePath: string;
+}>, routesDir: string): RouteTree;
+/**
+ * Create an empty route tree.
+ */
+export declare function createRouteTree(): RouteTree;
+//# sourceMappingURL=route-tree.d.ts.map

package/dist/route-tree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-tree.d.ts","sourceRoot":"","sources":["../src/route-tree.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,KAAK,EAAE,SAAS,EAAgB,MAAM,SAAS,CAAC;AAIvD;;GAEG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,IAAI,CAAY;;IAMxB;;OAEG;IACH,OAAO,CAAC,UAAU;IAoBlB;;OAEG;IACH,QAAQ,CACN,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAO,GAClD,SAAS;IAeZ;;OAEG;IACH,OAAO,CAAC,UAAU;IA8BlB;;OAEG;IACH,OAAO,IAAI,SAAS;IAIpB;;OAEG;IACH,QAAQ,IAAI,KAAK,EAAE;IAInB;;OAEG;IACH,OAAO,CAAC,WAAW;IAoBnB;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAc1C;;OAEG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IActC;;OAEG;IACH,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAe/B;;OAEG;IACH,OAAO,IAAI,SAAS,EAAE;IActB;;OAEG;IACH,UAAU,IAAI,SAAS,EAAE;IAIzB;;OAEG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE;CAgB7C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAChB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,CAsCnD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,KAAK,CAAC;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAAC,EAC5D,SAAS,EAAE,MAAM,GAChB,SAAS,CAoBX;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,SAAS,CAE3C"}

package/dist/types.d.ts

@@ -0,0 +1,140 @@
+/**
+ * @ereo/router - Route Type Definitions
+ *
+ * Types for file-based routing system.
+ */
+import type { Route, RouteParams, RouteModule } from '@ereo/core';
+/**
+ * File system route (before processing).
+ */
+export interface FileRoute {
+    /** Relative file path from routes directory */
+    relativePath: string;
+    /** Absolute file path */
+    absolutePath: string;
+    /** File extension */
+    extension: string;
+}
+/**
+ * Parsed route segment.
+ */
+export interface RouteSegment {
+    /** The raw segment value */
+    raw: string;
+    /** Type of segment */
+    type: 'static' | 'dynamic' | 'catchAll' | 'optional';
+    /** Parameter name (for dynamic/catchAll segments) */
+    paramName?: string;
+}
+/**
+ * Route node in the tree.
+ */
+export interface RouteNode {
+    /** Route ID (unique identifier) */
+    id: string;
+    /** URL path pattern */
+    path: string;
+    /** Parsed path segments */
+    segments: RouteSegment[];
+    /** File path */
+    file: string;
+    /** Is this an index route? */
+    index: boolean;
+    /** Is this a layout? */
+    layout: boolean;
+    /** Child routes */
+    children: RouteNode[];
+    /** Parent route (for layout resolution) */
+    parent?: RouteNode;
+    /** Loaded module */
+    module?: RouteModule;
+    /** Score for sorting (more specific routes first) */
+    score: number;
+}
+/**
+ * Router options.
+ */
+export interface RouterOptions {
+    /** Routes directory (default: 'app/routes') */
+    routesDir?: string;
+    /** Base path (default: '') */
+    basePath?: string;
+    /** File extensions to consider routes (default: ['.tsx', '.ts', '.jsx', '.js']) */
+    extensions?: string[];
+    /** Whether to watch for changes (dev mode) */
+    watch?: boolean;
+}
+/**
+ * Match result from URL pattern matching.
+ */
+export interface MatchResult {
+    /** The matched route */
+    route: Route;
+    /** Extracted parameters */
+    params: RouteParams;
+    /** Matched pathname */
+    pathname: string;
+    /** Layouts to render (from root to leaf) */
+    layouts: Route[];
+}
+/**
+ * Route registry for type-safe routing.
+ */
+export interface RouteRegistry {
+    /** All registered routes */
+    routes: Map<string, Route>;
+    /** Get route by path */
+    get(path: string): Route | undefined;
+    /** Check if route exists */
+    has(path: string): boolean;
+}
+/**
+ * File router events.
+ */
+export interface RouterEvents {
+    /** Route added */
+    add: (route: Route) => void;
+    /** Route removed */
+    remove: (routeId: string) => void;
+    /** Route changed */
+    change: (route: Route) => void;
+    /** All routes reloaded */
+    reload: (routes: Route[]) => void;
+}
+/**
+ * Route sorting priority.
+ * Higher values = higher priority (matched first).
+ */
+export declare const ROUTE_SCORE: {
+    readonly STATIC: 100;
+    readonly INDEX: 90;
+    readonly DYNAMIC: 50;
+    readonly OPTIONAL: 30;
+    readonly CATCH_ALL: 10;
+};
+/**
+ * Special file names.
+ */
+export declare const SPECIAL_FILES: {
+    readonly LAYOUT: "_layout";
+    readonly ERROR: "_error";
+    readonly LOADING: "_loading";
+    readonly NOT_FOUND: "_404";
+};
+/**
+ * Route group pattern (parentheses).
+ */
+export declare const ROUTE_GROUP_PATTERN: RegExp;
+/**
+ * Dynamic segment pattern (brackets).
+ */
+export declare const DYNAMIC_SEGMENT_PATTERN: RegExp;
+/**
+ * Catch-all segment pattern (spread).
+ */
+export declare const CATCH_ALL_PATTERN: RegExp;
+/**
+ * Optional segment pattern (double brackets).
+ */
+export declare const OPTIONAL_PATTERN: RegExp;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}