import { RouteObject } from 'react-router-dom';
import { ComponentType, LazyExoticComponent, ReactNode } from 'react';
import { DiscoveredRoute, RouteDefinition, RouteMetadata, RouteAccessConfig, RouteModule, RouteParams } from './types';
/**
 * Build a parameterized path from a pattern and params
 * @see core/path-utils.ts for implementation details
 *
 * @example
 * buildRoutePath('/users/:id', { id: '123' }) // '/users/123'
 * buildRoutePath('/users/:id?', {}) // '/users'
 * buildRoutePath('/users/:id', { id: '123' }, { tab: 'settings' }) // '/users/123?tab=settings'
 */
export declare function buildRoutePath(pattern: string, params?: Record<string, string>, query?: Record<string, string | undefined>): string;
/**
 * Create a type-safe route builder function for a specific path pattern
 *
 * @example
 * const userRoute = createRouteBuilder('/users/:id');
 * userRoute({ id: '123' }) // '/users/123'
 *
 * const homeRoute = createRouteBuilder('/');
 * homeRoute() // '/'
 */
export declare function createRouteBuilder<TPath extends string>(path: TPath): (params?: RouteParams<TPath>, query?: Record<string, string | undefined>) => string;
/**
 * Create a typed route registry from a routes object
 *
 * @example
 * const routes = {
 *   home: '/',
 *   users: '/users',
 *   userDetail: '/users/:id',
 * } as const;
 *
 * const builders = createRouteBuilders(routes);
 * builders.home() // '/'
 * builders.userDetail({ id: '123' }) // '/users/123'
 */
export declare function createRouteBuilders<T extends Record<string, string>>(routes: T): {
    [K in keyof T]: (params?: RouteParams<T[K]>, query?: Record<string, string | undefined>) => string;
};
/**
 * Import function type for dynamic imports
 */
export type RouteImportFn = () => Promise<{
    default: ComponentType<unknown>;
} & Partial<RouteModule>>;
/**
 * Create a lazy component with preload capability
 */
export declare function createLazyRoute(importFn: RouteImportFn): LazyExoticComponent<ComponentType<unknown>> & {
    preload: () => Promise<RouteModule>;
};
/**
 * Build a RouteObject from a discovered route
 */
export declare function buildRouteObject(route: DiscoveredRoute, importFn: RouteImportFn, options?: {
    errorElement?: ReactNode;
    loadingElement?: ReactNode;
}): RouteObject;
/**
 * Build a complete route tree from discovered routes
 */
export declare function buildRouteTree(routes: DiscoveredRoute[], importMap: Map<string, RouteImportFn>, options?: {
    errorElement?: ReactNode;
    loadingElement?: ReactNode;
}): RouteObject[];
/**
 * Create a RouteDefinition from a discovered route
 */
export declare function createRouteDefinition(route: DiscoveredRoute, meta?: RouteMetadata, access?: RouteAccessConfig): RouteDefinition;
/**
 * Create route definitions for all discovered routes
 */
export declare function createRouteDefinitions(routes: DiscoveredRoute[]): RouteDefinition[];
/**
 * Check if a path matches a route pattern
 * @see core/path-utils.ts for implementation details
 */
export declare function matchRoute(pattern: string, path: string): boolean;
/**
 * Extract parameters from a path using a pattern
 * @see core/path-utils.ts for implementation details
 */
export declare function extractRouteParams(pattern: string, path: string): Record<string, string> | null;
/**
 * Generate TypeScript type definitions for routes
 */
export declare function generateRouteTypeDefinitions(routes: DiscoveredRoute[]): string;
/**
 * Generate route registry code
 */
export declare function generateRouteRegistry(routes: DiscoveredRoute[], rootDir: string): string;