/** Public handler returned by a handler-only dev server. */
export type DevServerHandler = (request: Request, nativeContext?: unknown) => Promise<Response>;
/** Options accepted by dev server. */
export interface DevServerOptions {
    port: number;
    projectDir: string;
    /**
     * When true, skip starting the built-in HTTP server for use with external
     * servers such as Hono. Pass the external server's native request context as
     * the second argument to `DevServer.handler`.
     */
    handlerOnly?: boolean;
    /** 0.0.0.0 = all interfaces, 127.0.0.1 = localhost only */
    bindAddress?: string;
    moduleServerPort?: number;
    enableHMR?: boolean;
    enableFastRefresh?: boolean;
    fileWatcherDebounceMs?: number;
    signal?: AbortSignal;
    /**
     * Optional request interceptor for combined mode.
     * Transforms requests before they're processed by the dev server.
     * Used by proxy middleware to inject context headers.
     */
    requestInterceptor?: (req: Request) => Request | Promise<Request>;
    /** Default project slug when not provided via proxy headers (for tests/local mode) */
    defaultProjectSlug?: string;
    /** Default project ID when not provided via proxy headers (for tests/local mode) */
    defaultProjectId?: string;
}
/** Public API contract for route directory. */
export interface RouteDirectory {
    type: "app" | "pages";
    path: string;
}
/** Public API contract for file watcher metrics. */
export interface FileWatcherMetrics {
    totalFileChangeEvents: number;
    routeDiscoveryCalls: number;
    averageBatchSize: string;
    largestBatch: number;
    fsOperationReduction: string;
}
//# sourceMappingURL=types.d.ts.map